@gridsheet/preact-core 2.0.0-rc.0 → 2.0.0-rc.2

package/README.md

@@ -0,0 +1,79 @@
+# @gridsheet/preact-core
+
+Spreadsheet component for Preact
+
+## Installation
+
+```bash
+npm install @gridsheet/preact-core
+```
+
+## Peer Dependencies
+
+This package requires the following peer dependencies:
+
+- `preact` ^10.26.6
+- `dayjs` ^1.11.13
+
+## Usage
+
+### Basic Preact Component
+
+```tsx
+import { GridSheet } from '@gridsheet/preact-core';
+
+// Your Preact component
+function App() {
+  return (
+    <GridSheet />
+  );
+}
+
+render(<App />, document.getElementById('app'));
+```
+
+### Vanilla JavaScript Integration
+
+```javascript
+import { GridSheet, h, render } from '@gridsheet/preact-core';
+
+// Create a container element
+const container = document.getElementById('gridsheet');
+
+// Render GridSheet directly
+render(
+  h(GridSheet, {
+    initialCells: {
+      A1: { value: 'Hello' },
+      B1: { value: 'Vanilla JS', style: { backgroundColor: '#448888'} },
+      A2: { value: 123 },
+      B2: { value: 456 },
+      C10: { value: '=SUM(A2:B2)' },
+    },
+    options: {
+      mode: 'dark',
+    },
+    sheetName: 'Sheet1'
+  }),
+  container
+);
+```
+
+## Exports
+
+This package exports all the core GridSheet functionality along with Preact compatibility layer. It includes:
+
+- All React compatibility exports from `preact/compat`
+- Core GridSheet components and utilities
+- Preact-specific exports (`h`, `render`)
+
+## Development
+
+```bash
+# Build the package
+pnpm build
+```
+
+## License
+
+Apache-2.0

package/dist/components/GridSheet.d.ts

@@ -1,3 +1,3 @@
 import { Props } from '../types';
-export declare function GridSheet({ initialCells, sheetName, tableRef, options, className, style, hubReactive: initialHubReactive, }: Props): JSX.Element;
+export declare function GridSheet({ initialCells, sheetName, tableRef, storeRef, options, className, style, hub: initialHub, }: Props): JSX.Element;
 //# sourceMappingURL=GridSheet.d.ts.map

package/dist/components/StoreObserver.d.ts

@@ -1,8 +1,11 @@
-import { FC } from 'react';
-import { OptionsType } from '../types';
+import { FC, MutableRefObject } from 'react';
+import { OptionsType, StoreRef } from '../types';
 type StoreInitializerProps = OptionsType & {
     sheetName?: string;
+    storeRef?: MutableRefObject<StoreRef | null>;
 };
+export declare const createStoreRef: () => import('react').RefObject<StoreRef | null>;
+export declare const useStoreRef: () => MutableRefObject<StoreRef | null>;
 export declare const StoreObserver: FC<StoreInitializerProps>;
 export {};
 //# sourceMappingURL=StoreObserver.d.ts.map

package/dist/components/Tabular.d.ts

@@ -2,7 +2,8 @@ import { TableRef } from '../types';
 type Props = {
     tableRef: React.MutableRefObject<TableRef | null> | undefined;
 };
-export declare const createTableRef: () => import('react').MutableRefObject<TableRef | null>;
+export declare const createTableRef: () => import('react').RefObject<TableRef | null>;
+export declare const useTableRef: () => import('react').MutableRefObject<TableRef | null>;
 export declare const Tabular: ({ tableRef }: Props) => JSX.Element | null;
 export {};
 //# sourceMappingURL=Tabular.d.ts.map

package/dist/formula/evaluator.d.ts

@@ -1,8 +1,22 @@
 import { Table } from '../lib/table';
-import { PointType } from '../types';
+import { Id, PointType } from '../types';
 type EvaluateProps = {
     table: Table;
 };
+export type IdentifyProps = {
+    table: Table;
+    slideY?: number;
+    slideX?: number;
+    dependency: string;
+    idMap?: {
+        [id: string]: string;
+    };
+};
+export type DisplayProps = {
+    table: Table;
+    slideY?: number;
+    slideX?: number;
+};
 export declare class FormulaError {
     code: string;
     message: string;
@@ -26,24 +40,24 @@ export declare class RefEntity extends Entity<string> {
     constructor(value: string);
     stringify(): string;
     evaluate({ table }: EvaluateProps): Table;
-    id(table: Table, paths: string[], slideY?: number, slideX?: number): string;
+    identify({ table, dependency, slideY, slideX }: IdentifyProps): string;
 }
 export declare class RangeEntity extends Entity<string> {
     stringify(): string;
     evaluate({ table }: EvaluateProps): Table;
-    idRange(table: Table, paths: string[], slideY?: number, slideX?: number): string;
+    identify({ table, dependency, slideY, slideX }: IdentifyProps): string;
 }
 export declare class IdEntity extends Entity<string> {
     private parse;
     evaluate({ table }: EvaluateProps): Table;
-    ref(table: Table, slideY?: number, slideX?: number): string;
-    slide(table: Table, slideY?: number, slideX?: number): string;
+    display({ table, slideY, slideX }: DisplayProps): string;
+    identify({ table, dependency, slideX, slideY }: IdentifyProps): string;
 }
 export declare class IdRangeEntity extends Entity<string> {
     private parse;
     evaluate({ table }: EvaluateProps): Table;
-    range(table: Table, slideY?: number, slideX?: number): string;
-    slide(table: Table, slideY?: number, slideX?: number): string | undefined;
+    display({ table, slideY, slideX }: DisplayProps): string;
+    identify({ table, dependency, slideY, slideX }: IdentifyProps): string | undefined;
 }
 export declare class FunctionEntity {
     args: Expression[];
@@ -67,6 +81,9 @@ export declare class Token {
 }
 type LexerOption = {
     origin?: PointType;
+    idMap?: {
+        [id: Id]: Id;
+    };
 };
 export declare class Lexer {
     private index;
@@ -74,6 +91,7 @@ export declare class Lexer {
     tokens: Token[];
     foreign: boolean;
     private origin?;
+    private idMap;
     constructor(formula: string, options?: LexerOption);
     private isWhiteSpace;
     private next;
@@ -82,11 +100,12 @@ export declare class Lexer {
     getTokenIndexByCharPosition(pos: number): [number, boolean];
     getTokenPositionRange(index: number, slide?: number): [number, number];
     stringify(): string;
-    stringifyToId(table: Table, slideY?: number, slideX?: number): [string, string[]];
-    stringifyToRef(table: Table): string;
+    identify(props: IdentifyProps): string;
+    display({ table }: DisplayProps): string;
     tokenize(): void;
     private skipSpaces;
     private getString;
+    private resolveIdRange;
 }
 export declare class Parser {
     index: number;
@@ -96,13 +115,7 @@ export declare class Parser {
     build(): Expression | undefined;
     private parse;
 }
-export declare const identifyFormula: ({ value, table, originPath, slideY, slideX, }: {
-    value: any;
-    table: Table;
-    originPath: string;
-    slideY?: number;
-    slideX?: number;
-}) => any;
+export declare const identifyFormula: (value: any, { idMap, ...props }: IdentifyProps) => any;
 export declare const stripSheetName: (sheetName: string) => string;
 export declare function splitRef(ref: string): {
     sheetName: string | undefined;

package/dist/formula/functions/__utils.d.ts

@@ -4,9 +4,12 @@ export declare const lt: (left: any, right: any) => boolean;
 export declare const lte: (left: any, right: any) => boolean;
 export declare const eq: (left: any, right: any) => boolean;
 export declare const ne: (left: any, right: any) => boolean;
-export declare const ensureNumber: (value: any, alternative?: number) => number;
+export type EnsureNumberOptions = {
+    alternative?: number;
+    ignore?: boolean;
+};
+export declare const ensureNumber: (value: any, options?: EnsureNumberOptions) => number;
 export declare const ensureString: (value: any) => string;
 export declare const ensureBoolean: (value: any, alternative?: boolean) => boolean;
-export declare const stripTable: (value: any, y?: number, x?: number) => any;
 export declare const check: (value: any, condition: string) => boolean;
 //# sourceMappingURL=__utils.d.ts.map

package/dist/formula/functions/add.d.ts

@@ -8,6 +8,6 @@ export declare class AddFunction extends BaseFunction {
         description: string;
     }[];
     protected validate(): void;
-    protected main(v1: number | Date | TimeDelta, v2: number | Date | TimeDelta): number | Date | TimeDelta;
+    protected main(v1: number | Date | TimeDelta, v2: number | Date | TimeDelta): number | Date;
 }
 //# sourceMappingURL=add.d.ts.map

package/dist/formula/functions/index.d.ts

@@ -0,0 +1,18 @@
+import { Table } from '../../lib/table';
+import { BaseFunction } from './__base';
+export declare class IndexFunction extends BaseFunction {
+    example: string;
+    helpText: string[];
+    helpArgs: ({
+        name: string;
+        description: string;
+        optional?: undefined;
+    } | {
+        name: string;
+        description: string;
+        optional: boolean;
+    })[];
+    protected validate(): void;
+    protected main(table: Table, y?: number, x?: number): Table;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/formula/functions/match.d.ts

@@ -0,0 +1,18 @@
+import { Table } from '../../lib/table';
+import { BaseFunction } from './__base';
+export declare class MatchFunction extends BaseFunction {
+    example: string;
+    helpText: string[];
+    helpArgs: ({
+        name: string;
+        description: string;
+        optional?: undefined;
+    } | {
+        name: string;
+        description: string;
+        optional: boolean;
+    })[];
+    protected validate(): void;
+    protected main(searchKey: any, range: Table, searchType?: number): number;
+}
+//# sourceMappingURL=match.d.ts.map

package/dist/formula/functions/match.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=match.test.d.ts.map

package/dist/formula/solver.d.ts

@@ -1,16 +1,19 @@
 import { Table } from '../lib/table';
-import { MatrixType, PointType } from '../types';
-type SolveFormulaType = {
+import { MatrixType, PointType, RefEvaluation } from '../types';
+type SolveFormulaProps = {
     value: any;
     table: Table;
     raise?: boolean;
-    evaluates?: boolean | null;
-    origin?: PointType;
+    refEvaluation?: RefEvaluation;
+    origin: PointType;
 };
-export declare const solveFormula: ({ value, table, raise, evaluates, origin }: SolveFormulaType) => any;
-export declare const solveTable: ({ table, raise }: {
+export declare const solveFormula: ({ value, table, raise, refEvaluation, origin }: SolveFormulaProps) => any;
+type SolveTableProps = {
     table: Table;
     raise?: boolean;
-}) => MatrixType;
+    refEvaluation?: RefEvaluation;
+};
+export declare const solveTable: ({ table, raise }: SolveTableProps) => MatrixType;
+export declare const stripTable: (value: any, y?: number, x?: number, raise?: boolean) => any;
 export {};
 //# sourceMappingURL=solver.d.ts.map

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { GridSheet } from './components/GridSheet';
-export { createTableRef } from './components/Tabular';
+export { useTableRef, createTableRef } from './components/Tabular';
+export { useStoreRef, createStoreRef } from './components/StoreObserver';
 export { Renderer } from './renderers/core';
 export type { RendererMixinType, RendererCallProps, RenderProps } from './renderers/core';
 export { Parser } from './parsers/core';
@@ -9,18 +10,22 @@ export { TimeDelta } from './lib/time';
 export { x2c, c2x, y2r, r2y, p2a, a2p } from './lib/converters';
 export { updateTable } from './store/actions';
 export { PluginBase, useInitialPluginContext, usePluginContext } from './components/PluginBase';
-export type { MatrixType, CellType, FeedbackType, OptionsType, WriterType, CellsByAddressType, CellsByIdType, ModeType, HeadersType, HistoryType, StoreType, PointType, AreaType, ZoneType, Props, TableRef, HubPatchType, } from './types';
-export type { HubReactiveType } from './lib/hub';
-export { Hub, useHubReactive, createHubReactive } from './lib/hub';
+export type { MatrixType, CellType, FeedbackType, OptionsType, WriterType, CellsByAddressType, CellsByIdType, ModeType, HeadersType, HistoryType, StoreType, PointType, AreaType, ZoneType, Props, TableRef, } from './types';
+export type { HubType, WireProps, TransmitProps } from './lib/hub';
+export { Wire, useHub, createHub } from './lib/hub';
 export type { Dispatcher } from './store';
 export { ThousandSeparatorRendererMixin } from './renderers/thousand_separator';
 export { CheckboxRendererMixin } from './renderers/checkbox';
 export { BaseFunction } from './formula/functions/__base';
+export { FormulaError } from './formula/evaluator';
 export { Table } from './lib/table';
 export { Policy } from './policy/core';
 export type { PolicyType, PolicyOption, PolicyMixinType } from './policy/core';
 export * as operations from './lib/operation';
 export { DEFAULT_HISTORY_LIMIT } from './constants';
+export { userActions } from './store/actions';
+export { clip } from './lib/clipboard';
+export { makeBorder } from './styles/utils';
 //# sourceMappingURL=index.d.ts.map
 export { h, render } from "preact";
 export {