chore: release v0.1.7 - add exportable prop and AI-native integration

Author: asif7774

.npmignore

@@ -5,11 +5,19 @@
 
 ---
 
-## [0.1.7] — March 12, 2026 🐛
+## [0.1.7] — March 13, 2026 🐛✨
+
+### Added
+- **`exportable` Property**: Added `exportable?: boolean` to `GridColDef`. This allows excluding specific columns (like action buttons, menus, or images) from all export formats (CSV, Excel, JSON, and Print).
+- **AI-Native Integration**: The published npm package now includes raw source code (`lib/`) and full documentation (`docs/`). This allows AI agents (Cursor, Windsurf, Copilot) to "see" the implementation patterns and documentation inside `node_modules`, leading to significantly better code generation for downstream users.
 
 ### Fixed
 - Fixed an issue where the main wrapper `className` would erroneously include extra whitespace (e.g. `ogx    `) when no optional classes were active.
 - Fixed an issue where `onRowOrderChange` drag-and-drop visuals didn't actually update in the `EventsDemo` component examples because it was referencing a static array instead of React State.
+- Corrected a TypeScript regression where `headerClassName` comment structure was accidentally broken during the previous update.
+
+### Changed
+- Refined the npm package publication files: `docs/research` and `docs/assets` (large binary images) are now excluded to keep the package size lean while retaining all high-value documentation for humans and AI.
 
 
 ## [0.1.6] — March 12, 2026 🎨

CHANGELOG.md

@@ -77,9 +77,18 @@ export default function App() {
 - **Clipboard**: `Ctrl+C` / `Cmd+C` copies selected rows as TSV for Excel/Sheets.
 - **Accessibility**: WCAG 2.1 AA — full ARIA roles and keyboard navigation.
 - **Theming**: CSS variable API with 5 built-in themes + custom theme support.
+- **AI-Native Integration**: Shipped with raw `lib/` source and `docs/` inside the npm package, allowing AI agents (Cursor, Copilot, Windsurf) to flawlessly implement features by "seeing" the internal logic.
 
 ---
 
+## 🤖 AI-Powered Implementation
+
+OpenGridX is built for the era of AI-native development. When you install `@opencorestack/opengridx`, we include the full raw source code and markdown documentation in your `node_modules`. 
+
+This means that **Cursor**, **GitHub Copilot**, **Windsurf**, and other AI agents can read the actual implementation patterns and docs to accurately help you build complex features like server-side tree data or pivot tables without guessing.
+
+> **Tip for Cursor/Copilot users:** If your AI is struggling, tell it to "Read the docs and source in `./node_modules/@opencorestack/opengridx/docs`" for instant context.
+
 ## 📐 API Reference
 
 ### Core Props

README.md

@@ -1,10 +1,47 @@
+.app-root {
+    display: flex;
+    flex-direction: column;
+    min-height: 100vh;
+    font-family: "Inter", system-ui, sans-serif;
+}
+
+.app-top-header {
+    height: 60px;
+    background: #fff;
+    border-bottom: 1px solid #e0e0e0;
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 0 24px;
+    position: sticky;
+    top: 0;
+    z-index: 50;
+}
+
+.app-github-link {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    color: #374151;
+    text-decoration: none;
+    font-weight: 500;
+    font-size: 0.9rem;
+    padding: 6px 12px;
+    border-radius: 6px;
+    transition: background 0.2s;
+}
+
+.app-github-link:hover {
+    background: #f3f4f6;
+    color: #111827;
+}
+
 /* App Container */
 .app-container {
     display: flex;
-    min-height: 100vh;
     flex-direction: row;
     width: 100%;
-    font-family: "Inter", system-ui, sans-serif;
+    flex: 1;
 }
 
 /* Navigation Sidebar */
@@ -26,7 +63,6 @@
     display: flex;
     align-items: center;
     gap: 12px;
-    margin: 0 0 16px 8px;
 }
 
 .app-logo {
@@ -94,11 +130,92 @@
 
 /* Main Content Area */
 .app-main-content {
-    overflow: auto;
     background: #fff;
     flex: 1;
-    max-height: 100vh;
-    height: 100vh;
+    overflow-y: auto;
+    height: calc(100vh - 60px);
+}
+
+.app-page-wrapper {
+    display: flex;
+    flex-direction: row;
+    width: 100%;
+    max-width: 100%;
+}
+
+.app-content-column {
+    flex: 1;
+    min-width: 0;
+    padding-right: 24px;
+}
+
+/* Base Headings within app content area for TOC generation */
+.app-content-column h2 { 
+    margin-top: 36px;
+    margin-bottom: 16px; 
+    border-bottom: 1px solid #e2e8f0;
+    padding-bottom: 8px;
+}
+
+.app-content-column h3 {
+    margin-top: 24px;
+    margin-bottom: 12px;
+}
+
+/* Table of Contents Sidebar */
+.app-toc-sidebar {
+    width: 240px;
+    padding: 32px 24px;
+    position: sticky;
+    top: 0;
+    height: calc(100vh - 60px);
+    overflow-y: auto;
+    border-left: 1px solid #e0e0e0;
+    background: #fafafa;
+    flex-shrink: 0;
+}
+
+.toc-title {
+    font-size: 0.75rem;
+    text-transform: uppercase;
+    color: #9ca3af;
+    font-weight: 700;
+    letter-spacing: 0.05em;
+    margin: 0 0 12px 0;
+}
+
+.toc-list {
+    list-style: none;
+    margin: 0;
+    padding: 0;
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+}
+
+.toc-item.toc-level-2 { margin-left: 0; }
+.toc-item.toc-level-3 { margin-left: 12px; }
+
+.toc-link {
+    display: block;
+    color: #64748b;
+    text-decoration: none;
+    font-size: 0.85rem;
+    padding: 4px 8px;
+    border-radius: 4px;
+    transition: all 0.2s;
+    line-height: 1.4;
+}
+
+.toc-link:hover {
+    color: #0f172a;
+    background: #f1f5f9;
+}
+
+.toc-link.active {
+    color: #4f46e5;
+    background: #e0e7ff;
+    font-weight: 500;
 }
 
 /* Demo Loading Skeleton */