photon-grid-core 0.0.2 → 1.0.0

package/README.md

@@ -1,305 +1,305 @@
-# Photon Grid Core
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/YOUR_GITHUB_USERNAME/photon-grid/main/assets/logo.png" alt="Photon Grid" width="180"/>
-</p>
-
-<p align="center">
-    <strong>A high-performance, zero-dependency TypeScript data grid engine.</strong>
-</p>
-
-<p align="center">
-
-![npm](https://img.shields.io/npm/v/photon-grid-core)
-![license](https://img.shields.io/npm/l/photon-grid-core)
-![typescript](https://img.shields.io/badge/TypeScript-5.x-blue)
-![dependencies](https://img.shields.io/badge/dependencies-0-success)
-
-</p>
-
----
-
-## Overview
-
-Photon Grid Core is the rendering and data engine that powers the Photon Grid ecosystem.
-
-It provides an extremely fast, modular, framework-independent grid implementation written entirely in TypeScript with **zero runtime dependencies**.
-
-This package is intended for:
-
-- JavaScript applications
-- TypeScript applications
-- Framework wrappers
-- Custom UI frameworks
-- Internal rendering engines
-
-If you're looking for Angular, React, or Vue integration, use the corresponding Photon Grid wrapper package instead.
-
----
-
-# Features
-
-- Zero runtime dependencies
-- Written entirely in TypeScript
-- High performance rendering engine
-- Virtual Scrolling
-- Virtual Columns
-- Millions of rows support
-- Column Pinning
-- Column Resizing
-- Column Moving
-- Column Auto Size
-- Cell Selection
-- Range Selection
-- Clipboard Support
-- Keyboard Navigation
-- Mouse Navigation
-- Tree Data
-- Row Grouping
-- Sorting
-- Multi Column Sorting
-- Filtering
-- Quick Filtering
-- Custom Cell Renderers
-- Custom Header Renderers
-- Context Menu
-- Custom Context Menu
-- Pagination
-- Status Bar
-- Tool Panels
-- Theme Support
-- Plugin Architecture
-- Event System
-- API Driven
-- High FPS Rendering
-- Memory Efficient
-- Zero Framework Lock-in
-
----
-
-# Installation
-
-```bash
-npm install photon-grid-core
-```
-
-or
-
-```bash
-yarn add photon-grid-core
-```
-
-or
-
-```bash
-pnpm add photon-grid-core
-```
-
----
-
-# Basic Usage
-
-```ts
-import { PhotonGrid } from "photon-grid-core";
-
-const grid = new PhotonGrid({
-    element: document.getElementById("grid"),
-    columns: [],
-    rowData: []
-});
-
-grid.render();
-```
-
----
-
-# Package Structure
-
-```
-photon-grid-core
-│
-├── api
-├── core
-├── chart
-├── clipboard
-├── column
-├── context-menu
-├── datasource
-├── events
-├── export
-├── filter
-├── grouping
-├── header
-├── keyboard
-├── menu
-├── overlay
-├── pagination
-├── renderer
-├── row
-├── selection
-├── sorting
-├── statusbar
-├── theme
-├── tree
-├── utils
-└── index.ts
-```
-
----
-
-# Why Photon Grid?
-
-Photon Grid was designed from the ground up to compete with enterprise-grade grid libraries while remaining lightweight and fully extensible.
-
-Goals include:
-
-- Better developer experience
-- Modern TypeScript architecture
-- Framework independent
-- Fast rendering
-- Modular design
-- Simple API
-- Enterprise capabilities
-
----
-
-# Browser Support
-
-Supports all modern browsers.
-
-- Chrome
-- Edge
-- Firefox
-- Safari
-
----
-
-# TypeScript
-
-Photon Grid Core is written in TypeScript and ships with built-in declaration files.
-
-No additional typings are required.
-
----
-
-# Zero Dependencies
-
-Photon Grid Core intentionally avoids runtime dependencies.
-
-Benefits include:
-
-- Smaller bundle size
-- Faster startup
-- Better tree shaking
-- No dependency conflicts
-- Easier upgrades
-
----
-
-# Performance
-
-Photon Grid is optimized for very large datasets using virtualization.
-
-Typical capabilities include:
-
-- Millions of rows
-- Thousands of columns
-- High FPS scrolling
-- Low memory usage
-
-Actual performance depends on browser, hardware, and enabled features.
-
----
-
-# Framework Wrappers
-
-Photon Grid Core is the engine behind upcoming framework integrations.
-
-Planned packages include:
-
-- photon-grid-angular
-- photon-grid-react
-- photon-grid-vue
-- photon-grid-svelte
-
----
-
-# Roadmap
-
-Upcoming features include:
-
-- Pivot Tables
-- Excel Export
-- CSV Export
-- Server Side Row Model
-- Infinite Row Model
-- Master Detail
-- Charts
-- Sparklines
-- Formula Engine
-- Undo / Redo
-- Aggregations
-- Advanced Filtering
-- AI Assisted Grid Operations
-- Theme Builder
-
----
-
-# Contributing
-
-Contributions are welcome.
-
-Please submit issues, feature requests, or pull requests through GitHub.
-
----
-
-# License
-
-MIT License
-
----
-
-# Author
-
-**Abdul Wahid**
-
----
-
-# Links
-
-GitHub
-
-https://github.com/YOUR_GITHUB_USERNAME/photon-grid
-
-Issues
-
-https://github.com/YOUR_GITHUB_USERNAME/photon-grid/issues
-
-NPM
-
-https://www.npmjs.com/package/photon-grid-core
-
----
-
-## Philosophy
-
-Photon Grid is built around a few simple principles.
-
-- Performance first.
-- Zero unnecessary dependencies.
-- Framework independence.
-- Extensible architecture.
-- Excellent developer experience.
-- Enterprise-grade capabilities.
-
----
-
-## Status
-
-Photon Grid is under active development.
-
-New features, performance improvements, and framework integrations are added regularly.
-
-If you encounter any issues or have feature requests, please open an issue on GitHub.
-
+# Photon Grid Core
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/YOUR_GITHUB_USERNAME/photon-grid/main/assets/logo.png" alt="Photon Grid" width="180"/>
+</p>
+
+<p align="center">
+    <strong>A high-performance, zero-dependency TypeScript data grid engine.</strong>
+</p>
+
+<p align="center">
+
+![npm](https://img.shields.io/npm/v/photon-grid-core)
+![license](https://img.shields.io/npm/l/photon-grid-core)
+![typescript](https://img.shields.io/badge/TypeScript-5.x-blue)
+![dependencies](https://img.shields.io/badge/dependencies-0-success)
+
+</p>
+
+---
+
+## Overview
+
+Photon Grid Core is the rendering and data engine that powers the Photon Grid ecosystem.
+
+It provides an extremely fast, modular, framework-independent grid implementation written entirely in TypeScript with **zero runtime dependencies**.
+
+This package is intended for:
+
+- JavaScript applications
+- TypeScript applications
+- Framework wrappers
+- Custom UI frameworks
+- Internal rendering engines
+
+If you're looking for Angular, React, or Vue integration, use the corresponding Photon Grid wrapper package instead.
+
+---
+
+# Features
+
+- Zero runtime dependencies
+- Written entirely in TypeScript
+- High performance rendering engine
+- Virtual Scrolling
+- Virtual Columns
+- Millions of rows support
+- Column Pinning
+- Column Resizing
+- Column Moving
+- Column Auto Size
+- Cell Selection
+- Range Selection
+- Clipboard Support
+- Keyboard Navigation
+- Mouse Navigation
+- Tree Data
+- Row Grouping
+- Sorting
+- Multi Column Sorting
+- Filtering
+- Quick Filtering
+- Custom Cell Renderers
+- Custom Header Renderers
+- Context Menu
+- Custom Context Menu
+- Pagination
+- Status Bar
+- Tool Panels
+- Theme Support
+- Plugin Architecture
+- Event System
+- API Driven
+- High FPS Rendering
+- Memory Efficient
+- Zero Framework Lock-in
+
+---
+
+# Installation
+
+```bash
+npm install photon-grid-core
+```
+
+or
+
+```bash
+yarn add photon-grid-core
+```
+
+or
+
+```bash
+pnpm add photon-grid-core
+```
+
+---
+
+# Basic Usage
+
+```ts
+import { PhotonGrid } from "photon-grid-core";
+
+const grid = new PhotonGrid({
+    element: document.getElementById("grid"),
+    columns: [],
+    rowData: []
+});
+
+grid.render();
+```
+
+---
+
+# Package Structure
+
+```
+photon-grid-core
+│
+├── api
+├── core
+├── chart
+├── clipboard
+├── column
+├── context-menu
+├── datasource
+├── events
+├── export
+├── filter
+├── grouping
+├── header
+├── keyboard
+├── menu
+├── overlay
+├── pagination
+├── renderer
+├── row
+├── selection
+├── sorting
+├── statusbar
+├── theme
+├── tree
+├── utils
+└── index.ts
+```
+
+---
+
+# Why Photon Grid?
+
+Photon Grid was designed from the ground up to compete with enterprise-grade grid libraries while remaining lightweight and fully extensible.
+
+Goals include:
+
+- Better developer experience
+- Modern TypeScript architecture
+- Framework independent
+- Fast rendering
+- Modular design
+- Simple API
+- Enterprise capabilities
+
+---
+
+# Browser Support
+
+Supports all modern browsers.
+
+- Chrome
+- Edge
+- Firefox
+- Safari
+
+---
+
+# TypeScript
+
+Photon Grid Core is written in TypeScript and ships with built-in declaration files.
+
+No additional typings are required.
+
+---
+
+# Zero Dependencies
+
+Photon Grid Core intentionally avoids runtime dependencies.
+
+Benefits include:
+
+- Smaller bundle size
+- Faster startup
+- Better tree shaking
+- No dependency conflicts
+- Easier upgrades
+
+---
+
+# Performance
+
+Photon Grid is optimized for very large datasets using virtualization.
+
+Typical capabilities include:
+
+- Millions of rows
+- Thousands of columns
+- High FPS scrolling
+- Low memory usage
+
+Actual performance depends on browser, hardware, and enabled features.
+
+---
+
+# Framework Wrappers
+
+Photon Grid Core is the engine behind upcoming framework integrations.
+
+Planned packages include:
+
+- photon-grid-angular
+- photon-grid-react
+- photon-grid-vue
+- photon-grid-svelte
+
+---
+
+# Roadmap
+
+Upcoming features include:
+
+- Pivot Tables
+- Excel Export
+- CSV Export
+- Server Side Row Model
+- Infinite Row Model
+- Master Detail
+- Charts
+- Sparklines
+- Formula Engine
+- Undo / Redo
+- Aggregations
+- Advanced Filtering
+- AI Assisted Grid Operations
+- Theme Builder
+
+---
+
+# Contributing
+
+Contributions are welcome.
+
+Please submit issues, feature requests, or pull requests through GitHub.
+
+---
+
+# License
+
+MIT License
+
+---
+
+# Author
+
+**Abdul Wahid**
+
+---
+
+# Links
+
+GitHub
+
+https://github.com/YOUR_GITHUB_USERNAME/photon-grid
+
+Issues
+
+https://github.com/YOUR_GITHUB_USERNAME/photon-grid/issues
+
+NPM
+
+https://www.npmjs.com/package/photon-grid-core
+
+---
+
+## Philosophy
+
+Photon Grid is built around a few simple principles.
+
+- Performance first.
+- Zero unnecessary dependencies.
+- Framework independence.
+- Extensible architecture.
+- Excellent developer experience.
+- Enterprise-grade capabilities.
+
+---
+
+## Status
+
+Photon Grid is under active development.
+
+New features, performance improvements, and framework integrations are added regularly.
+
+If you encounter any issues or have feature requests, please open an issue on GitHub.
+
 ⭐ If you find Photon Grid useful, consider starring the repository.

package/chart/chart-config/chart-controls.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Small, theme-token-styled form-control primitives used to build the chart
+ * configuration tool panel. Each factory returns a ready-to-mount element and
+ * wires a single `onChange` callback. No control writes inline styles — all
+ * appearance comes from `chart-controls.css.ts`.
+ */
+/** A `<select>` dropdown. */
+export declare function createDropdown(options: ReadonlyArray<{
+    value: string;
+    label: string;
+}>, value: string, onChange: (value: string) => void, label?: string): HTMLElement;
+/** A switch-style boolean toggle. */
+export declare function createToggle(checked: boolean, onChange: (checked: boolean) => void, label: string): HTMLElement;
+/** A color swatch backed by a native color input. */
+export declare function createColorInput(value: string, onChange: (value: string) => void, label: string): HTMLElement;
+/** A numeric input with optional bounds and step. */
+export declare function createNumberInput(value: number, onChange: (value: number) => void, label: string, min?: number, max?: number, step?: number): HTMLElement;
+/** A single-line text input. */
+export declare function createTextInput(value: string, onChange: (value: string) => void, label: string, placeholder?: string): HTMLElement;
+/** A segmented button group (single selection). */
+export declare function createSegmented(options: ReadonlyArray<{
+    value: string;
+    label: string;
+}>, value: string, onChange: (value: string) => void, label?: string): HTMLElement;
+/**
+ * A collapsible section with a header toggle. Returns the outer `section` and
+ * the `body` element callers append content to.
+ */
+export declare function createCollapsibleSection(title: string, expanded?: boolean): {
+    section: HTMLElement;
+    body: HTMLElement;
+};
+/** An item in a {@link createReorderableList}. */
+export interface ReorderListItem {
+    readonly id: string;
+    readonly label: string;
+    readonly color?: string;
+}
+/**
+ * A drag-to-reorder list with per-item remove buttons. Reordering uses a pointer
+ * drag (mousedown/move/up), not HTML5 DnD, to match the chart panel's own drag
+ * handling and avoid ghost-image quirks.
+ *
+ * @param items - Items in current order.
+ * @param onReorder - Called with the new id order after a drag.
+ * @param onRemove - Called with an item id when its remove button is clicked.
+ */
+export declare function createReorderableList(items: readonly ReorderListItem[], onReorder: (orderedIds: string[]) => void, onRemove: (id: string) => void): HTMLElement;
+//# sourceMappingURL=chart-controls.d.ts.map

package/chart/chart-config/chart-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-controls.d.ts","sourceRoot":"","sources":["../../../src/chart/chart-config/chart-controls.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,6BAA6B;AAC7B,wBAAgB,cAAc,CAC5B,OAAO,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACxD,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EACjC,KAAK,CAAC,EAAE,MAAM,GACb,WAAW,CAYb;AAED,qCAAqC;AACrC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CA2B/G;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAO7G;AAED,qDAAqD;AACrD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EACjC,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ,WAAW,CAab;AAED,gCAAgC;AAChC,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EACjC,KAAK,EAAE,MAAM,EACb,WAAW,SAAK,GACf,WAAW,CAQb;AAED,mDAAmD;AACnD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACxD,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EACjC,KAAK,CAAC,EAAE,MAAM,GACb,WAAW,CAmBb;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,QAAQ,UAAQ,GACf;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CA0B7C;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,EACzC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAC7B,WAAW,CA0Cb"}