@xom11/whiteboard 0.24.2 → 0.27.0

package/dist/types-Crbefnfe.d.ts

@@ -1,128 +0,0 @@
-import { ReactNode, ComponentType, RefAttributes } from 'react';
-import { ExcalidrawElement } from '@excalidraw/excalidraw/element/types';
-import { S as State } from './types-DxlMPh-6.js';
-
-/** Minimal client-safe response required by the geometry AI editor. */
-type AiFigureUiResult = {
-    ok: true;
-    state: State;
-} | {
-    ok: false;
-    message: string;
-};
-/**
- * Consumer-provided bridge to a server-side `generateFigure()` call.
- * Implementations must keep API credentials outside the browser bundle.
- */
-type GenerateGeometryFigure = (problem: string, options: {
-    signal: AbortSignal;
-}) => Promise<AiFigureUiResult>;
-/**
- * Kết quả trả về từ `restoreFileFromCustomData`. Chứa đủ thông tin để
- * consumer gọi `api.addFiles(...)`.
- */
-interface RestoredStampFile {
-    fileId: string;
-    dataURL: string;
-    mimeType: 'image/svg+xml' | 'image/png';
-}
-/**
- * Tối thiểu mọi custom data của stamp cần có. Các stamp cụ thể (geometry,
- * latex, ...) extend interface này với fields riêng.
- */
-interface BaseStampCustomData {
-    kind: string;
-    version: number;
-}
-/**
- * Props mà mỗi StampHost nhận từ Whiteboard. Host component tự
- * quản lý state nội bộ (panel ref, undo stack, displayMode...) — main view
- * chỉ điều phối show/hide.
- */
-interface StampHostProps {
-    api: any;
-    /**
-     * Element đang re-edit (double-click) hoặc null nếu đang tạo mới.
-     * Host tự parse customData để load state ban đầu.
-     */
-    editingElement: {
-        id: string;
-        customData: unknown;
-    } | null;
-    /** Đóng stamp panel (gọi sau khi insert hoặc khi user huỷ). */
-    onClose: () => void;
-    /** Dark theme flag. */
-    isDark: boolean;
-    /** Optional client-safe bridge for the geometry-2d AI prompt editor. */
-    generateGeometryFigure?: GenerateGeometryFigure;
-}
-/**
- * Imperative API mà main view truy cập qua ref:
- *   - tryInsert(): khi user click ra ngoài → auto-commit nếu valid.
- *     Trả về true nếu chèn thành công, false nếu chưa có nội dung.
- *   - hasContent(): có nội dung để chèn không.
- */
-interface StampHostHandle {
-    tryInsert(): boolean;
-    hasContent(): boolean;
-}
-/**
- * Component contract của Host. Chấp nhận cả `forwardRef` thông thường lẫn
- * `React.lazy(() => import('./host'))` (LazyExoticComponent forwards ref).
- */
-type StampHostComponent = ComponentType<StampHostProps & RefAttributes<StampHostHandle>>;
-/**
- * Định nghĩa 1 loại stamp. Mỗi stamp khai báo:
- *   - kind: unique string (khớp với customData.kind)
- *   - phím tắt + UI toolbar
- *   - cách nhận biết customData thuộc về stamp này (matchesCustomData)
- *   - cách re-render SVG từ customData (cho restore sau reload)
- *   - Host component: bọc trọn editor + left panel + insert logic
- *
- * Main view dispatch generic: `<stamp.Host ... />` — không cần biết kind.
- */
-interface StampType<TCustomData extends BaseStampCustomData = BaseStampCustomData> {
-    /** Unique kind. VD: 'geometry', 'latex'. Phải khớp với customData.kind. */
-    kind: string;
-    /** Phím tắt mở/đóng stamp (lowercase, 1 ký tự). VD: 'g', 'l'. */
-    shortcutKey: string;
-    /** Chữ hiển thị overlay góc dưới nút toolbar (e.g. "G"). */
-    toolbarLabel: string;
-    /** Tooltip + aria-label của nút toolbar. */
-    toolbarTitle: string;
-    /** Icon SVG (ReactNode) trong nút toolbar. */
-    toolbarIcon: ReactNode;
-    /** Test data-testid cho nút toolbar (optional). */
-    toolbarTestId?: string;
-    /** Type guard: customData có thuộc về stamp này không. */
-    matchesCustomData(data: unknown): data is TCustomData;
-    /**
-     * Re-render SVG từ customData. Dùng khi restore math-stamp file sau reload
-     * page (Excalidraw không persist binary file payload, chỉ giữ fileId trong
-     * element). SVG render với light palette (nét đậm) — Excalidraw tự đảo
-     * màu trong dark mode qua CSS filter.
-     */
-    renderSvgFromCustomData(data: TCustomData): Promise<string>;
-    /**
-     * Regenerate file SVG/PNG cho element thuộc stamp này khi reload từ persisted
-     * snapshot. Trả về `RestoredStampFile` để consumer gọi `api.addFiles`, hoặc
-     * `null` nếu element không cần file (vd stamp chỉ là text overlay).
-     *
-     * Khi method này có mặt, `restoreMissingStampFiles` sẽ ưu tiên gọi method
-     * này thay vì dùng `renderSvgFromCustomData`. Stamp tự chịu trách nhiệm lấy
-     * `fileId` từ element và render file.
-     */
-    restoreFileFromCustomData?: (element: ExcalidrawElement) => Promise<RestoredStampFile | null>;
-    /**
-     * Host component bọc toàn bộ UI editing (panel + left panel + insert
-     * handler). Whiteboard mount Host khi activeStamp khớp kind.
-     */
-    Host: StampHostComponent;
-    /**
-     * Đánh dấu stamp chưa production-ready. Consumer mặc định bỏ qua
-     * (xem `DEFAULT_STAMPS` chỉ gồm stamp không `experimental`).
-     */
-    experimental?: boolean;
-}
-
-export type { AiFigureUiResult as A, BaseStampCustomData as B, GenerateGeometryFigure as G, StampType as S };

package/dist/types-DxlMPh-6.d.mts

@@ -1,49 +0,0 @@
-type SceneObject<A = Record<string, unknown>> = {
-    id: string;
-    kind: string;
-    label: string;
-    visible: boolean;
-    locked: boolean;
-    layer: string;
-    schemaVersion: number;
-    attrs: A;
-};
-type View2D = {
-    readonly bbox: readonly [number, number, number, number];
-    readonly showAxis: boolean;
-    readonly showGrid: boolean;
-};
-type View3D = {
-    readonly bbox3D: readonly [number, number, number, number, number, number];
-    readonly azimuth: number;
-    readonly elevation: number;
-};
-type ViewGraph2D = {
-    readonly xMin: number;
-    readonly xMax: number;
-    readonly yMin: number;
-    readonly yMax: number;
-    readonly showAxis: boolean;
-    readonly showGrid: boolean;
-};
-type StateMeta = {
-    readonly domain: '2d';
-    readonly version: number;
-    readonly view: View2D;
-} | {
-    readonly domain: '3d';
-    readonly version: number;
-    readonly view: View3D;
-} | {
-    readonly domain: 'graph2d';
-    readonly version: number;
-    readonly view: ViewGraph2D;
-};
-type State = {
-    readonly objects: Readonly<Record<string, SceneObject>>;
-    readonly order: readonly string[];
-    readonly counter: number;
-    readonly meta: StateMeta;
-};
-
-export type { State as S };

package/dist/types-DxlMPh-6.d.ts

@@ -1,49 +0,0 @@
-type SceneObject<A = Record<string, unknown>> = {
-    id: string;
-    kind: string;
-    label: string;
-    visible: boolean;
-    locked: boolean;
-    layer: string;
-    schemaVersion: number;
-    attrs: A;
-};
-type View2D = {
-    readonly bbox: readonly [number, number, number, number];
-    readonly showAxis: boolean;
-    readonly showGrid: boolean;
-};
-type View3D = {
-    readonly bbox3D: readonly [number, number, number, number, number, number];
-    readonly azimuth: number;
-    readonly elevation: number;
-};
-type ViewGraph2D = {
-    readonly xMin: number;
-    readonly xMax: number;
-    readonly yMin: number;
-    readonly yMax: number;
-    readonly showAxis: boolean;
-    readonly showGrid: boolean;
-};
-type StateMeta = {
-    readonly domain: '2d';
-    readonly version: number;
-    readonly view: View2D;
-} | {
-    readonly domain: '3d';
-    readonly version: number;
-    readonly view: View3D;
-} | {
-    readonly domain: 'graph2d';
-    readonly version: number;
-    readonly view: ViewGraph2D;
-};
-type State = {
-    readonly objects: Readonly<Record<string, SceneObject>>;
-    readonly order: readonly string[];
-    readonly counter: number;
-    readonly meta: StateMeta;
-};
-
-export type { State as S };

package/dist/types-vtvyKGAA.d.mts

@@ -1,128 +0,0 @@
-import { ReactNode, ComponentType, RefAttributes } from 'react';
-import { ExcalidrawElement } from '@excalidraw/excalidraw/element/types';
-import { S as State } from './types-DxlMPh-6.mjs';
-
-/** Minimal client-safe response required by the geometry AI editor. */
-type AiFigureUiResult = {
-    ok: true;
-    state: State;
-} | {
-    ok: false;
-    message: string;
-};
-/**
- * Consumer-provided bridge to a server-side `generateFigure()` call.
- * Implementations must keep API credentials outside the browser bundle.
- */
-type GenerateGeometryFigure = (problem: string, options: {
-    signal: AbortSignal;
-}) => Promise<AiFigureUiResult>;
-/**
- * Kết quả trả về từ `restoreFileFromCustomData`. Chứa đủ thông tin để
- * consumer gọi `api.addFiles(...)`.
- */
-interface RestoredStampFile {
-    fileId: string;
-    dataURL: string;
-    mimeType: 'image/svg+xml' | 'image/png';
-}
-/**
- * Tối thiểu mọi custom data của stamp cần có. Các stamp cụ thể (geometry,
- * latex, ...) extend interface này với fields riêng.
- */
-interface BaseStampCustomData {
-    kind: string;
-    version: number;
-}
-/**
- * Props mà mỗi StampHost nhận từ Whiteboard. Host component tự
- * quản lý state nội bộ (panel ref, undo stack, displayMode...) — main view
- * chỉ điều phối show/hide.
- */
-interface StampHostProps {
-    api: any;
-    /**
-     * Element đang re-edit (double-click) hoặc null nếu đang tạo mới.
-     * Host tự parse customData để load state ban đầu.
-     */
-    editingElement: {
-        id: string;
-        customData: unknown;
-    } | null;
-    /** Đóng stamp panel (gọi sau khi insert hoặc khi user huỷ). */
-    onClose: () => void;
-    /** Dark theme flag. */
-    isDark: boolean;
-    /** Optional client-safe bridge for the geometry-2d AI prompt editor. */
-    generateGeometryFigure?: GenerateGeometryFigure;
-}
-/**
- * Imperative API mà main view truy cập qua ref:
- *   - tryInsert(): khi user click ra ngoài → auto-commit nếu valid.
- *     Trả về true nếu chèn thành công, false nếu chưa có nội dung.
- *   - hasContent(): có nội dung để chèn không.
- */
-interface StampHostHandle {
-    tryInsert(): boolean;
-    hasContent(): boolean;
-}
-/**
- * Component contract của Host. Chấp nhận cả `forwardRef` thông thường lẫn
- * `React.lazy(() => import('./host'))` (LazyExoticComponent forwards ref).
- */
-type StampHostComponent = ComponentType<StampHostProps & RefAttributes<StampHostHandle>>;
-/**
- * Định nghĩa 1 loại stamp. Mỗi stamp khai báo:
- *   - kind: unique string (khớp với customData.kind)
- *   - phím tắt + UI toolbar
- *   - cách nhận biết customData thuộc về stamp này (matchesCustomData)
- *   - cách re-render SVG từ customData (cho restore sau reload)
- *   - Host component: bọc trọn editor + left panel + insert logic
- *
- * Main view dispatch generic: `<stamp.Host ... />` — không cần biết kind.
- */
-interface StampType<TCustomData extends BaseStampCustomData = BaseStampCustomData> {
-    /** Unique kind. VD: 'geometry', 'latex'. Phải khớp với customData.kind. */
-    kind: string;
-    /** Phím tắt mở/đóng stamp (lowercase, 1 ký tự). VD: 'g', 'l'. */
-    shortcutKey: string;
-    /** Chữ hiển thị overlay góc dưới nút toolbar (e.g. "G"). */
-    toolbarLabel: string;
-    /** Tooltip + aria-label của nút toolbar. */
-    toolbarTitle: string;
-    /** Icon SVG (ReactNode) trong nút toolbar. */
-    toolbarIcon: ReactNode;
-    /** Test data-testid cho nút toolbar (optional). */
-    toolbarTestId?: string;
-    /** Type guard: customData có thuộc về stamp này không. */
-    matchesCustomData(data: unknown): data is TCustomData;
-    /**
-     * Re-render SVG từ customData. Dùng khi restore math-stamp file sau reload
-     * page (Excalidraw không persist binary file payload, chỉ giữ fileId trong
-     * element). SVG render với light palette (nét đậm) — Excalidraw tự đảo
-     * màu trong dark mode qua CSS filter.
-     */
-    renderSvgFromCustomData(data: TCustomData): Promise<string>;
-    /**
-     * Regenerate file SVG/PNG cho element thuộc stamp này khi reload từ persisted
-     * snapshot. Trả về `RestoredStampFile` để consumer gọi `api.addFiles`, hoặc
-     * `null` nếu element không cần file (vd stamp chỉ là text overlay).
-     *
-     * Khi method này có mặt, `restoreMissingStampFiles` sẽ ưu tiên gọi method
-     * này thay vì dùng `renderSvgFromCustomData`. Stamp tự chịu trách nhiệm lấy
-     * `fileId` từ element và render file.
-     */
-    restoreFileFromCustomData?: (element: ExcalidrawElement) => Promise<RestoredStampFile | null>;
-    /**
-     * Host component bọc toàn bộ UI editing (panel + left panel + insert
-     * handler). Whiteboard mount Host khi activeStamp khớp kind.
-     */
-    Host: StampHostComponent;
-    /**
-     * Đánh dấu stamp chưa production-ready. Consumer mặc định bỏ qua
-     * (xem `DEFAULT_STAMPS` chỉ gồm stamp không `experimental`).
-     */
-    experimental?: boolean;
-}
-
-export type { AiFigureUiResult as A, BaseStampCustomData as B, GenerateGeometryFigure as G, StampType as S };