@xom11/whiteboard 0.24.2 → 0.25.0

package/dist/latex.d.mts

@@ -1,7 +1,7 @@
-import { B as BaseStampCustomData, S as StampType } from './types-vtvyKGAA.mjs';
+import { B as BaseStampCustomData, S as StampType } from './types-DWRyCa2m.mjs';
+import 'zod';
 import 'react';
 import '@excalidraw/excalidraw/element/types';
-import './types-DxlMPh-6.mjs';
 
 interface LatexCustomData extends BaseStampCustomData {
     kind: 'latex';

package/dist/latex.d.ts

@@ -1,7 +1,7 @@
-import { B as BaseStampCustomData, S as StampType } from './types-Crbefnfe.js';
+import { B as BaseStampCustomData, S as StampType } from './types-DWRyCa2m.js';
+import 'zod';
 import 'react';
 import '@excalidraw/excalidraw/element/types';
-import './types-DxlMPh-6.js';
 
 interface LatexCustomData extends BaseStampCustomData {
     kind: 'latex';

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-JAVOU22E.mjs.map → serialize-SRJVKYUG.mjs.map}

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

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

@@ -1,6 +1,174 @@
+import { z } from 'zod';
 import { ReactNode, ComponentType, RefAttributes } from 'react';
 import { ExcalidrawElement } from '@excalidraw/excalidraw/element/types';
-import { S as State } from './types-DxlMPh-6.mjs';
+
+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;
+    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 = {
@@ -10,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 để
@@ -125,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 };
+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-Crbefnfe.d.ts → types-DWRyCa2m.d.ts}

@@ -1,6 +1,174 @@
+import { z } from 'zod';
 import { ReactNode, ComponentType, RefAttributes } from 'react';
 import { ExcalidrawElement } from '@excalidraw/excalidraw/element/types';
-import { S as State } from './types-DxlMPh-6.js';
+
+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;
+    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 = {
@@ -10,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 để
@@ -125,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 };
+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.2",
+  "version": "0.25.0",
   "private": false,
   "description": "Excalidraw + JSXGraph + KaTeX whiteboard component (drawing, geometry stamps, LaTeX stamps).",
   "repository": {