@xom11/whiteboard 0.11.0 → 0.24.0

package/dist/{types-CinstD7T.d.ts → types-rA4slL08.d.ts}

@@ -1,6 +1,69 @@
 import { ReactNode, ComponentType, RefAttributes } from 'react';
 import { ExcalidrawElement } from '@excalidraw/excalidraw/element/types';
 
+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;
+};
+
+/** 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(...)`.
@@ -37,6 +100,8 @@ interface StampHostProps {
     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:
@@ -63,7 +128,7 @@ type StampHostComponent = ComponentType<StampHostProps & RefAttributes<StampHost
  *
  * Main view dispatch generic: `<stamp.Host ... />` — không cần biết kind.
  */
-interface StampType {
+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'. */
@@ -77,14 +142,14 @@ interface StampType {
     /** 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): boolean;
+    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: unknown): Promise<string>;
+    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
@@ -107,4 +172,4 @@ interface StampType {
     experimental?: boolean;
 }
 
-export type { BaseStampCustomData as B, StampType as S };
+export type { AiFigureUiResult as A, BaseStampCustomData as B, GenerateGeometryFigure as G, StampType as S, State as a };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xom11/whiteboard",
-  "version": "0.11.0",
+  "version": "0.24.0",
   "private": false,
   "description": "Excalidraw + JSXGraph + KaTeX whiteboard component (drawing, geometry stamps, LaTeX stamps).",
   "license": "MIT",
@@ -47,13 +47,19 @@
     "*.css"
   ],
   "scripts": {
-    "build": "tsup && node scripts/inject-use-client.mjs",
-    "dev": "tsup --watch --onSuccess \"node scripts/inject-use-client.mjs\"",
+    "build": "tsup && node scripts/inject-use-client.mjs && node scripts/build-catalog.mjs",
+    "build:catalog": "node scripts/build-catalog.mjs",
+    "dev": "tsup --watch --onSuccess \"node scripts/inject-use-client.mjs && node scripts/build-catalog.mjs\"",
     "test": "jest",
     "test:e2e": "playwright test",
     "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
     "clean": "rm -rf dist .yalc yalc.lock",
-    "demo": "vite --config scripts/demo/vite.config.ts"
+    "demo": "vite --config scripts/demo/vite.config.ts",
+    "ai:eval": "tsx scripts/eval-ai.ts",
+    "ai:smoke": "tsx scripts/smoke-ai.ts",
+    "prepublishOnly": "npm run clean && npm run build"
   },
   "peerDependencies": {
     "@excalidraw/excalidraw": "^0.18.1",
@@ -63,6 +69,7 @@
     "react-dom": ">=18.0.0"
   },
   "devDependencies": {
+    "@eslint/js": "^9.39.4",
     "@playwright/test": "^1.60.0",
     "@tailwindcss/vite": "^4.3.0",
     "@testing-library/jest-dom": "^6.9.1",
@@ -73,8 +80,14 @@
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.59.4",
+    "@typescript-eslint/parser": "^8.59.4",
     "@vitejs/plugin-react": "^6.0.2",
+    "eslint": "^9.39.4",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^5.2.0",
     "fake-indexeddb": "^6.0.0",
+    "globals": "^15.15.0",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
     "next": "16.1.6",
@@ -83,10 +96,16 @@
     "tailwindcss": "^4.3.0",
     "ts-jest": "^29.4.9",
     "tsup": "^8.3.5",
+    "tsx": "^4.22.3",
     "typescript": "^5.6.0",
+    "typescript-eslint": "^8.59.4",
     "vite": "^8.0.13"
   },
   "dependencies": {
-    "pdfjs-dist": "^5.7.284"
+    "@anthropic-ai/sdk": "^0.98.0",
+    "immer": "^10.2.0",
+    "pdfjs-dist": "^5.7.284",
+    "zod": "^3.23.8",
+    "zod-to-json-schema": "^3.25.2"
   }
 }

package/dist/ExcalidrawWithMenus-EAVPOPJZ.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ExcalidrawWithMenus.tsx"],"names":[],"mappings":";;;;AAiBO,SAAS,oBAAoB,KAAA,EAAwB;AAC1D,EAAA,MAAM,EAAE,QAAA,EAAU,GAAG,IAAA,EAAK,GAAI,KAAA;AAC9B,EAAA,uBACE,IAAA,CAAC,UAAA,EAAA,EAAY,GAAG,IAAA,EAEd,QAAA,EAAA;AAAA,oBAAA,IAAA,CAAC,QAAA,EAAA,EACC,QAAA,EAAA;AAAA,sBAAA,GAAA,CAAC,QAAA,CAAS,YAAA,CAAa,SAAA,EAAtB,EAAgC,CAAA;AAAA,sBACjC,GAAA,CAAC,QAAA,CAAS,YAAA,CAAa,WAAA,EAAtB,EAAkC,CAAA;AAAA,sBACnC,GAAA,CAAC,QAAA,CAAS,YAAA,CAAa,WAAA,EAAtB,EAAkC,CAAA;AAAA,sBACnC,GAAA,CAAC,QAAA,CAAS,YAAA,CAAa,WAAA,EAAtB,EAAkC;AAAA,KAAA,EACrC,CAAA;AAAA,oBAEA,GAAA,CAAC,MAAA,EAAA,EACC,QAAA,kBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EACR,CAAA;AAAA,oBAGA,GAAA,CAAC,aAAA,EAAA,EACC,QAAA,kBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EACR,CAAA;AAAA,IACC;AAAA,GAAA,EACH,CAAA;AAEJ","file":"ExcalidrawWithMenus-EAVPOPJZ.mjs","sourcesContent":["'use client';\n\n// Client-only wrapper around Excalidraw that lets us reach for static helpers\n// like `MainMenu.DefaultItems.*`. Whiteboard dynamic-imports this\n// file so SSR never evaluates @excalidraw/excalidraw, while inside this file we\n// can use plain static imports (the entire module loads on the client).\n\nimport React from 'react';\nimport {\n  Excalidraw,\n  MainMenu,\n  Footer,\n  WelcomeScreen,\n} from '@excalidraw/excalidraw';\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype ExcalidrawProps = any;\n\nexport function ExcalidrawWithMenus(props: ExcalidrawProps) {\n  const { children, ...rest } = props;\n  return (\n    <Excalidraw {...rest}>\n      {/* Replace default menu with curated items — no socials/help/branding */}\n      <MainMenu>\n        <MainMenu.DefaultItems.LoadScene />\n        <MainMenu.DefaultItems.SaveAsImage />\n        <MainMenu.DefaultItems.ClearCanvas />\n        <MainMenu.DefaultItems.ToggleTheme />\n      </MainMenu>\n      {/* Footer slot with no content suppresses default \"Made with Excalidraw\" link */}\n      <Footer>\n        <span />\n      </Footer>\n      {/* WelcomeScreen slot (empty) prevents the default Excalidraw welcome panel\n       *  (which includes the Excalidraw logo and social links) from appearing. */}\n      <WelcomeScreen>\n        <span />\n      </WelcomeScreen>\n      {children}\n    </Excalidraw>\n  );\n}\n"]}