@xom11/whiteboard 0.24.1 → 0.24.2

package/README.md

@@ -88,7 +88,7 @@ export function ClassroomBoard() {
 Ví dụ route phía server trong Next.js:
 
 ```ts
-import { generateFigure } from '@xom11/whiteboard';
+import { generateFigure } from '@xom11/whiteboard/ai';
 
 export async function POST(request: Request) {
   const { problem } = await request.json();

package/dist/ai.d.mts

@@ -0,0 +1,616 @@
+import { S as State } from './types-DxlMPh-6.mjs';
+import { z } from 'zod';
+
+declare const DslInput: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    points: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"free">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        kind: "free";
+        name: string;
+        x: number;
+        y: number;
+    }, {
+        kind: "free";
+        name: string;
+        x: number;
+        y: number;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"midpoint">;
+        p1: z.ZodString;
+        p2: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "midpoint";
+        name: string;
+        p1: string;
+        p2: string;
+    }, {
+        kind: "midpoint";
+        name: string;
+        p1: string;
+        p2: string;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"onSegment">;
+        segmentId: z.ZodString;
+        t: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        kind: "onSegment";
+        name: string;
+        segmentId: string;
+        t: number;
+    }, {
+        kind: "onSegment";
+        name: string;
+        segmentId: string;
+        t: number;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"onLine">;
+        lineId: z.ZodString;
+        t: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        kind: "onLine";
+        name: string;
+        t: number;
+        lineId: string;
+    }, {
+        kind: "onLine";
+        name: string;
+        t: number;
+        lineId: string;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"onCircle">;
+        circleId: z.ZodString;
+        theta: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        kind: "onCircle";
+        name: string;
+        circleId: string;
+        theta: number;
+    }, {
+        kind: "onCircle";
+        name: string;
+        circleId: string;
+        theta: number;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"perpFoot">;
+        from: z.ZodString;
+        onLine: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "perpFoot";
+        name: string;
+        onLine: string;
+        from: string;
+    }, {
+        kind: "perpFoot";
+        name: string;
+        onLine: string;
+        from: string;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"circumcenter">;
+        vertices: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "circumcenter";
+        name: string;
+        vertices: [string, string, string];
+    }, {
+        kind: "circumcenter";
+        name: string;
+        vertices: [string, string, string];
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"incenter">;
+        vertices: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "incenter";
+        name: string;
+        vertices: [string, string, string];
+    }, {
+        kind: "incenter";
+        name: string;
+        vertices: [string, string, string];
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"centroid">;
+        vertices: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "centroid";
+        name: string;
+        vertices: [string, string, string];
+    }, {
+        kind: "centroid";
+        name: string;
+        vertices: [string, string, string];
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"orthocenter">;
+        vertices: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "orthocenter";
+        name: string;
+        vertices: [string, string, string];
+    }, {
+        kind: "orthocenter";
+        name: string;
+        vertices: [string, string, string];
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"intersection">;
+        ref1: z.ZodString;
+        ref2: z.ZodString;
+        branch: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "intersection";
+        name: string;
+        ref1: string;
+        ref2: string;
+        branch?: 0 | 1 | undefined;
+    }, {
+        kind: "intersection";
+        name: string;
+        ref1: string;
+        ref2: string;
+        branch?: 0 | 1 | undefined;
+    }>]>, "many">;
+    shapes: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"segment">;
+        p1: z.ZodString;
+        p2: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "segment";
+        name: string;
+        p1: string;
+        p2: string;
+    }, {
+        kind: "segment";
+        name: string;
+        p1: string;
+        p2: string;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"line">;
+        p1: z.ZodString;
+        p2: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "line";
+        name: string;
+        p1: string;
+        p2: string;
+    }, {
+        kind: "line";
+        name: string;
+        p1: string;
+        p2: string;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"ray">;
+        origin: z.ZodString;
+        through: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "ray";
+        name: string;
+        origin: string;
+        through: string;
+    }, {
+        kind: "ray";
+        name: string;
+        origin: string;
+        through: string;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"polygon">;
+        vertices: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        kind: "polygon";
+        name: string;
+        vertices: string[];
+    }, {
+        kind: "polygon";
+        name: string;
+        vertices: string[];
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"perpendicular">;
+        throughPoint: z.ZodString;
+        toLine: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "perpendicular";
+        name: string;
+        throughPoint: string;
+        toLine: string;
+    }, {
+        kind: "perpendicular";
+        name: string;
+        throughPoint: string;
+        toLine: string;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"parallel">;
+        throughPoint: z.ZodString;
+        toLine: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "parallel";
+        name: string;
+        throughPoint: string;
+        toLine: string;
+    }, {
+        kind: "parallel";
+        name: string;
+        throughPoint: string;
+        toLine: string;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"perpBisector">;
+        p1: z.ZodString;
+        p2: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "perpBisector";
+        name: string;
+        p1: string;
+        p2: string;
+    }, {
+        kind: "perpBisector";
+        name: string;
+        p1: string;
+        p2: string;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"angleBisector">;
+        p1: z.ZodString;
+        vertex: z.ZodString;
+        p2: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "angleBisector";
+        name: string;
+        p1: string;
+        p2: string;
+        vertex: string;
+    }, {
+        kind: "angleBisector";
+        name: string;
+        p1: string;
+        p2: string;
+        vertex: string;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"tangent">;
+        throughPoint: z.ZodString;
+        toCircle: z.ZodString;
+        branch: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<"on">]>>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "tangent";
+        name: string;
+        throughPoint: string;
+        toCircle: string;
+        branch?: 0 | 1 | "on" | undefined;
+    }, {
+        kind: "tangent";
+        name: string;
+        throughPoint: string;
+        toCircle: string;
+        branch?: 0 | 1 | "on" | undefined;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"circleCP">;
+        center: z.ZodString;
+        surfacePoint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "circleCP";
+        name: string;
+        center: string;
+        surfacePoint: string;
+    }, {
+        kind: "circleCP";
+        name: string;
+        center: string;
+        surfacePoint: string;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodLiteral<"circle3">;
+        p1: z.ZodString;
+        p2: z.ZodString;
+        p3: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "circle3";
+        name: string;
+        p1: string;
+        p2: string;
+        p3: string;
+    }, {
+        kind: "circle3";
+        name: string;
+        p1: string;
+        p2: string;
+        p3: string;
+    }>]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    points: ({
+        kind: "free";
+        name: string;
+        x: number;
+        y: number;
+    } | {
+        kind: "midpoint";
+        name: string;
+        p1: string;
+        p2: string;
+    } | {
+        kind: "onSegment";
+        name: string;
+        segmentId: string;
+        t: number;
+    } | {
+        kind: "onLine";
+        name: string;
+        t: number;
+        lineId: string;
+    } | {
+        kind: "onCircle";
+        name: string;
+        circleId: string;
+        theta: number;
+    } | {
+        kind: "perpFoot";
+        name: string;
+        onLine: string;
+        from: string;
+    } | {
+        kind: "circumcenter";
+        name: string;
+        vertices: [string, string, string];
+    } | {
+        kind: "incenter";
+        name: string;
+        vertices: [string, string, string];
+    } | {
+        kind: "centroid";
+        name: string;
+        vertices: [string, string, string];
+    } | {
+        kind: "orthocenter";
+        name: string;
+        vertices: [string, string, string];
+    } | {
+        kind: "intersection";
+        name: string;
+        ref1: string;
+        ref2: string;
+        branch?: 0 | 1 | undefined;
+    })[];
+    shapes: ({
+        kind: "segment";
+        name: string;
+        p1: string;
+        p2: string;
+    } | {
+        kind: "line";
+        name: string;
+        p1: string;
+        p2: string;
+    } | {
+        kind: "ray";
+        name: string;
+        origin: string;
+        through: string;
+    } | {
+        kind: "polygon";
+        name: string;
+        vertices: string[];
+    } | {
+        kind: "perpendicular";
+        name: string;
+        throughPoint: string;
+        toLine: string;
+    } | {
+        kind: "parallel";
+        name: string;
+        throughPoint: string;
+        toLine: string;
+    } | {
+        kind: "perpBisector";
+        name: string;
+        p1: string;
+        p2: string;
+    } | {
+        kind: "angleBisector";
+        name: string;
+        p1: string;
+        p2: string;
+        vertex: string;
+    } | {
+        kind: "tangent";
+        name: string;
+        throughPoint: string;
+        toCircle: string;
+        branch?: 0 | 1 | "on" | undefined;
+    } | {
+        kind: "circleCP";
+        name: string;
+        center: string;
+        surfacePoint: string;
+    } | {
+        kind: "circle3";
+        name: string;
+        p1: string;
+        p2: string;
+        p3: string;
+    })[];
+}, {
+    version: 1;
+    points: ({
+        kind: "free";
+        name: string;
+        x: number;
+        y: number;
+    } | {
+        kind: "midpoint";
+        name: string;
+        p1: string;
+        p2: string;
+    } | {
+        kind: "onSegment";
+        name: string;
+        segmentId: string;
+        t: number;
+    } | {
+        kind: "onLine";
+        name: string;
+        t: number;
+        lineId: string;
+    } | {
+        kind: "onCircle";
+        name: string;
+        circleId: string;
+        theta: number;
+    } | {
+        kind: "perpFoot";
+        name: string;
+        onLine: string;
+        from: string;
+    } | {
+        kind: "circumcenter";
+        name: string;
+        vertices: [string, string, string];
+    } | {
+        kind: "incenter";
+        name: string;
+        vertices: [string, string, string];
+    } | {
+        kind: "centroid";
+        name: string;
+        vertices: [string, string, string];
+    } | {
+        kind: "orthocenter";
+        name: string;
+        vertices: [string, string, string];
+    } | {
+        kind: "intersection";
+        name: string;
+        ref1: string;
+        ref2: string;
+        branch?: 0 | 1 | undefined;
+    })[];
+    shapes?: ({
+        kind: "segment";
+        name: string;
+        p1: string;
+        p2: string;
+    } | {
+        kind: "line";
+        name: string;
+        p1: string;
+        p2: string;
+    } | {
+        kind: "ray";
+        name: string;
+        origin: string;
+        through: string;
+    } | {
+        kind: "polygon";
+        name: string;
+        vertices: string[];
+    } | {
+        kind: "perpendicular";
+        name: string;
+        throughPoint: string;
+        toLine: string;
+    } | {
+        kind: "parallel";
+        name: string;
+        throughPoint: string;
+        toLine: string;
+    } | {
+        kind: "perpBisector";
+        name: string;
+        p1: string;
+        p2: string;
+    } | {
+        kind: "angleBisector";
+        name: string;
+        p1: string;
+        p2: string;
+        vertex: string;
+    } | {
+        kind: "tangent";
+        name: string;
+        throughPoint: string;
+        toCircle: string;
+        branch?: 0 | 1 | "on" | undefined;
+    } | {
+        kind: "circleCP";
+        name: string;
+        center: string;
+        surfacePoint: string;
+    } | {
+        kind: "circle3";
+        name: string;
+        p1: string;
+        p2: string;
+        p3: string;
+    })[] | undefined;
+}>;
+type DslInputT = z.infer<typeof DslInput>;
+
+type TranspileErrorCode = 'SCHEMA' | 'DUPLICATE_NAME' | 'UNKNOWN_REF' | 'KIND_MISMATCH' | 'CYCLE';
+interface TranspileError {
+    code: TranspileErrorCode;
+    message: string;
+    path?: string[];
+    hint?: string;
+}
+
+interface GenerateOptions {
+    apiKey: string;
+    model?: string;
+    maxTokens?: number;
+    enableCaching?: boolean;
+    signal?: AbortSignal;
+}
+interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheCreationTokens: number;
+}
+type GenerateResult = {
+    ok: true;
+    state: State;
+    dsl: DslInputT;
+    usage: TokenUsage;
+} | {
+    ok: false;
+    reason: 'refused';
+    message: string;
+    usage?: TokenUsage;
+} | {
+    ok: false;
+    reason: 'parse_error';
+    message: string;
+    raw?: unknown;
+    usage?: TokenUsage;
+} | {
+    ok: false;
+    reason: 'transpile_error';
+    message: string;
+    errors: TranspileError[];
+    dsl: unknown;
+    usage?: TokenUsage;
+} | {
+    ok: false;
+    reason: 'api_error';
+    message: string;
+    status?: number;
+};
+declare function generateFigure(problem: string, opts: GenerateOptions): Promise<GenerateResult>;
+
+export { type GenerateOptions, type GenerateResult, type TokenUsage, generateFigure };