@datalayer/cells 0.0.1 → 0.0.2

package/lib/core/workbook.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The persisted state of a workbook: sheets, their axes and cells, merges and
+ * frozen panes, and the pools cells reference (strings, styles, formulas).
+ * Only patches write it (core/patches); the model reads it through getters.
+ *
+ * @module core/workbook
+ */
+import { Axis } from './axis.js';
+import { FormulaTable, SheetCells } from './cells.js';
+import { StringPool } from './strings.js';
+import { StyleTable } from './styles.js';
+import { type Zone } from './zone.js';
+/** The size limits of a sheet. Excel's by default. */
+export interface Limits {
+    readonly rows: number;
+    readonly cols: number;
+    readonly rowHeight: number;
+    readonly colWidth: number;
+}
+export declare const DEFAULT_LIMITS: Limits;
+export interface Frozen {
+    readonly rows: number;
+    readonly cols: number;
+}
+export declare class Sheet {
+    readonly id: string;
+    name: string;
+    readonly rows: Axis;
+    readonly cols: Axis;
+    readonly cells: SheetCells;
+    /** Merged zones, disjoint. */
+    merges: Zone[];
+    frozen: Frozen;
+    constructor(id: string, name: string, limits: Limits, cells: SheetCells);
+    /** The merge holding a position, or `undefined`. */
+    mergeAt(row: number, col: number): Zone | undefined;
+    /** Merges overlapping a zone. */
+    mergesIn(zone: Zone): Zone[];
+}
+export declare class Workbook {
+    #private;
+    readonly limits: Limits;
+    readonly strings: StringPool;
+    readonly styles: StyleTable;
+    readonly formulas: FormulaTable;
+    /** In tab order. */
+    readonly sheets: Sheet[];
+    constructor(limits?: Limits);
+    /** A new, detached sheet with a fresh id; `ADD_SHEET` attaches it through a patch. */
+    createSheet(name: string, id?: string): Sheet;
+    /** The sheet of that id; throws a sentence naming the ids there are. */
+    sheet(id: string): Sheet;
+    hasSheet(id: string): boolean;
+    /** The sheet of that name, case-insensitively, as Excel matches names. */
+    sheetByName(name: string): Sheet | undefined;
+    /** A name no sheet has: `Sheet1`, `Sheet2`, … */
+    freshSheetName(): string;
+}
+//# sourceMappingURL=workbook.d.ts.map

package/lib/core/workbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbook.d.ts","sourceRoot":"","sources":["../../src/core/workbook.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,IAAI,EAAgB,MAAM,WAAW,CAAC;AAEpD,sDAAsD;AACtD,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,cAAc,EAAE,MAK5B,CAAC;AAEF,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,KAAK;IAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,8BAA8B;IAC9B,MAAM,EAAE,IAAI,EAAE,CAAM;IACpB,MAAM,EAAE,MAAM,CAAwB;gBAE1B,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU;IAQvE,oDAAoD;IACpD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAMnD,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE;CAG7B;AAED,qBAAa,QAAQ;;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,aAAoB;IACpC,QAAQ,CAAC,MAAM,aAAoB;IACnC,QAAQ,CAAC,QAAQ,eAAsB;IACvC,oBAAoB;IACpB,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,CAAM;gBAGlB,MAAM,GAAE,MAAuB;IAQ3C,sFAAsF;IACtF,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK;IAY7C,wEAAwE;IACxE,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK;IAUxB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI7B,0EAA0E;IAC1E,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAK5C,iDAAiD;IACjD,cAAc,IAAI,MAAM;CAUzB"}

package/lib/core/workbook.js

@@ -0,0 +1,101 @@
+/*
+ * Copyright (c) 2022-2026 Datalayer, Inc.
+ *
+ * MIT License
+ */
+/**
+ * The persisted state of a workbook: sheets, their axes and cells, merges and
+ * frozen panes, and the pools cells reference (strings, styles, formulas).
+ * Only patches write it (core/patches); the model reads it through getters.
+ *
+ * @module core/workbook
+ */
+import { Axis } from './axis.js';
+import { FormulaTable, SheetCells } from './cells.js';
+import { StringPool } from './strings.js';
+import { StyleTable } from './styles.js';
+import { zonesOverlap } from './zone.js';
+export const DEFAULT_LIMITS = {
+    rows: 1_048_576,
+    cols: 16_384,
+    rowHeight: 21,
+    colWidth: 100,
+};
+export class Sheet {
+    id;
+    name;
+    rows;
+    cols;
+    cells;
+    /** Merged zones, disjoint. */
+    merges = [];
+    frozen = { rows: 0, cols: 0 };
+    constructor(id, name, limits, cells) {
+        this.id = id;
+        this.name = name;
+        this.rows = new Axis({ count: limits.rows, defaultSize: limits.rowHeight });
+        this.cols = new Axis({ count: limits.cols, defaultSize: limits.colWidth });
+        this.cells = cells;
+    }
+    /** The merge holding a position, or `undefined`. */
+    mergeAt(row, col) {
+        return this.merges.find((m) => row >= m.top && row <= m.bottom && col >= m.left && col <= m.right);
+    }
+    /** Merges overlapping a zone. */
+    mergesIn(zone) {
+        return this.merges.filter((m) => zonesOverlap(m, zone));
+    }
+}
+export class Workbook {
+    limits;
+    strings = new StringPool();
+    styles = new StyleTable();
+    formulas = new FormulaTable();
+    /** In tab order. */
+    sheets = [];
+    #nextSheet = 1;
+    constructor(limits = DEFAULT_LIMITS) {
+        for (const [key, value] of Object.entries(limits)) {
+            if (!(typeof value === 'number' && value > 0))
+                throw new Error(`limits.${key} must be positive; ${value} was given.`);
+        }
+        this.limits = limits;
+    }
+    /** A new, detached sheet with a fresh id; `ADD_SHEET` attaches it through a patch. */
+    createSheet(name, id) {
+        const sheetId = id ?? this.#freshSheetId();
+        if (this.sheets.some((s) => s.id === sheetId))
+            throw new Error(`A sheet with id '${sheetId}' exists already.`);
+        return new Sheet(sheetId, name, this.limits, new SheetCells({ strings: this.strings, formulas: this.formulas }));
+    }
+    /** The sheet of that id; throws a sentence naming the ids there are. */
+    sheet(id) {
+        const sheet = this.sheets.find((s) => s.id === id);
+        if (sheet === undefined) {
+            throw new Error(`No sheet '${id}'; the workbook has ${this.sheets.map((s) => s.id).join(', ') || 'none'}.`);
+        }
+        return sheet;
+    }
+    hasSheet(id) {
+        return this.sheets.some((s) => s.id === id);
+    }
+    /** The sheet of that name, case-insensitively, as Excel matches names. */
+    sheetByName(name) {
+        const lower = name.toLowerCase();
+        return this.sheets.find((s) => s.name.toLowerCase() === lower);
+    }
+    /** A name no sheet has: `Sheet1`, `Sheet2`, … */
+    freshSheetName() {
+        for (let i = 1;; i += 1)
+            if (this.sheetByName(`Sheet${i}`) === undefined)
+                return `Sheet${i}`;
+    }
+    #freshSheetId() {
+        for (;;) {
+            const id = `s${this.#nextSheet++}`;
+            if (!this.hasSheet(id))
+                return id;
+        }
+    }
+}
+//# sourceMappingURL=workbook.js.map

package/lib/core/workbook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbook.js","sourceRoot":"","sources":["../../src/core/workbook.ts"],"names":[],"mappings":"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"}

package/lib/points/index.d.ts

@@ -0,0 +1,154 @@
+import type { CommandContext, CommandResult } from '../core/commands.js';
+import type { Patch, PatchOp } from '../core/patches.js';
+import type { Style } from '../core/styles.js';
+import type { CellValue } from '../core/values.js';
+import type { Zone } from '../core/zone.js';
+export type { PatchOp } from '../core/patches.js';
+/** A command handler: refuses with reasons, or turns a command into patches. */
+export interface CommandHandler<C extends {
+    type: string;
+} = {
+    type: string;
+} & Record<string, unknown>> {
+    readonly type: C['type'];
+    /** Refusals with reasons; omitted means always allowed. */
+    allow?(context: CommandContext, command: C): CommandResult;
+    /** The patches that perform the command, computed from the current state; applied in order. */
+    apply(context: CommandContext, command: C): Patch[];
+    /** F4 when not editing: the same command at a new selection (§3.2). */
+    repeat?(command: C, selection: {
+        sheet: string;
+        zones: readonly Zone[];
+    }): C | undefined;
+}
+/** An argument of a formula function, as autocomplete and the compiler read it. */
+export interface FunctionArgument {
+    readonly name: string;
+    readonly type: 'scalar' | 'range' | 'lazy';
+    readonly optional?: boolean;
+    readonly repeating?: boolean;
+    readonly description?: string;
+}
+/** A formula function (§3.4). The engine's calling convention lands with the compiler (C4-02). */
+export interface FormulaFunction {
+    /** Upper-case, as typed: `SUM`, `XLOOKUP`. */
+    readonly name: string;
+    readonly args: readonly FunctionArgument[];
+    readonly returns: 'number' | 'string' | 'boolean' | 'any';
+    readonly compute: (...args: unknown[]) => CellValue | Promise<CellValue>;
+    readonly volatile?: boolean;
+    readonly async?: boolean;
+    readonly description: string;
+    readonly examples: readonly string[];
+}
+/** A cell type drawn on canvas: a checkbox, a link, a progress bar. */
+export interface CellType {
+    readonly id: string;
+    render(ctx: CanvasRenderingContext2D, rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }, value: CellValue, style: Style, theme: Readonly<Record<string, unknown>>): void;
+    hitTest?(point: {
+        x: number;
+        y: number;
+    }, rect: {
+        width: number;
+        height: number;
+    }): boolean;
+    onClick?(cell: {
+        sheet: string;
+        row: number;
+        col: number;
+    }, value: CellValue): Patch[] | void;
+    /** A React component editing this type; typed loosely so the core needs no React. */
+    readonly editor?: unknown;
+    accessibleName?(value: CellValue): string;
+}
+/** A render layer, drawn after the core layers of the same kind (§3.3). */
+export interface RenderLayer {
+    readonly id: string;
+    readonly layer: 'background' | 'cells' | 'overlay';
+    draw(ctx: CanvasRenderingContext2D, viewport: {
+        sheet: string;
+        zone: Zone;
+    }, model: unknown): void;
+}
+/** A clipboard handler: one per feature (§3.5). */
+export interface ClipboardHandler {
+    readonly id: string;
+    copy(context: CommandContext, zone: Zone): unknown;
+    paste(context: CommandContext, slice: unknown, target: Zone, options: {
+        special?: string;
+    }): Patch[];
+}
+/** A fill-handle series rule (§3.5). */
+export interface FillRule {
+    readonly id: string;
+    match(values: readonly CellValue[]): unknown | undefined;
+    next(series: unknown, index: number): CellValue;
+}
+/** Reads a file format into the native format (`CellsWorkbook`). */
+export interface Importer {
+    readonly id: string;
+    readonly mime: string;
+    readonly extensions: readonly string[];
+    read(input: ReadableStream<Uint8Array> | Uint8Array | string): Promise<unknown>;
+}
+/** Writes a workbook out. */
+export interface Exporter {
+    readonly id: string;
+    readonly mime: string;
+    readonly extension: string;
+    write(model: unknown): Promise<Blob | Uint8Array | string>;
+}
+/** A read-only, paged virtual source of columns (§3.11). */
+export interface DataSource {
+    readonly id: string;
+    readonly rowCount: number;
+    readonly columns: readonly {
+        readonly name: string;
+        readonly type?: string;
+    }[];
+    fetch(rows: {
+        from: number;
+        to: number;
+    }): Promise<readonly (readonly CellValue[])[]>;
+}
+/** The collaboration provider: exactly one, or none for "collaboration off" (§3.9). */
+export interface CollabProvider {
+    readonly id: string;
+    connect(doc: unknown, room: string): unknown;
+}
+/** A toolbar or menu entry, naming a Reactor command by id. */
+export interface CommandItem {
+    readonly command: string;
+    readonly group?: string;
+}
+export declare const CellsPatchOps: import("@datalayer/reactor").ContributionPoint<PatchOp<any>>;
+export declare const CellsCommands: import("@datalayer/reactor").ContributionPoint<CommandHandler<any>>;
+export declare const CellsFunctions: import("@datalayer/reactor").ContributionPoint<FormulaFunction>;
+export declare const CellsCellTypes: import("@datalayer/reactor").ContributionPoint<CellType>;
+export declare const CellsRenderLayers: import("@datalayer/reactor").ContributionPoint<RenderLayer>;
+export declare const CellsClipboard: import("@datalayer/reactor").ContributionPoint<ClipboardHandler>;
+export declare const CellsFillRules: import("@datalayer/reactor").ContributionPoint<FillRule>;
+export declare const CellsImporters: import("@datalayer/reactor").ContributionPoint<Importer>;
+export declare const CellsExporters: import("@datalayer/reactor").ContributionPoint<Exporter>;
+export declare const CellsDataSources: import("@datalayer/reactor").ContributionPoint<DataSource>;
+export declare const CellsCollabProvider: import("@datalayer/reactor").ContributionPoint<CollabProvider>;
+export declare const CellsToolbarItems: import("@datalayer/reactor").ContributionPoint<CommandItem>;
+export declare const CellsMenuItems: import("@datalayer/reactor").ContributionPoint<CommandItem>;
+/** What an edit gate is asked about: may this command apply? */
+export interface EditGateContext {
+    readonly command: {
+        readonly type: string;
+    };
+    readonly context: CommandContext;
+}
+/** A plugin may veto a command before it applies; the veto is a refusal with the gate's reason. */
+export declare const CellsEditGate: import("@datalayer/reactor").Gate<EditGateContext>;
+/** Every point Cells opens, as `CellsCorePlugin` declares them. */
+export declare const CELLS_POINTS: readonly [import("@datalayer/reactor").ContributionPoint<PatchOp<any>>, import("@datalayer/reactor").ContributionPoint<CommandHandler<any>>, import("@datalayer/reactor").ContributionPoint<FormulaFunction>, import("@datalayer/reactor").ContributionPoint<CellType>, import("@datalayer/reactor").ContributionPoint<RenderLayer>, import("@datalayer/reactor").ContributionPoint<ClipboardHandler>, import("@datalayer/reactor").ContributionPoint<FillRule>, import("@datalayer/reactor").ContributionPoint<Importer>, import("@datalayer/reactor").ContributionPoint<Exporter>, import("@datalayer/reactor").ContributionPoint<DataSource>, import("@datalayer/reactor").ContributionPoint<CollabProvider>, import("@datalayer/reactor").ContributionPoint<CommandItem>, import("@datalayer/reactor").ContributionPoint<CommandItem>, import("@datalayer/reactor").Gate<EditGateContext>];
+export { PointTable, firstContribution, optionalContribution, type CellsPlatform, type PointTableOptions, type Resolved, } from './resolve.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/points/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/points/index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,gFAAgF;AAChF,MAAM,WAAW,cAAc,CAC7B,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEvE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACzB,2DAA2D;IAC3D,KAAK,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,GAAG,aAAa,CAAC;IAC3D,+FAA+F;IAC/F,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC;IACpD,uEAAuE;IACvE,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAA;KAAE,GAAG,CAAC,GAAG,SAAS,CAAC;CAC1F;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,kGAAkG;AAClG,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;IAC1D,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,uEAAuE;AACvE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,MAAM,CACJ,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAC7D,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,IAAI,CAAC;IACR,OAAO,CAAC,CAAC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IAC5F,OAAO,CAAC,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;IAC9F,qFAAqF;IACrF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;CAC3C;AAED,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,CAAC;IACnD,IAAI,CACF,GAAG,EAAE,wBAAwB,EAC7B,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,EACvC,KAAK,EAAE,OAAO,GACb,IAAI,CAAC;CACT;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IACnD,KAAK,CACH,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,IAAI,EACZ,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5B,KAAK,EAAE,CAAC;CACZ;AAED,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,GAAG,SAAS,CAAC;IACzD,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACjD;AAED,oEAAoE;AACpE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjF;AAED,6BAA6B;AAC7B,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,UAAU,GAAG,MAAM,CAAC,CAAC;CAC5D;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/E,KAAK,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;CACvF;AAED,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9C;AAED,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,aAAa,8DAAmE,CAAC;AAC9F,eAAO,MAAM,aAAa,qEAC+C,CAAC;AAC1E,eAAO,MAAM,cAAc,iEAAuE,CAAC;AACnG,eAAO,MAAM,cAAc,0DAAgE,CAAC;AAC5F,eAAO,MAAM,iBAAiB,6DAE7B,CAAC;AACF,eAAO,MAAM,cAAc,kEAE1B,CAAC;AACF,eAAO,MAAM,cAAc,0DAAgE,CAAC;AAC5F,eAAO,MAAM,cAAc,0DAAgE,CAAC;AAC5F,eAAO,MAAM,cAAc,0DAAgE,CAAC;AAC5F,eAAO,MAAM,gBAAgB,4DAAoE,CAAC;AAClG,eAAO,MAAM,mBAAmB,gEAE/B,CAAC;AACF,eAAO,MAAM,iBAAiB,6DAE7B,CAAC;AACF,eAAO,MAAM,cAAc,6DAAmE,CAAC;AAE/F,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAED,mGAAmG;AACnG,eAAO,MAAM,aAAa,oDAA2D,CAAC;AAEtF,mEAAmE;AACnE,eAAO,MAAM,YAAY,g2BAef,CAAC;AAEX,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,GACd,MAAM,cAAc,CAAC"}

package/lib/points/index.js

@@ -0,0 +1,50 @@
+/*
+ * Copyright (c) 2022-2026 Datalayer, Inc.
+ *
+ * MIT License
+ */
+/**
+ * The Reactor contribution points of Cells, and what each takes.
+ *
+ * Every extension of Cells is a contribution to one of these points, from a
+ * Reactor plugin (`definePlugin` from `@datalayer/reactor`); the built-in
+ * features contribute through the same points. The ids are the contract
+ * between plugins: `datalayer.cells.*`.
+ *
+ * @module points
+ */
+import { defineContributionPoint, defineGate } from '@datalayer/reactor';
+export const CellsPatchOps = defineContributionPoint('datalayer.cells.patchOp');
+export const CellsCommands = defineContributionPoint('datalayer.cells.command');
+export const CellsFunctions = defineContributionPoint('datalayer.cells.function');
+export const CellsCellTypes = defineContributionPoint('datalayer.cells.cellType');
+export const CellsRenderLayers = defineContributionPoint('datalayer.cells.renderLayer');
+export const CellsClipboard = defineContributionPoint('datalayer.cells.clipboard');
+export const CellsFillRules = defineContributionPoint('datalayer.cells.fillRule');
+export const CellsImporters = defineContributionPoint('datalayer.cells.importer');
+export const CellsExporters = defineContributionPoint('datalayer.cells.exporter');
+export const CellsDataSources = defineContributionPoint('datalayer.cells.dataSource');
+export const CellsCollabProvider = defineContributionPoint('datalayer.cells.collabProvider');
+export const CellsToolbarItems = defineContributionPoint('datalayer.cells.toolbarItem');
+export const CellsMenuItems = defineContributionPoint('datalayer.cells.menuItem');
+/** A plugin may veto a command before it applies; the veto is a refusal with the gate's reason. */
+export const CellsEditGate = defineGate('datalayer.cells.gate.edit');
+/** Every point Cells opens, as `CellsCorePlugin` declares them. */
+export const CELLS_POINTS = [
+    CellsPatchOps,
+    CellsCommands,
+    CellsFunctions,
+    CellsCellTypes,
+    CellsRenderLayers,
+    CellsClipboard,
+    CellsFillRules,
+    CellsImporters,
+    CellsExporters,
+    CellsDataSources,
+    CellsCollabProvider,
+    CellsToolbarItems,
+    CellsMenuItems,
+    CellsEditGate,
+];
+export { PointTable, firstContribution, optionalContribution, } from './resolve.js';
+//# sourceMappingURL=index.js.map

package/lib/points/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/points/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;GASG;AAEH,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AA+HzE,MAAM,CAAC,MAAM,aAAa,GAAG,uBAAuB,CAAe,yBAAyB,CAAC,CAAC;AAC9F,MAAM,CAAC,MAAM,aAAa,GACxB,uBAAuB,CAAsB,yBAAyB,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAkB,0BAA0B,CAAC,CAAC;AACnG,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAW,0BAA0B,CAAC,CAAC;AAC5F,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CACtD,6BAA6B,CAC9B,CAAC;AACF,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CACnD,2BAA2B,CAC5B,CAAC;AACF,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAW,0BAA0B,CAAC,CAAC;AAC5F,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAW,0BAA0B,CAAC,CAAC;AAC5F,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAW,0BAA0B,CAAC,CAAC;AAC5F,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAa,4BAA4B,CAAC,CAAC;AAClG,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CACxD,gCAAgC,CACjC,CAAC;AACF,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CACtD,6BAA6B,CAC9B,CAAC;AACF,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAc,0BAA0B,CAAC,CAAC;AAQ/F,mGAAmG;AACnG,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAkB,2BAA2B,CAAC,CAAC;AAEtF,mEAAmE;AACnE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,aAAa;IACb,aAAa;IACb,cAAc;IACd,cAAc;IACd,iBAAiB;IACjB,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,mBAAmB;IACnB,iBAAiB;IACjB,cAAc;IACd,aAAa;CACL,CAAC;AAEX,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,oBAAoB,GAIrB,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalayer/cells",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "repository": {
     "type": "git",
     "url": "https://github.com/datalayer/cells.git"
@@ -101,6 +101,7 @@
     "react-dom": "^18.3.1 || ^19.0.0"
   },
   "devDependencies": {
+    "@datalayer/reactor": "^1.3.2",
     "@playwright/test": "^1.56.0",
     "@types/node": "^24",
     "@types/react": "19.2.18",