@xom11/whiteboard 0.24.1 → 0.25.0

package/dist/latex.d.mts

@@ -1,4 +1,5 @@
-import { B as BaseStampCustomData, S as StampType } from './types-rA4slL08.mjs';
+import { B as BaseStampCustomData, S as StampType } from './types-DWRyCa2m.mjs';
+import 'zod';
 import 'react';
 import '@excalidraw/excalidraw/element/types';
 

package/dist/latex.d.ts

@@ -1,4 +1,5 @@
-import { B as BaseStampCustomData, S as StampType } from './types-rA4slL08.js';
+import { B as BaseStampCustomData, S as StampType } from './types-DWRyCa2m.js';
+import 'zod';
 import 'react';
 import '@excalidraw/excalidraw/element/types';
 

package/dist/render-3WTY7NZB.mjs

@@ -0,0 +1,9 @@
+"use client";
+export { renderGraphSvgFromState } from './chunk-CJBLJUWG.mjs';
+import './chunk-M42TGYT6.mjs';
+import './chunk-AYSFWUPK.mjs';
+import './chunk-ICR4CVOE.mjs';
+import './chunk-IHUFOV7L.mjs';
+import './chunk-B4NJJZFR.mjs';
+//# sourceMappingURL=render-3WTY7NZB.mjs.map
+//# sourceMappingURL=render-3WTY7NZB.mjs.map

package/dist/{render-SA4JTOW3.mjs.map → render-3WTY7NZB.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"render-SA4JTOW3.mjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"render-3WTY7NZB.mjs"}

package/dist/serialize-SRJVKYUG.mjs

@@ -0,0 +1,8 @@
+"use client";
+export { parseSceneState, stringifySceneState } from './chunk-I24QOHPU.mjs';
+import './chunk-REIJZDVZ.mjs';
+import './chunk-IHUFOV7L.mjs';
+import './chunk-73Q7ADVL.mjs';
+import './chunk-B4NJJZFR.mjs';
+//# sourceMappingURL=serialize-SRJVKYUG.mjs.map
+//# sourceMappingURL=serialize-SRJVKYUG.mjs.map

package/dist/{serialize-3NZS6A6Q.mjs.map → serialize-SRJVKYUG.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"serialize-3NZS6A6Q.mjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"serialize-SRJVKYUG.mjs"}

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

@@ -1,6 +1,127 @@
+import { z } from 'zod';
 import { ReactNode, ComponentType, RefAttributes } from 'react';
 import { ExcalidrawElement } from '@excalidraw/excalidraw/element/types';
 
+declare const NameZ: z.ZodString;
+
+type Name = z.infer<typeof NameZ>;
+type DslPointT = {
+    name: Name;
+    kind: 'free';
+    x: number;
+    y: number;
+} | {
+    name: Name;
+    kind: 'midpoint';
+    p1: Name;
+    p2: Name;
+} | {
+    name: Name;
+    kind: 'onSegment';
+    segmentId: Name;
+    t: number;
+} | {
+    name: Name;
+    kind: 'onLine';
+    lineId: Name;
+    t: number;
+} | {
+    name: Name;
+    kind: 'onCircle';
+    circleId: Name;
+    theta: number;
+} | {
+    name: Name;
+    kind: 'perpFoot';
+    from: Name;
+    onLine: Name;
+} | {
+    name: Name;
+    kind: 'circumcenter';
+    vertices: [Name, Name, Name];
+} | {
+    name: Name;
+    kind: 'incenter';
+    vertices: [Name, Name, Name];
+} | {
+    name: Name;
+    kind: 'centroid';
+    vertices: [Name, Name, Name];
+} | {
+    name: Name;
+    kind: 'orthocenter';
+    vertices: [Name, Name, Name];
+} | {
+    name: Name;
+    kind: 'intersection';
+    ref1: Name;
+    ref2: Name;
+    branch?: 0 | 1;
+};
+type DslShapeT = {
+    name: Name;
+    kind: 'segment';
+    p1: Name;
+    p2: Name;
+} | {
+    name: Name;
+    kind: 'line';
+    p1: Name;
+    p2: Name;
+} | {
+    name: Name;
+    kind: 'ray';
+    origin: Name;
+    through: Name;
+} | {
+    name: Name;
+    kind: 'polygon';
+    vertices: Name[];
+} | {
+    name: Name;
+    kind: 'perpendicular';
+    throughPoint: Name;
+    toLine: Name;
+} | {
+    name: Name;
+    kind: 'parallel';
+    throughPoint: Name;
+    toLine: Name;
+} | {
+    name: Name;
+    kind: 'perpBisector';
+    p1: Name;
+    p2: Name;
+} | {
+    name: Name;
+    kind: 'angleBisector';
+    p1: Name;
+    vertex: Name;
+    p2: Name;
+} | {
+    name: Name;
+    kind: 'tangent';
+    throughPoint: Name;
+    toCircle: Name;
+    branch?: 0 | 1 | 'on';
+} | {
+    name: Name;
+    kind: 'circleCP';
+    center: Name;
+    surfacePoint: Name;
+} | {
+    name: Name;
+    kind: 'circle3';
+    p1: Name;
+    p2: Name;
+    p3: Name;
+};
+type DslInputT = {
+    version: 1;
+    points: DslPointT[];
+    shapes: DslShapeT[];
+};
+
 type SceneObject<A = Record<string, unknown>> = {
     id: string;
     kind: string;
@@ -57,12 +178,29 @@ type AiFigureUiResult = {
     ok: false;
     message: string;
 };
+/**
+ * Progress event emitted bởi streaming generator. Số token output đã sinh.
+ * Editor dùng để hiển thị "Đang nhận N token..." realtime.
+ */
+interface AiFigureProgress {
+    /** Số token output đã sinh tính đến lúc emit. */
+    tokens: number;
+}
 /**
  * Consumer-provided bridge to a server-side `generateFigure()` call.
  * Implementations must keep API credentials outside the browser bundle.
+ *
+ * `onProgress` là optional: nếu consumer dùng streaming endpoint (SSE),
+ * forward chunk events vào đây. Non-streaming impl bỏ qua.
+ *
+ * `currentDsl` (MỚI cho multi-step refine): khi caller có hình hiện tại
+ * (state.order.length > 0) và muốn AI sửa/thêm → pass currentDsl. Consumer
+ * branch sang refine endpoint. Không pass → build endpoint cũ.
  */
 type GenerateGeometryFigure = (problem: string, options: {
     signal: AbortSignal;
+    onProgress?: (info: AiFigureProgress) => void;
+    currentDsl?: DslInputT;
 }) => Promise<AiFigureUiResult>;
 /**
  * Kết quả trả về từ `restoreFileFromCustomData`. Chứa đủ thông tin để
@@ -172,4 +310,4 @@ interface StampType<TCustomData extends BaseStampCustomData = BaseStampCustomDat
     experimental?: boolean;
 }
 
-export type { AiFigureUiResult as A, BaseStampCustomData as B, GenerateGeometryFigure as G, StampType as S, State as a };
+export type { AiFigureProgress as A, BaseStampCustomData as B, DslInputT as D, GenerateGeometryFigure as G, StampType as S, AiFigureUiResult as a, State as b };

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

@@ -1,6 +1,127 @@
+import { z } from 'zod';
 import { ReactNode, ComponentType, RefAttributes } from 'react';
 import { ExcalidrawElement } from '@excalidraw/excalidraw/element/types';
 
+declare const NameZ: z.ZodString;
+
+type Name = z.infer<typeof NameZ>;
+type DslPointT = {
+    name: Name;
+    kind: 'free';
+    x: number;
+    y: number;
+} | {
+    name: Name;
+    kind: 'midpoint';
+    p1: Name;
+    p2: Name;
+} | {
+    name: Name;
+    kind: 'onSegment';
+    segmentId: Name;
+    t: number;
+} | {
+    name: Name;
+    kind: 'onLine';
+    lineId: Name;
+    t: number;
+} | {
+    name: Name;
+    kind: 'onCircle';
+    circleId: Name;
+    theta: number;
+} | {
+    name: Name;
+    kind: 'perpFoot';
+    from: Name;
+    onLine: Name;
+} | {
+    name: Name;
+    kind: 'circumcenter';
+    vertices: [Name, Name, Name];
+} | {
+    name: Name;
+    kind: 'incenter';
+    vertices: [Name, Name, Name];
+} | {
+    name: Name;
+    kind: 'centroid';
+    vertices: [Name, Name, Name];
+} | {
+    name: Name;
+    kind: 'orthocenter';
+    vertices: [Name, Name, Name];
+} | {
+    name: Name;
+    kind: 'intersection';
+    ref1: Name;
+    ref2: Name;
+    branch?: 0 | 1;
+};
+type DslShapeT = {
+    name: Name;
+    kind: 'segment';
+    p1: Name;
+    p2: Name;
+} | {
+    name: Name;
+    kind: 'line';
+    p1: Name;
+    p2: Name;
+} | {
+    name: Name;
+    kind: 'ray';
+    origin: Name;
+    through: Name;
+} | {
+    name: Name;
+    kind: 'polygon';
+    vertices: Name[];
+} | {
+    name: Name;
+    kind: 'perpendicular';
+    throughPoint: Name;
+    toLine: Name;
+} | {
+    name: Name;
+    kind: 'parallel';
+    throughPoint: Name;
+    toLine: Name;
+} | {
+    name: Name;
+    kind: 'perpBisector';
+    p1: Name;
+    p2: Name;
+} | {
+    name: Name;
+    kind: 'angleBisector';
+    p1: Name;
+    vertex: Name;
+    p2: Name;
+} | {
+    name: Name;
+    kind: 'tangent';
+    throughPoint: Name;
+    toCircle: Name;
+    branch?: 0 | 1 | 'on';
+} | {
+    name: Name;
+    kind: 'circleCP';
+    center: Name;
+    surfacePoint: Name;
+} | {
+    name: Name;
+    kind: 'circle3';
+    p1: Name;
+    p2: Name;
+    p3: Name;
+};
+type DslInputT = {
+    version: 1;
+    points: DslPointT[];
+    shapes: DslShapeT[];
+};
+
 type SceneObject<A = Record<string, unknown>> = {
     id: string;
     kind: string;
@@ -57,12 +178,29 @@ type AiFigureUiResult = {
     ok: false;
     message: string;
 };
+/**
+ * Progress event emitted bởi streaming generator. Số token output đã sinh.
+ * Editor dùng để hiển thị "Đang nhận N token..." realtime.
+ */
+interface AiFigureProgress {
+    /** Số token output đã sinh tính đến lúc emit. */
+    tokens: number;
+}
 /**
  * Consumer-provided bridge to a server-side `generateFigure()` call.
  * Implementations must keep API credentials outside the browser bundle.
+ *
+ * `onProgress` là optional: nếu consumer dùng streaming endpoint (SSE),
+ * forward chunk events vào đây. Non-streaming impl bỏ qua.
+ *
+ * `currentDsl` (MỚI cho multi-step refine): khi caller có hình hiện tại
+ * (state.order.length > 0) và muốn AI sửa/thêm → pass currentDsl. Consumer
+ * branch sang refine endpoint. Không pass → build endpoint cũ.
  */
 type GenerateGeometryFigure = (problem: string, options: {
     signal: AbortSignal;
+    onProgress?: (info: AiFigureProgress) => void;
+    currentDsl?: DslInputT;
 }) => Promise<AiFigureUiResult>;
 /**
  * Kết quả trả về từ `restoreFileFromCustomData`. Chứa đủ thông tin để
@@ -172,4 +310,4 @@ interface StampType<TCustomData extends BaseStampCustomData = BaseStampCustomDat
     experimental?: boolean;
 }
 
-export type { AiFigureUiResult as A, BaseStampCustomData as B, GenerateGeometryFigure as G, StampType as S, State as a };
+export type { AiFigureProgress as A, BaseStampCustomData as B, DslInputT as D, GenerateGeometryFigure as G, StampType as S, AiFigureUiResult as a, State as b };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xom11/whiteboard",
-  "version": "0.24.1",
+  "version": "0.25.0",
   "private": false,
   "description": "Excalidraw + JSXGraph + KaTeX whiteboard component (drawing, geometry stamps, LaTeX stamps).",
   "repository": {
@@ -41,6 +41,11 @@
       "import": "./dist/graph-2d.mjs",
       "require": "./dist/graph-2d.js"
     },
+    "./ai": {
+      "types": "./dist/ai.d.ts",
+      "import": "./dist/ai.mjs",
+      "require": "./dist/ai.js"
+    },
     "./styles.css": "./dist/index.css"
   },
   "files": [