@xom11/whiteboard 0.10.1 → 0.24.0

package/README.md

@@ -61,6 +61,55 @@ export function ClassroomBoard() {
 }
 ```
 
+### AI dựng hình học 2D (opt-in)
+
+Textarea AI chỉ xuất hiện khi truyền `generateGeometryFigure`. Callback này chạy từ client nên phải gọi một server boundary của ứng dụng; không đưa `ANTHROPIC_API_KEY` vào component hoặc biến môi trường public.
+
+```tsx
+'use client';
+
+import { Whiteboard, type GenerateGeometryFigure } from '@xom11/whiteboard';
+
+const generateGeometryFigure: GenerateGeometryFigure = async (problem, { signal }) => {
+  const response = await fetch('/api/geometry/ai', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ problem }),
+    signal,
+  });
+  return response.json();
+};
+
+export function ClassroomBoard() {
+  return <Whiteboard generateGeometryFigure={generateGeometryFigure} />;
+}
+```
+
+Ví dụ route phía server trong Next.js:
+
+```ts
+import { generateFigure } from '@xom11/whiteboard';
+
+export async function POST(request: Request) {
+  const { problem } = await request.json();
+  const result = await generateFigure(problem, {
+    apiKey: process.env.ANTHROPIC_API_KEY ?? '',
+  });
+  return Response.json(
+    result.ok
+      ? { ok: true, state: result.state }
+      : { ok: false, message: result.message },
+  );
+}
+```
+
+Trong repo package, chạy smoke/eval với API key chỉ ở local shell:
+
+```bash
+ANTHROPIC_API_KEY=... npm run ai:smoke
+ANTHROPIC_API_KEY=... npm run ai:eval -- --limit 5
+```
+
 ## Migration to v0.8.0 (geometry-3d redesign)
 
 `geometry3dStamp` được viết lại theo UX của GeoGebra 3D Calculator:
@@ -110,6 +159,24 @@ import { latexStamp } from '@xom11/whiteboard/latex';
 
 `next` không còn là peer dependency. Whiteboard dùng `React.lazy + Suspense` thuần. Consumer cần Next.js App Router vẫn hoạt động (dist có sẵn `'use client'` directive).
 
+## Extending — thêm stamp mới
+
+Fork repo + viết stamp mới trong ~30 phút. Tham khảo:
+
+- **Howto:** [`docs/superpowers/specs/add-new-stamp-howto.md`](./docs/superpowers/specs/add-new-stamp-howto.md) — 6 bước có sẵn lệnh.
+- **Template:** [`examples/stamp-template/`](./examples/stamp-template/) — skeleton "color-swatch" stamp, copy + đổi `kind`.
+- **Contract test:** mỗi stamp PHẢI pass `runStampContract` (xem [`src/stamps/shared/__tests__/stamp-contract.ts`](./src/stamps/shared/__tests__/stamp-contract.ts)) để đảm bảo `matchesCustomData` / `renderSvgFromCustomData` / roundtrip restore không break.
+- **Catalog:** thêm entry vào [`src/stamps/shared/catalog.ts`](./src/stamps/shared/catalog.ts). Bundle size tự tính qua `scripts/build-catalog.mjs` khi `npm run build`.
+
+```tsx
+import { STAMP_CATALOG, findCatalogEntry } from '@xom11/whiteboard';
+
+// Render admin UI từ catalog
+STAMP_CATALOG.forEach((entry) => {
+  console.log(entry.id, entry.title, entry.bundleSize.js + 'KB gzip');
+});
+```
+
 ## Development
 
 ```bash

package/dist/{ExcalidrawWithMenus-EAVPOPJZ.mjs → ExcalidrawWithMenus-KBLDWPM2.mjs}

@@ -1,5 +1,4 @@
 "use client";
-import './chunk-BJTO5JO5.mjs';
 import { Excalidraw, MainMenu, Footer, WelcomeScreen } from '@excalidraw/excalidraw';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
@@ -19,5 +18,5 @@ function ExcalidrawWithMenus(props) {
 }
 
 export { ExcalidrawWithMenus };
-//# sourceMappingURL=ExcalidrawWithMenus-EAVPOPJZ.mjs.map
-//# sourceMappingURL=ExcalidrawWithMenus-EAVPOPJZ.mjs.map
+//# sourceMappingURL=ExcalidrawWithMenus-KBLDWPM2.mjs.map
+//# sourceMappingURL=ExcalidrawWithMenus-KBLDWPM2.mjs.map

package/dist/ExcalidrawWithMenus-KBLDWPM2.mjs.map

@@ -0,0 +1 @@
+{"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-KBLDWPM2.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"]}

package/dist/catalog.json

@@ -0,0 +1,57 @@
+{
+  "generatedAt": "2026-05-26T06:17:07.060Z",
+  "entries": [
+    {
+      "id": "geometry",
+      "title": "Hình học 2D (JSXGraph)",
+      "version": 1,
+      "experimental": false,
+      "runtimeDeps": [
+        "jsxgraph"
+      ],
+      "bundleSize": {
+        "js": 50.75,
+        "css": 0
+      }
+    },
+    {
+      "id": "latex",
+      "title": "Công thức LaTeX (KaTeX)",
+      "version": 1,
+      "experimental": false,
+      "runtimeDeps": [
+        "katex"
+      ],
+      "bundleSize": {
+        "js": 8.93,
+        "css": 0
+      }
+    },
+    {
+      "id": "geometry3d",
+      "title": "Hình học 3D (JSXGraph view3d)",
+      "version": 2,
+      "experimental": true,
+      "runtimeDeps": [
+        "jsxgraph"
+      ],
+      "bundleSize": {
+        "js": 40.03,
+        "css": 0
+      }
+    },
+    {
+      "id": "graph2d",
+      "title": "Đồ thị hàm số 2D (JSXGraph)",
+      "version": 2,
+      "experimental": true,
+      "runtimeDeps": [
+        "jsxgraph"
+      ],
+      "bundleSize": {
+        "js": 33.27,
+        "css": 0
+      }
+    }
+  ]
+}

package/dist/{chunk-PWIMZIB6.mjs → chunk-2SKXRBGS.mjs}

@@ -1,10 +1,11 @@
 "use client";
-import { isGeometry3DCustomData, renderGeometry3DSvgFromState } from './chunk-WQOABS6N.mjs';
+import { isGeometry3DCustomData, renderGeometry3DSvgFromState } from './chunk-RBUILBX3.mjs';
+import { svgToStampFile } from './chunk-5UTGXHLJ.mjs';
 import { lazy } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
 var Geometry3DStampHost = lazy(
-  () => import('./host-N6ACNJKI.mjs').then((m) => ({ default: m.Geometry3DStampHost }))
+  () => import('./host-HN4X3TBC.mjs').then((m) => ({ default: m.Geometry3DStampHost }))
 );
 var Geometry3DIcon = /* @__PURE__ */ jsxs(
   "svg",
@@ -44,12 +45,10 @@ var geometry3dStamp = {
   restoreFileFromCustomData: async (element) => {
     const data = element.customData;
     const fileId = element.fileId;
-    if (!data || !fileId) return null;
-    if (!isGeometry3DCustomData(data)) return null;
+    if (!data || !fileId || !isGeometry3DCustomData(data)) return null;
     try {
       const { svgString } = await renderGeometry3DSvgFromState(data.jsonState);
-      const dataURL = `data:image/svg+xml;base64,${typeof btoa !== "undefined" ? btoa(unescape(encodeURIComponent(svgString))) : Buffer.from(svgString).toString("base64")}`;
-      return { fileId, dataURL, mimeType: "image/svg+xml" };
+      return svgToStampFile(svgString, fileId);
     } catch {
       return null;
     }
@@ -58,5 +57,5 @@ var geometry3dStamp = {
 };
 
 export { geometry3dStamp };
-//# sourceMappingURL=chunk-PWIMZIB6.mjs.map
-//# sourceMappingURL=chunk-PWIMZIB6.mjs.map
+//# sourceMappingURL=chunk-2SKXRBGS.mjs.map
+//# sourceMappingURL=chunk-2SKXRBGS.mjs.map

package/dist/chunk-2SKXRBGS.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/stamps/geometry-3d/index.tsx"],"names":[],"mappings":";;;;;AAgBA,IAAM,mBAAA,GAAsB,IAAA;AAAA,EAAK,MAC/B,OAAO,qBAAQ,CAAA,CAAE,IAAA,CAAK,CAAC,CAAA,MAAO,EAAE,OAAA,EAAS,CAAA,CAAE,mBAAA,EAAoB,CAAE;AACnE,CAAA;AAEA,IAAM,cAAA,mBACJ,IAAA;AAAA,EAAC,KAAA;AAAA,EAAA;AAAA,IACC,KAAA,EAAM,IAAA;AAAA,IACN,MAAA,EAAO,IAAA;AAAA,IACP,OAAA,EAAQ,WAAA;AAAA,IACR,IAAA,EAAK,MAAA;AAAA,IACL,MAAA,EAAO,cAAA;AAAA,IACP,WAAA,EAAY,KAAA;AAAA,IACZ,aAAA,EAAc,OAAA;AAAA,IACd,cAAA,EAAe,OAAA;AAAA,IACf,aAAA,EAAY,MAAA;AAAA,IAGZ,QAAA,EAAA;AAAA,sBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,GAAE,2BAAA,EAA4B,CAAA;AAAA,sBAEpC,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,0BAAA,EAA2B,CAAA;AAAA,sBAEnC,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,6BAAA,EAA8B;AAAA;AAAA;AACxC,CAAA;AAGK,IAAM,eAAA,GAAmD;AAAA,EAC9D,IAAA,EAAM,YAAA;AAAA,EACN,YAAA,EAAc,IAAA;AAAA,EACd,WAAA,EAAa,GAAA;AAAA,EACb,YAAA,EAAc,GAAA;AAAA,EACd,YAAA,EAAc,gBAAA;AAAA,EACd,WAAA,EAAa,cAAA;AAAA,EACb,aAAA,EAAe,0BAAA;AAAA,EACf,iBAAA,EAAmB,sBAAA;AAAA,EACnB,MAAM,wBAAwB,IAAA,EAAgC;AAC5D,IAAA,IAAI,CAAC,sBAAA,CAAuB,IAAI,CAAA,EAAG;AACjC,MAAA,MAAM,IAAI,MAAM,mFAA2E,CAAA;AAAA,IAC7F;AACA,IAAA,MAAM,EAAE,SAAA,EAAU,GAAI,MAAM,4BAAA,CAA6B,KAAK,SAAS,CAAA;AACvE,IAAA,OAAO,SAAA;AAAA,EACT,CAAA;AAAA,EACA,yBAAA,EAA2B,OAAO,OAAA,KAA+C;AAC/E,IAAA,MAAM,OAAO,OAAA,CAAQ,UAAA;AACrB,IAAA,MAAM,SAAU,OAAA,CAAuC,MAAA;AACvD,IAAA,IAAI,CAAC,QAAQ,CAAC,MAAA,IAAU,CAAC,sBAAA,CAAuB,IAAI,GAAG,OAAO,IAAA;AAC9D,IAAA,IAAI;AACF,MAAA,MAAM,EAAE,SAAA,EAAU,GAAI,MAAM,4BAAA,CAA6B,KAAK,SAAS,CAAA;AACvE,MAAA,OAAO,cAAA,CAAe,WAAW,MAAM,CAAA;AAAA,IACzC,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF,CAAA;AAAA,EACA,IAAA,EAAM;AACR","file":"chunk-2SKXRBGS.mjs","sourcesContent":["'use client';\n\nimport { lazy, type ReactNode } from 'react';\nimport {\n  isGeometry3DCustomData,\n  type Geometry3DCustomData,\n} from './serialize';\nimport { renderGeometry3DSvgFromState } from './render';\nimport type {\n  RestoredStampFile,\n  StampType,\n} from '../shared/types';\nimport { svgToStampFile } from '../shared/svgToStampFile';\n\nexport type { Geometry3DCustomData };\n\nconst Geometry3DStampHost = lazy(() =>\n  import('./host').then((m) => ({ default: m.Geometry3DStampHost })),\n);\n\nconst Geometry3DIcon: ReactNode = (\n  <svg\n    width=\"20\"\n    height=\"20\"\n    viewBox=\"0 0 24 24\"\n    fill=\"none\"\n    stroke=\"currentColor\"\n    strokeWidth=\"1.6\"\n    strokeLinecap=\"round\"\n    strokeLinejoin=\"round\"\n    aria-hidden=\"true\"\n  >\n    {/* Mặt trước */}\n    <path d=\"M4 9 L4 20 L14 20 L14 9 Z\" />\n    {/* Mặt trên */}\n    <path d=\"M4 9 L10 4 L20 4 L14 9 Z\" />\n    {/* Mặt phải */}\n    <path d=\"M14 9 L20 4 L20 15 L14 20 Z\" />\n  </svg>\n);\n\nexport const geometry3dStamp: StampType<Geometry3DCustomData> = {\n  kind: 'geometry3d',\n  experimental: true,\n  shortcutKey: 'd',\n  toolbarLabel: 'D',\n  toolbarTitle: 'Hình 3D (D)',\n  toolbarIcon: Geometry3DIcon,\n  toolbarTestId: 'stamp-toolbar-geometry3d',\n  matchesCustomData: isGeometry3DCustomData,\n  async renderSvgFromCustomData(data: unknown): Promise<string> {\n    if (!isGeometry3DCustomData(data)) {\n      throw new Error('geometry3dStamp.renderSvgFromCustomData: customData không phải geometry3d');\n    }\n    const { svgString } = await renderGeometry3DSvgFromState(data.jsonState);\n    return svgString;\n  },\n  restoreFileFromCustomData: async (element): Promise<RestoredStampFile | null> => {\n    const data = element.customData as Geometry3DCustomData | undefined;\n    const fileId = (element as { fileId?: string | null }).fileId;\n    if (!data || !fileId || !isGeometry3DCustomData(data)) return null;\n    try {\n      const { svgString } = await renderGeometry3DSvgFromState(data.jsonState);\n      return svgToStampFile(svgString, fileId);\n    } catch {\n      return null;\n    }\n  },\n  Host: Geometry3DStampHost,\n};\n"]}

package/dist/chunk-33PEN2WC.mjs

@@ -0,0 +1,57 @@
+"use client";
+import { paletteFor } from './chunk-VBJLUHCY.mjs';
+import { JxgRenderer } from './chunk-6XUPIGVD.mjs';
+import { renderJsxgOffscreen } from './chunk-RD34F5PM.mjs';
+import { createStore } from './chunk-VRWZILTG.mjs';
+
+// src/stamps/graph-2d/render.ts
+var DEFAULT_WIDTH = 600;
+var DEFAULT_HEIGHT = 400;
+async function renderGraphSvgFromState(state, _isDark, width = DEFAULT_WIDTH, height = DEFAULT_HEIGHT) {
+  const palette = paletteFor(false);
+  const meta = state.meta;
+  const view = meta.domain === "graph2d" ? meta.view : null;
+  const bbox = [
+    view?.xMin ?? -10,
+    view?.yMax ?? 10,
+    view?.xMax ?? 10,
+    view?.yMin ?? -10
+  ];
+  try {
+    const { svgString } = await renderJsxgOffscreen({
+      bbox,
+      dims: { width, height },
+      axis: view?.showAxis ?? true,
+      grid: view?.showGrid ?? true,
+      keepAspectRatio: false,
+      applyOptions: (JXG) => {
+        const opts = JXG.Options;
+        if (!opts) return;
+        opts.text = opts.text || {};
+        opts.text.display = "internal";
+        opts.text.useASCIIMathML = false;
+        opts.text.useMathJax = false;
+        opts.text.useKatex = false;
+        opts.text.strokeColor = palette.label;
+        opts.label = opts.label || {};
+        opts.label.display = "internal";
+        opts.label.strokeColor = palette.label;
+        opts.axis = opts.axis || {};
+        opts.axis.strokeColor = palette.axis;
+        opts.grid = opts.grid || {};
+        opts.grid.strokeColor = palette.grid;
+      },
+      setup: (board) => {
+        const store = createStore(state);
+        return new JxgRenderer(store, board);
+      }
+    });
+    return svgString;
+  } catch {
+    return "";
+  }
+}
+
+export { renderGraphSvgFromState };
+//# sourceMappingURL=chunk-33PEN2WC.mjs.map
+//# sourceMappingURL=chunk-33PEN2WC.mjs.map

package/dist/chunk-33PEN2WC.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/stamps/graph-2d/render.ts"],"names":[],"mappings":";;;;;;AAUA,IAAM,aAAA,GAAgB,GAAA;AACtB,IAAM,cAAA,GAAiB,GAAA;AAEvB,eAAsB,wBACpB,KAAA,EACA,OAAA,EACA,KAAA,GAAQ,aAAA,EACR,SAAS,cAAA,EACQ;AACjB,EAAA,MAAM,OAAA,GAAU,WAAW,KAAK,CAAA;AAChC,EAAA,MAAM,OAAO,KAAA,CAAM,IAAA;AACnB,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,MAAA,KAAW,SAAA,GAAY,KAAK,IAAA,GAAO,IAAA;AACrD,EAAA,MAAM,IAAA,GAAyC;AAAA,IAC7C,MAAM,IAAA,IAAQ,GAAA;AAAA,IACd,MAAM,IAAA,IAAQ,EAAA;AAAA,IACd,MAAM,IAAA,IAAQ,EAAA;AAAA,IACd,MAAM,IAAA,IAAQ;AAAA,GAChB;AACA,EAAA,IAAI;AACF,IAAA,MAAM,EAAE,SAAA,EAAU,GAAI,MAAM,mBAAA,CAAoB;AAAA,MAC9C,IAAA;AAAA,MACA,IAAA,EAAM,EAAE,KAAA,EAAO,MAAA,EAAO;AAAA,MACtB,IAAA,EAAM,MAAM,QAAA,IAAY,IAAA;AAAA,MACxB,IAAA,EAAM,MAAM,QAAA,IAAY,IAAA;AAAA,MACxB,eAAA,EAAiB,KAAA;AAAA,MACjB,YAAA,EAAc,CAAC,GAAA,KAAQ;AAErB,QAAA,MAAM,OAAQ,GAAA,CAAY,OAAA;AAC1B,QAAA,IAAI,CAAC,IAAA,EAAM;AACX,QAAA,IAAA,CAAK,IAAA,GAAO,IAAA,CAAK,IAAA,IAAQ,EAAC;AAC1B,QAAA,IAAA,CAAK,KAAK,OAAA,GAAU,UAAA;AACpB,QAAA,IAAA,CAAK,KAAK,cAAA,GAAiB,KAAA;AAC3B,QAAA,IAAA,CAAK,KAAK,UAAA,GAAa,KAAA;AACvB,QAAA,IAAA,CAAK,KAAK,QAAA,GAAW,KAAA;AACrB,QAAA,IAAA,CAAK,IAAA,CAAK,cAAc,OAAA,CAAQ,KAAA;AAChC,QAAA,IAAA,CAAK,KAAA,GAAQ,IAAA,CAAK,KAAA,IAAS,EAAC;AAC5B,QAAA,IAAA,CAAK,MAAM,OAAA,GAAU,UAAA;AACrB,QAAA,IAAA,CAAK,KAAA,CAAM,cAAc,OAAA,CAAQ,KAAA;AACjC,QAAA,IAAA,CAAK,IAAA,GAAO,IAAA,CAAK,IAAA,IAAQ,EAAC;AAC1B,QAAA,IAAA,CAAK,IAAA,CAAK,cAAc,OAAA,CAAQ,IAAA;AAChC,QAAA,IAAA,CAAK,IAAA,GAAO,IAAA,CAAK,IAAA,IAAQ,EAAC;AAC1B,QAAA,IAAA,CAAK,IAAA,CAAK,cAAc,OAAA,CAAQ,IAAA;AAAA,MAClC,CAAA;AAAA,MACA,KAAA,EAAO,CAAC,KAAA,KAAU;AAChB,QAAA,MAAM,KAAA,GAAQ,YAAY,KAAK,CAAA;AAC/B,QAAA,OAAO,IAAI,WAAA,CAAY,KAAA,EAAO,KAAK,CAAA;AAAA,MACrC;AAAA,KACD,CAAA;AACD,IAAA,OAAO,SAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AAEN,IAAA,OAAO,EAAA;AAAA,EACT;AACF","file":"chunk-33PEN2WC.mjs","sourcesContent":["// src/stamps/graph-2d/render.ts\n// Offscreen SVG export từ graph2d State. Dùng cho insert/restore stamp.\n//\n// LƯU Ý: Luôn dùng light palette — Excalidraw tự invert trong dark mode.\nimport type { State } from '../../core/scene/types';\nimport { createStore } from '../../core/scene/store';\nimport { JxgRenderer } from '../../core/scene/render/JxgRenderer';\nimport { paletteFor } from './editor/theme';\nimport { renderJsxgOffscreen } from '../shared/jxgOffscreenRender';\n\nconst DEFAULT_WIDTH = 600;\nconst DEFAULT_HEIGHT = 400;\n\nexport async function renderGraphSvgFromState(\n  state: State,\n  _isDark: boolean,\n  width = DEFAULT_WIDTH,\n  height = DEFAULT_HEIGHT,\n): Promise<string> {\n  const palette = paletteFor(false);\n  const meta = state.meta;\n  const view = meta.domain === 'graph2d' ? meta.view : null;\n  const bbox: [number, number, number, number] = [\n    view?.xMin ?? -10,\n    view?.yMax ?? 10,\n    view?.xMax ?? 10,\n    view?.yMin ?? -10,\n  ];\n  try {\n    const { svgString } = await renderJsxgOffscreen({\n      bbox,\n      dims: { width, height },\n      axis: view?.showAxis ?? true,\n      grid: view?.showGrid ?? true,\n      keepAspectRatio: false,\n      applyOptions: (JXG) => {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const opts = (JXG as any).Options;\n        if (!opts) return;\n        opts.text = opts.text || {};\n        opts.text.display = 'internal';\n        opts.text.useASCIIMathML = false;\n        opts.text.useMathJax = false;\n        opts.text.useKatex = false;\n        opts.text.strokeColor = palette.label;\n        opts.label = opts.label || {};\n        opts.label.display = 'internal';\n        opts.label.strokeColor = palette.label;\n        opts.axis = opts.axis || {};\n        opts.axis.strokeColor = palette.axis;\n        opts.grid = opts.grid || {};\n        opts.grid.strokeColor = palette.grid;\n      },\n      setup: (board) => {\n        const store = createStore(state);\n        return new JxgRenderer(store, board);\n      },\n    });\n    return svgString;\n  } catch {\n    // Match old contract: callers expect '' when no SVG produced.\n    return '';\n  }\n}\n"]}

package/dist/chunk-3KBL77M6.mjs

@@ -0,0 +1,127 @@
+"use client";
+import * as React from 'react';
+
+// src/core/scene/types.ts
+var DEFAULT_VIEW_2D = {
+  bbox: [-10, 10, 10, -10],
+  showAxis: false,
+  showGrid: false
+};
+var DEFAULT_VIEW_3D = {
+  bbox3D: [-5, 5, -5, 5, -5, 5],
+  azimuth: 60,
+  elevation: 30
+};
+var DEFAULT_VIEW_GRAPH2D = {
+  xMin: -10,
+  xMax: 10,
+  yMin: -10,
+  yMax: 10,
+  showAxis: true,
+  showGrid: true
+};
+function createEmptyState(domain) {
+  const base = { objects: {}, order: [], counter: 0 };
+  switch (domain) {
+    case "2d":
+      return { ...base, meta: { domain: "2d", version: 1, view: DEFAULT_VIEW_2D } };
+    case "3d":
+      return { ...base, meta: { domain: "3d", version: 1, view: DEFAULT_VIEW_3D } };
+    case "graph2d":
+      return { ...base, meta: { domain: "graph2d", version: 1, view: DEFAULT_VIEW_GRAPH2D } };
+  }
+}
+
+// src/core/scene/selectors.ts
+function listObjects(state) {
+  return state.order.map((id) => state.objects[id]).filter((o) => o !== void 0);
+}
+var ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+var LABEL_GROUPS = {
+  point: ["point", "intersection"],
+  intersection: ["point", "intersection"]
+};
+function nextLabel(state, kind) {
+  const kinds = LABEL_GROUPS[kind] ?? [kind];
+  const used = new Set(
+    listObjects(state).filter((o) => kinds.includes(o.kind)).map((o) => o.label)
+  );
+  for (const c of ALPHABET) if (!used.has(c)) return c;
+  let idx = 1;
+  while (true) {
+    for (const c of ALPHABET) {
+      const candidate = `${c}${idx}`;
+      if (!used.has(candidate)) return candidate;
+    }
+    idx += 1;
+  }
+}
+function useEditorState(opts) {
+  const { store, initialState, onHistoryChange, bindKeyboardShortcuts = true } = opts;
+  const onHistoryChangeRef = React.useRef(onHistoryChange);
+  onHistoryChangeRef.current = onHistoryChange;
+  React.useEffect(() => {
+    if (initialState?.state) {
+      const loaded = initialState.state;
+      store.withoutHistory(() => {
+        store.dispatch({ type: "LOAD", payload: { state: loaded } });
+      });
+    }
+  }, []);
+  React.useEffect(() => {
+    onHistoryChangeRef.current?.(store.canUndo(), store.canRedo());
+    const unsub = store.subscribe(() => {
+      onHistoryChangeRef.current?.(store.canUndo(), store.canRedo());
+    });
+    return unsub;
+  }, [store]);
+  React.useEffect(() => {
+    if (!bindKeyboardShortcuts) return;
+    const onKey = (e) => {
+      const ae = document.activeElement;
+      const inField = !!(ae && (ae.tagName === "INPUT" || ae.tagName === "TEXTAREA" || ae.isContentEditable));
+      if (inField) return;
+      if (!(e.metaKey || e.ctrlKey)) return;
+      const key = e.key.toLowerCase();
+      if (key === "z" && !e.shiftKey) {
+        e.preventDefault();
+        e.stopPropagation();
+        store.undo();
+      } else if (key === "z" && e.shiftKey || key === "y" && !e.shiftKey) {
+        e.preventDefault();
+        e.stopPropagation();
+        store.redo();
+      }
+    };
+    window.addEventListener("keydown", onKey, { capture: true });
+    return () => window.removeEventListener("keydown", onKey, { capture: true });
+  }, [store, bindKeyboardShortcuts]);
+}
+
+// src/stamps/shared/serializeScene.ts
+function serializeScene(state) {
+  return JSON.stringify(state);
+}
+function isValidState(value, domain) {
+  if (!value || typeof value !== "object") return false;
+  const v = value;
+  if (!v.meta || typeof v.meta !== "object") return false;
+  if (v.meta.domain !== domain) return false;
+  if (!v.meta.view || typeof v.meta.view !== "object") return false;
+  if (!v.objects || typeof v.objects !== "object") return false;
+  if (!Array.isArray(v.order)) return false;
+  return true;
+}
+function deserializeScene(domain, raw) {
+  if (!raw) return createEmptyState(domain);
+  try {
+    const parsed = JSON.parse(raw);
+    if (isValidState(parsed, domain)) return parsed;
+  } catch {
+  }
+  return createEmptyState(domain);
+}
+
+export { DEFAULT_VIEW_2D, DEFAULT_VIEW_3D, createEmptyState, deserializeScene, listObjects, nextLabel, serializeScene, useEditorState };
+//# sourceMappingURL=chunk-3KBL77M6.mjs.map
+//# sourceMappingURL=chunk-3KBL77M6.mjs.map

package/dist/chunk-3KBL77M6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/scene/types.ts","../src/core/scene/selectors.ts","../src/core/scene/hooks/useEditorState.ts","../src/stamps/shared/serializeScene.ts"],"names":[],"mappings":"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","file":"chunk-3KBL77M6.mjs","sourcesContent":["// src/core/scene/types.ts\n\nexport type SceneObject<A = Record<string, unknown>> = {\n  id: string;\n  kind: string;\n  label: string;\n  visible: boolean;\n  locked: boolean;\n  layer: string;\n  schemaVersion: number;\n  attrs: A;\n};\n\n// View per domain — narrow theo `state.meta.domain`.\nexport type View2D = {\n  readonly bbox: readonly [number, number, number, number]; // [xmin, ymax, xmax, ymin]\n  readonly showAxis: boolean;\n  readonly showGrid: boolean;\n};\n\nexport type View3D = {\n  readonly bbox3D: readonly [number, number, number, number, number, number]; // [xmin, xmax, ymin, ymax, zmin, zmax]\n  readonly azimuth: number;\n  readonly elevation: number;\n};\n\nexport type ViewGraph2D = {\n  readonly xMin: number;\n  readonly xMax: number;\n  readonly yMin: number;\n  readonly yMax: number;\n  readonly showAxis: boolean;\n  readonly showGrid: boolean;\n};\n\n// Union of all view shapes — narrow qua state.meta.domain.\nexport type SceneView = View2D | View3D | ViewGraph2D;\n\n// Discriminated union: domain narrow → view shape narrow.\nexport type StateMeta =\n  | { readonly domain: '2d';      readonly version: number; readonly view: View2D }\n  | { readonly domain: '3d';      readonly version: number; readonly view: View3D }\n  | { readonly domain: 'graph2d'; readonly version: number; readonly view: ViewGraph2D };\n\nexport type Domain = StateMeta['domain'];\n\n// Backward-compat alias: UPDATE_VIEW patch dùng graph-2d shape (chỉ graph-2d\n// dispatch action này hiện tại).\nexport type ViewSettings = ViewGraph2D;\n\nexport type State = {\n  readonly objects: Readonly<Record<string, SceneObject>>;\n  readonly order: readonly string[];\n  readonly counter: number;\n  readonly meta: StateMeta;\n};\n\nexport type Action =\n  | { type: 'ADD'; payload: { obj: SceneObject } }\n  | { type: 'UPDATE'; payload: { id: string; patch: Partial<Omit<SceneObject, 'id' | 'kind' | 'attrs'>> } }\n  | { type: 'UPDATE_ATTRS'; payload: { id: string; patch: Record<string, unknown> } }\n  | { type: 'DELETE'; payload: { id: string } }\n  | { type: 'RESET' }\n  | { type: 'LOAD'; payload: { state: State } }\n  | { type: 'TRANSACTION'; payload: { actions: Action[] } }\n  | { type: 'UPDATE_VIEW'; payload: { patch: Partial<ViewSettings> } };\n\nexport type RenderCtx = {\n  jxg: unknown;\n  resolveRef: (id: string) => unknown;\n  defaults: Readonly<Record<string, unknown>>;\n  /** Map tham số (parameter.label → parameter.value). Chỉ graph2d dùng. */\n  paramMap?: Readonly<Record<string, number>>;\n};\n\nexport type KindDef<A = Record<string, unknown>> = {\n  type: string;\n  schemaVersion: number;\n  migrate: Record<number, (prev: any) => any>;\n  validate?: (attrs: A) => void;\n  dependsOn: (attrs: A) => string[];\n  describe: (obj: SceneObject<A>, state?: State) => string;\n  measure?: (obj: SceneObject<A>, state: State) =>\n    | { label: string; value: number }[]\n    | null;\n  render: (obj: SceneObject<A>, ctx: RenderCtx) => unknown;\n  update?: (\n    obj: SceneObject<A>,\n    prev: SceneObject<A>,\n    ctx: RenderCtx,\n    existing: unknown,\n  ) => void;\n};\n\nexport const DEFAULT_VIEW_2D: View2D = {\n  bbox: [-10, 10, 10, -10],\n  showAxis: false,\n  showGrid: false,\n};\n\nexport const DEFAULT_VIEW_3D: View3D = {\n  bbox3D: [-5, 5, -5, 5, -5, 5],\n  azimuth: 60,\n  elevation: 30,\n};\n\nexport const DEFAULT_VIEW_GRAPH2D: ViewGraph2D = {\n  xMin: -10, xMax: 10, yMin: -10, yMax: 10,\n  showAxis: true, showGrid: true,\n};\n\n// EMPTY_STATE giữ shape '3d' (legacy default). Dùng `createEmptyState(domain)`\n// khi cần state cụ thể cho domain — đảm bảo meta.view khớp domain.\nexport const EMPTY_STATE: State = {\n  objects: {},\n  order: [],\n  counter: 0,\n  meta: { domain: '3d', version: 1, view: DEFAULT_VIEW_3D },\n};\n\nexport function createEmptyState(domain: Domain): State {\n  const base = { objects: {}, order: [], counter: 0 } as const;\n  switch (domain) {\n    case '2d':\n      return { ...base, meta: { domain: '2d', version: 1, view: DEFAULT_VIEW_2D } };\n    case '3d':\n      return { ...base, meta: { domain: '3d', version: 1, view: DEFAULT_VIEW_3D } };\n    case 'graph2d':\n      return { ...base, meta: { domain: 'graph2d', version: 1, view: DEFAULT_VIEW_GRAPH2D } };\n  }\n}\n","// src/core/scene/selectors.ts\nimport type { State, SceneObject } from './types';\nimport { getKind } from './registry';\n\nexport function listObjects(state: State): SceneObject[] {\n  return state.order\n    .map(id => state.objects[id])\n    .filter((o): o is SceneObject => o !== undefined);\n}\n\nexport function byKind(state: State, kind: string): SceneObject[] {\n  return listObjects(state).filter(o => o.kind === kind);\n}\n\nexport function dependentsOf(state: State, rootId: string): Set<string> {\n  const result = new Set<string>([rootId]);\n  let grew = true;\n  while (grew) {\n    grew = false;\n    for (const obj of Object.values(state.objects)) {\n      if (result.has(obj.id)) continue;\n      let def;\n      try { def = getKind(obj.kind); } catch { continue; }\n      const refs = def.dependsOn(obj.attrs as never);\n      if (refs.some(r => result.has(r))) {\n        result.add(obj.id);\n        grew = true;\n      }\n    }\n  }\n  return result;\n}\n\nconst ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';\n\n/**\n * Nhóm các kind chia chung namespace label. User nhìn point free, intersection,\n * midpoint đều là \"điểm\" có tên 1 chữ cái — không được trùng tên dù khác kind\n * trong scene store. Ví dụ tam giác ABC + giao điểm 2 đường: giao điểm phải là\n * D (không phải A trùng đỉnh tam giác).\n */\nconst LABEL_GROUPS: Record<string, readonly string[]> = {\n  point: ['point', 'intersection'],\n  intersection: ['point', 'intersection'],\n};\n\nexport function nextLabel(state: State, kind: string): string {\n  const kinds = LABEL_GROUPS[kind] ?? [kind];\n  const used = new Set(\n    listObjects(state).filter(o => kinds.includes(o.kind)).map(o => o.label),\n  );\n  for (const c of ALPHABET) if (!used.has(c)) return c;\n  let idx = 1;\n  while (true) {\n    for (const c of ALPHABET) {\n      const candidate = `${c}${idx}`;\n      if (!used.has(candidate)) return candidate;\n    }\n    idx += 1;\n  }\n}\n","// src/core/scene/hooks/useEditorState.ts\nimport * as React from 'react';\nimport type { Store } from '../store';\nimport type { State } from '../types';\n\nexport interface UseEditorStateOptions {\n  /** Store sẵn có (host owns). */\n  store: Store;\n  /** Serialized scene để LOAD lúc mount. Null/undefined = bỏ qua. */\n  initialState?: { state: State } | null;\n  /** Notify host mỗi khi store fire (canUndo/canRedo có thể đổi). */\n  onHistoryChange?: (canUndo: boolean, canRedo: boolean) => void;\n  /** Bind Ctrl/Cmd+Z, Cmd+Shift+Z, Ctrl+Y. Default true. */\n  bindKeyboardShortcuts?: boolean;\n}\n\n// Side effects chung cho stamp editor panel mà host owns store:\n// - LOAD initial state một lần (trong withoutHistory để không bẩn undo stack).\n// - Propagate canUndo/canRedo lên host qua callback.\n// - Bind global keyboard shortcuts cho undo/redo.\nexport function useEditorState(opts: UseEditorStateOptions): void {\n  const { store, initialState, onHistoryChange, bindKeyboardShortcuts = true } = opts;\n\n  const onHistoryChangeRef = React.useRef(onHistoryChange);\n  onHistoryChangeRef.current = onHistoryChange;\n\n  React.useEffect(() => {\n    if (initialState?.state) {\n      const loaded = initialState.state;\n      store.withoutHistory(() => {\n        store.dispatch({ type: 'LOAD', payload: { state: loaded } });\n      });\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  React.useEffect(() => {\n    onHistoryChangeRef.current?.(store.canUndo(), store.canRedo());\n    const unsub = store.subscribe(() => {\n      onHistoryChangeRef.current?.(store.canUndo(), store.canRedo());\n    });\n    return unsub;\n  }, [store]);\n\n  React.useEffect(() => {\n    if (!bindKeyboardShortcuts) return;\n    const onKey = (e: KeyboardEvent) => {\n      const ae = document.activeElement as HTMLElement | null;\n      const inField = !!(\n        ae && (ae.tagName === 'INPUT' || ae.tagName === 'TEXTAREA' || ae.isContentEditable)\n      );\n      if (inField) return;\n      if (!(e.metaKey || e.ctrlKey)) return;\n      const key = e.key.toLowerCase();\n      if (key === 'z' && !e.shiftKey) {\n        e.preventDefault();\n        e.stopPropagation();\n        store.undo();\n      } else if ((key === 'z' && e.shiftKey) || (key === 'y' && !e.shiftKey)) {\n        e.preventDefault();\n        e.stopPropagation();\n        store.redo();\n      }\n    };\n    window.addEventListener('keydown', onKey, { capture: true });\n    return () => window.removeEventListener('keydown', onKey, { capture: true });\n  }, [store, bindKeyboardShortcuts]);\n}\n","// Shared serialize/deserialize cho scene State của stamp interactive\n// (geometry-2d, geometry-3d, graph-2d). Sau Tier D PR 3, customData chỉ\n// store JSON.stringify(state) — không còn envelope `{version, bbox, state}`.\n//\n// View info (bbox/axis/grid/azimuth/elevation) nằm trong `state.meta.view`\n// (discriminated union theo domain). createEmptyState set default view.\n//\n// Note: v0.20 KHÔNG support backward-compat envelope cũ. Data sessionStorage\n// cũ sẽ fallback về empty state khi parse fail (per user spec).\n\nimport { createEmptyState, type Domain, type State } from '../../core/scene';\n\nexport function serializeScene(state: State): string {\n  return JSON.stringify(state);\n}\n\nfunction isValidState(value: unknown, domain: Domain): value is State {\n  if (!value || typeof value !== 'object') return false;\n  const v = value as Partial<State>;\n  if (!v.meta || typeof v.meta !== 'object') return false;\n  if (v.meta.domain !== domain) return false;\n  if (!v.meta.view || typeof v.meta.view !== 'object') return false;\n  if (!v.objects || typeof v.objects !== 'object') return false;\n  if (!Array.isArray(v.order)) return false;\n  return true;\n}\n\nexport function deserializeScene(domain: Domain, raw: string): State {\n  if (!raw) return createEmptyState(domain);\n  try {\n    const parsed = JSON.parse(raw);\n    if (isValidState(parsed, domain)) return parsed;\n  } catch {\n    /* swallow — fallback empty state */\n  }\n  return createEmptyState(domain);\n}\n"]}

package/dist/chunk-5UTGXHLJ.mjs

@@ -0,0 +1,57 @@
+"use client";
+// src/stamps/shared/svgToStampFile.ts
+var DEFAULT_WIDTH = 200;
+var DEFAULT_HEIGHT = 100;
+async function hashSvgToFileId(input) {
+  if (typeof crypto !== "undefined" && crypto.subtle) {
+    const buf = new TextEncoder().encode(input);
+    const digest = await crypto.subtle.digest("SHA-256", buf);
+    return Array.from(new Uint8Array(digest)).slice(0, 16).map((b) => b.toString(16).padStart(2, "0")).join("");
+  }
+  let h1 = 2166136261;
+  let h2 = 3421674724;
+  for (let i = 0; i < input.length; i++) {
+    const c = input.charCodeAt(i);
+    h1 ^= c;
+    h1 = Math.imul(h1, 16777619);
+    h2 ^= c + i;
+    h2 = Math.imul(h2, 1099511628211 & 4294967295);
+  }
+  return (h1 >>> 0).toString(16).padStart(8, "0") + (h2 >>> 0).toString(16).padStart(8, "0");
+}
+function parseDim(svg, attr) {
+  const re = new RegExp(`<svg[^>]*\\s${attr}="(\\d+(?:\\.\\d+)?)`, "i");
+  const m = svg.match(re);
+  if (m) return Math.max(1, Math.round(parseFloat(m[1])));
+  const vb = svg.match(/viewBox="([\d.\s-]+)"/i);
+  if (vb) {
+    const parts = vb[1].trim().split(/\s+/).map(parseFloat);
+    if (parts.length === 4) {
+      return Math.max(1, Math.round(attr === "width" ? parts[2] : parts[3]));
+    }
+  }
+  return attr === "width" ? DEFAULT_WIDTH : DEFAULT_HEIGHT;
+}
+function parseSvgDims(svg) {
+  return { width: parseDim(svg, "width"), height: parseDim(svg, "height") };
+}
+function svgToStampFile(svgString, fileId) {
+  const { width, height } = parseSvgDims(svgString);
+  const utf8 = unescape(encodeURIComponent(svgString));
+  const base64 = typeof btoa !== "undefined" ? btoa(utf8) : Buffer.from(utf8, "binary").toString("base64");
+  return {
+    fileId,
+    dataURL: `data:image/svg+xml;base64,${base64}`,
+    mimeType: "image/svg+xml",
+    width,
+    height
+  };
+}
+async function createStampFile(svgString) {
+  const fileId = await hashSvgToFileId(svgString);
+  return svgToStampFile(svgString, fileId);
+}
+
+export { createStampFile, svgToStampFile };
+//# sourceMappingURL=chunk-5UTGXHLJ.mjs.map
+//# sourceMappingURL=chunk-5UTGXHLJ.mjs.map

package/dist/chunk-5UTGXHLJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/stamps/shared/svgToStampFile.ts"],"names":[],"mappings":";AAWA,IAAM,aAAA,GAAgB,GAAA;AACtB,IAAM,cAAA,GAAiB,GAAA;AAUvB,eAAe,gBAAgB,KAAA,EAAgC;AAC7D,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,MAAA,CAAO,MAAA,EAAQ;AAClD,IAAA,MAAM,GAAA,GAAM,IAAI,WAAA,EAAY,CAAE,OAAO,KAAK,CAAA;AAC1C,IAAA,MAAM,SAAS,MAAM,MAAA,CAAO,MAAA,CAAO,MAAA,CAAO,WAAW,GAAG,CAAA;AACxD,IAAA,OAAO,KAAA,CAAM,IAAA,CAAK,IAAI,UAAA,CAAW,MAAM,CAAC,CAAA,CACrC,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,CACX,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,GAAG,GAAG,CAAC,CAAA,CAC1C,IAAA,CAAK,EAAE,CAAA;AAAA,EACZ;AAEA,EAAA,IAAI,EAAA,GAAK,UAAA;AACT,EAAA,IAAI,EAAA,GAAK,UAAA;AACT,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACrC,IAAA,MAAM,CAAA,GAAI,KAAA,CAAM,UAAA,CAAW,CAAC,CAAA;AAC5B,IAAA,EAAA,IAAM,CAAA;AACN,IAAA,EAAA,GAAK,IAAA,CAAK,IAAA,CAAK,EAAA,EAAI,QAAU,CAAA;AAC7B,IAAA,EAAA,IAAM,CAAA,GAAI,CAAA;AACV,IAAA,EAAA,GAAK,IAAA,CAAK,IAAA,CAAK,EAAA,EAAI,aAAA,GAAgB,UAAU,CAAA;AAAA,EAC/C;AACA,EAAA,OAAA,CACG,OAAO,CAAA,EAAG,QAAA,CAAS,EAAE,CAAA,CAAE,SAAS,CAAA,EAAG,GAAG,CAAA,GAAA,CACtC,EAAA,KAAO,GAAG,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,GAAG,GAAG,CAAA;AAE3C;AAEA,SAAS,QAAA,CAAS,KAAa,IAAA,EAAkC;AAC/D,EAAA,MAAM,KAAK,IAAI,MAAA,CAAO,CAAA,YAAA,EAAe,IAAI,wBAAwB,GAAG,CAAA;AACpE,EAAA,MAAM,CAAA,GAAI,GAAA,CAAI,KAAA,CAAM,EAAE,CAAA;AACtB,EAAA,IAAI,CAAA,EAAG,OAAO,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,KAAA,CAAM,UAAA,CAAW,CAAA,CAAE,CAAC,CAAC,CAAC,CAAC,CAAA;AACtD,EAAA,MAAM,EAAA,GAAK,GAAA,CAAI,KAAA,CAAM,wBAAwB,CAAA;AAC7C,EAAA,IAAI,EAAA,EAAI;AACN,IAAA,MAAM,KAAA,GAAQ,EAAA,CAAG,CAAC,CAAA,CAAE,IAAA,GAAO,KAAA,CAAM,KAAK,CAAA,CAAE,GAAA,CAAI,UAAU,CAAA;AACtD,IAAA,IAAI,KAAA,CAAM,WAAW,CAAA,EAAG;AACtB,MAAA,OAAO,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,KAAA,CAAM,IAAA,KAAS,OAAA,GAAU,KAAA,CAAM,CAAC,CAAA,GAAI,KAAA,CAAM,CAAC,CAAC,CAAC,CAAA;AAAA,IACvE;AAAA,EACF;AACA,EAAA,OAAO,IAAA,KAAS,UAAU,aAAA,GAAgB,cAAA;AAC5C;AAEO,SAAS,aAAa,GAAA,EAAgD;AAC3E,EAAA,OAAO,EAAE,KAAA,EAAO,QAAA,CAAS,GAAA,EAAK,OAAO,GAAG,MAAA,EAAQ,QAAA,CAAS,GAAA,EAAK,QAAQ,CAAA,EAAE;AAC1E;AAEO,SAAS,cAAA,CAAe,WAAmB,MAAA,EAAiC;AACjF,EAAA,MAAM,EAAE,KAAA,EAAO,MAAA,EAAO,GAAI,aAAa,SAAS,CAAA;AAChD,EAAA,MAAM,IAAA,GAAO,QAAA,CAAS,kBAAA,CAAmB,SAAS,CAAC,CAAA;AACnD,EAAA,MAAM,MAAA,GAAS,OAAO,IAAA,KAAS,WAAA,GAC3B,IAAA,CAAK,IAAI,CAAA,GACT,MAAA,CAAO,IAAA,CAAK,IAAA,EAAM,QAAQ,CAAA,CAAE,SAAS,QAAQ,CAAA;AACjD,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,OAAA,EAAS,6BAA6B,MAAM,CAAA,CAAA;AAAA,IAC5C,QAAA,EAAU,eAAA;AAAA,IACV,KAAA;AAAA,IACA;AAAA,GACF;AACF;AAIA,eAAsB,gBAAgB,SAAA,EAA6C;AACjF,EAAA,MAAM,MAAA,GAAS,MAAM,eAAA,CAAgB,SAAS,CAAA;AAC9C,EAAA,OAAO,cAAA,CAAe,WAAW,MAAM,CAAA;AACzC","file":"chunk-5UTGXHLJ.mjs","sourcesContent":["// SVG inline base64 helper dùng chung cho 3 stamp (geometry-2d, geometry-3d,\n// graph-2d):\n//\n// - `svgToStampFile(svg, fileId)` — sync, dùng cho `restoreFileFromCustomData`\n//   khi caller đã có fileId từ element.\n// - `createStampFile(svg)` — async, dùng cho insert path khi cần generate\n//   fileId mới từ hash SVG content.\n//\n// Output luôn là SVG inline base64 — Excalidraw render native + tự đảo màu\n// trong dark mode qua CSS filter. KHÔNG raster sang PNG.\n\nconst DEFAULT_WIDTH = 200;\nconst DEFAULT_HEIGHT = 100;\n\nexport interface StampFileResult {\n  fileId: string;\n  dataURL: string;\n  mimeType: 'image/svg+xml';\n  width: number;\n  height: number;\n}\n\nasync function hashSvgToFileId(input: string): Promise<string> {\n  if (typeof crypto !== 'undefined' && crypto.subtle) {\n    const buf = new TextEncoder().encode(input);\n    const digest = await crypto.subtle.digest('SHA-256', buf);\n    return Array.from(new Uint8Array(digest))\n      .slice(0, 16)\n      .map((b) => b.toString(16).padStart(2, '0'))\n      .join('');\n  }\n  // Double-hash FNV-1a (32-bit chained) → 16 hex chars. Fallback Node/jsdom.\n  let h1 = 0x811c9dc5;\n  let h2 = 0xcbf29ce4;\n  for (let i = 0; i < input.length; i++) {\n    const c = input.charCodeAt(i);\n    h1 ^= c;\n    h1 = Math.imul(h1, 0x01000193);\n    h2 ^= c + i;\n    h2 = Math.imul(h2, 0x100000001b3 & 0xffffffff);\n  }\n  return (\n    (h1 >>> 0).toString(16).padStart(8, '0') +\n    (h2 >>> 0).toString(16).padStart(8, '0')\n  );\n}\n\nfunction parseDim(svg: string, attr: 'width' | 'height'): number {\n  const re = new RegExp(`<svg[^>]*\\\\s${attr}=\"(\\\\d+(?:\\\\.\\\\d+)?)`, 'i');\n  const m = svg.match(re);\n  if (m) return Math.max(1, Math.round(parseFloat(m[1])));\n  const vb = svg.match(/viewBox=\"([\\d.\\s-]+)\"/i);\n  if (vb) {\n    const parts = vb[1].trim().split(/\\s+/).map(parseFloat);\n    if (parts.length === 4) {\n      return Math.max(1, Math.round(attr === 'width' ? parts[2] : parts[3]));\n    }\n  }\n  return attr === 'width' ? DEFAULT_WIDTH : DEFAULT_HEIGHT;\n}\n\nexport function parseSvgDims(svg: string): { width: number; height: number } {\n  return { width: parseDim(svg, 'width'), height: parseDim(svg, 'height') };\n}\n\nexport function svgToStampFile(svgString: string, fileId: string): StampFileResult {\n  const { width, height } = parseSvgDims(svgString);\n  const utf8 = unescape(encodeURIComponent(svgString));\n  const base64 = typeof btoa !== 'undefined'\n    ? btoa(utf8)\n    : Buffer.from(utf8, 'binary').toString('base64');\n  return {\n    fileId,\n    dataURL: `data:image/svg+xml;base64,${base64}`,\n    mimeType: 'image/svg+xml',\n    width,\n    height,\n  };\n}\n\n// Async variant cho insert path: hash SVG → fileId rồi gọi svgToStampFile.\n// Identical SVG content → identical fileId (Excalidraw addFiles dedupe).\nexport async function createStampFile(svgString: string): Promise<StampFileResult> {\n  const fileId = await hashSvgToFileId(svgString);\n  return svgToStampFile(svgString, fileId);\n}\n"]}