@nativemason/contracts 0.0.0-stage → 0.3.0

package/dist/design.d.ts

@@ -0,0 +1,304 @@
+import { z } from 'zod';
+/** Each nested Figma node is validated independently by the bounded importer. */
+export declare const FigmaNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    absoluteBoundingBox: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>>;
+    layoutMode: z.ZodOptional<z.ZodEnum<{
+        NONE: "NONE";
+        HORIZONTAL: "HORIZONTAL";
+        VERTICAL: "VERTICAL";
+    }>>;
+    itemSpacing: z.ZodOptional<z.ZodNumber>;
+    counterAxisAlignItems: z.ZodOptional<z.ZodEnum<{
+        MIN: "MIN";
+        CENTER: "CENTER";
+        MAX: "MAX";
+        BASELINE: "BASELINE";
+    }>>;
+    children: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$loose>;
+export type FigmaNode = z.infer<typeof FigmaNodeSchema>;
+export declare const DesignIntentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"figma-auto-layout">;
+    frame: z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        absoluteBoundingBox: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>>;
+        layoutMode: z.ZodOptional<z.ZodEnum<{
+            NONE: "NONE";
+            HORIZONTAL: "HORIZONTAL";
+            VERTICAL: "VERTICAL";
+        }>>;
+        itemSpacing: z.ZodOptional<z.ZodNumber>;
+        counterAxisAlignItems: z.ZodOptional<z.ZodEnum<{
+            MIN: "MIN";
+            CENTER: "CENTER";
+            MAX: "MAX";
+            BASELINE: "BASELINE";
+        }>>;
+        children: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$loose>;
+    elementMap: z.ZodRecord<z.ZodString, z.ZodString>;
+    logicalUnitsPerDesignUnit: z.ZodDefault<z.ZodNumber>;
+    scenarioId: z.ZodString;
+    profile: z.ZodObject<{
+        window: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        pixelRatio: z.ZodNumber;
+        fontScale: z.ZodNumber;
+        insets: z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+        }, z.core.$strict>;
+        root: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        orientation: z.ZodEnum<{
+            portrait: "portrait";
+            landscape: "landscape";
+        }>;
+    }, z.core.$strict>;
+    tolerance: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"reference-annotations">;
+    image: z.ZodObject<{
+        sha256: z.ZodString;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>;
+    appRootPixels: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>;
+    pixelsPerLogicalUnit: z.ZodNumber;
+    annotations: z.ZodArray<z.ZodObject<{
+        elementId: z.ZodString;
+        rectPixels: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    assertions: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"textFits">;
+        elementId: z.ZodString;
+        id: z.ZodString;
+        tolerance: z.ZodDefault<z.ZodNumber>;
+        pixelAware: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"rect">;
+        elementId: z.ZodString;
+        target: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        id: z.ZodString;
+        tolerance: z.ZodDefault<z.ZodNumber>;
+        pixelAware: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"minTouchTarget">;
+        elementId: z.ZodString;
+        width: z.ZodDefault<z.ZodNumber>;
+        height: z.ZodDefault<z.ZodNumber>;
+        id: z.ZodString;
+        tolerance: z.ZodDefault<z.ZodNumber>;
+        pixelAware: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"align">;
+        elementIds: z.ZodArray<z.ZodString>;
+        axis: z.ZodEnum<{
+            x: "x";
+            y: "y";
+        }>;
+        edge: z.ZodEnum<{
+            start: "start";
+            center: "center";
+            end: "end";
+        }>;
+        id: z.ZodString;
+        tolerance: z.ZodDefault<z.ZodNumber>;
+        pixelAware: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"gap">;
+        first: z.ZodString;
+        second: z.ZodString;
+        axis: z.ZodEnum<{
+            x: "x";
+            y: "y";
+        }>;
+        value: z.ZodNumber;
+        id: z.ZodString;
+        tolerance: z.ZodDefault<z.ZodNumber>;
+        pixelAware: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"insideSafeArea">;
+        elementId: z.ZodString;
+        id: z.ZodString;
+        tolerance: z.ZodDefault<z.ZodNumber>;
+        pixelAware: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"disjoint">;
+        first: z.ZodString;
+        second: z.ZodString;
+        id: z.ZodString;
+        tolerance: z.ZodDefault<z.ZodNumber>;
+        pixelAware: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>], "type">>>;
+    scenarioId: z.ZodString;
+    profile: z.ZodObject<{
+        window: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        pixelRatio: z.ZodNumber;
+        fontScale: z.ZodNumber;
+        insets: z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+        }, z.core.$strict>;
+        root: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        orientation: z.ZodEnum<{
+            portrait: "portrait";
+            landscape: "landscape";
+        }>;
+    }, z.core.$strict>;
+    tolerance: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>], "kind">;
+export type DesignIntent = z.infer<typeof DesignIntentSchema>;
+export declare const DesignIntentResultSchema: z.ZodObject<{
+    spec: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        scenarioId: z.ZodString;
+        profile: z.ZodObject<{
+            window: z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>;
+            pixelRatio: z.ZodNumber;
+            fontScale: z.ZodNumber;
+            insets: z.ZodObject<{
+                top: z.ZodNumber;
+                right: z.ZodNumber;
+                bottom: z.ZodNumber;
+                left: z.ZodNumber;
+            }, z.core.$strict>;
+            root: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>;
+            orientation: z.ZodEnum<{
+                portrait: "portrait";
+                landscape: "landscape";
+            }>;
+        }, z.core.$strict>;
+        requiredElementIds: z.ZodArray<z.ZodString>;
+        constraints: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"textFits">;
+            elementId: z.ZodString;
+            id: z.ZodString;
+            tolerance: z.ZodDefault<z.ZodNumber>;
+            pixelAware: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"rect">;
+            elementId: z.ZodString;
+            target: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>;
+            id: z.ZodString;
+            tolerance: z.ZodDefault<z.ZodNumber>;
+            pixelAware: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"minTouchTarget">;
+            elementId: z.ZodString;
+            width: z.ZodDefault<z.ZodNumber>;
+            height: z.ZodDefault<z.ZodNumber>;
+            id: z.ZodString;
+            tolerance: z.ZodDefault<z.ZodNumber>;
+            pixelAware: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"align">;
+            elementIds: z.ZodArray<z.ZodString>;
+            axis: z.ZodEnum<{
+                x: "x";
+                y: "y";
+            }>;
+            edge: z.ZodEnum<{
+                start: "start";
+                center: "center";
+                end: "end";
+            }>;
+            id: z.ZodString;
+            tolerance: z.ZodDefault<z.ZodNumber>;
+            pixelAware: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"gap">;
+            first: z.ZodString;
+            second: z.ZodString;
+            axis: z.ZodEnum<{
+                x: "x";
+                y: "y";
+            }>;
+            value: z.ZodNumber;
+            id: z.ZodString;
+            tolerance: z.ZodDefault<z.ZodNumber>;
+            pixelAware: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"insideSafeArea">;
+            elementId: z.ZodString;
+            id: z.ZodString;
+            tolerance: z.ZodDefault<z.ZodNumber>;
+            pixelAware: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"disjoint">;
+            first: z.ZodString;
+            second: z.ZodString;
+            id: z.ZodString;
+            tolerance: z.ZodDefault<z.ZodNumber>;
+            pixelAware: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>;
+    reviewRequired: z.ZodLiteral<true>;
+    source: z.ZodEnum<{
+        "figma-auto-layout": "figma-auto-layout";
+        "reference-annotations": "reference-annotations";
+    }>;
+    notes: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type DesignIntentResult = z.infer<typeof DesignIntentResultSchema>;

package/dist/design.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { DeviceProfileSchema, RectSchema } from './geometry.js';
+import { ConstraintSchema, WireframeSpecSchema } from './constraints.js';
+/** Each nested Figma node is validated independently by the bounded importer. */
+export const FigmaNodeSchema = z.object({
+    id: z.string().min(1), type: z.string(), name: z.string().optional(),
+    absoluteBoundingBox: RectSchema.optional(),
+    layoutMode: z.enum(['NONE', 'HORIZONTAL', 'VERTICAL']).optional(),
+    itemSpacing: z.number().finite().optional(),
+    counterAxisAlignItems: z.enum(['MIN', 'CENTER', 'MAX', 'BASELINE']).optional(),
+    children: z.array(z.unknown()).max(10000).optional(),
+}).passthrough();
+const common = { scenarioId: z.string().min(1), profile: DeviceProfileSchema, tolerance: z.number().finite().nonnegative().default(2) };
+export const DesignIntentSchema = z.discriminatedUnion('kind', [
+    z.object({ ...common, kind: z.literal('figma-auto-layout'), frame: FigmaNodeSchema,
+        elementMap: z.record(z.string(), z.string().min(1)),
+        logicalUnitsPerDesignUnit: z.number().finite().positive().default(1),
+    }).strict(),
+    z.object({ ...common, kind: z.literal('reference-annotations'),
+        image: z.object({ sha256: z.string().regex(/^[a-f0-9]{64}$/), width: z.number().finite().positive(), height: z.number().finite().positive() }).strict(),
+        appRootPixels: RectSchema, pixelsPerLogicalUnit: z.number().finite().positive(),
+        annotations: z.array(z.object({ elementId: z.string().min(1), rectPixels: RectSchema }).strict()).min(1).max(10000),
+        assertions: z.array(ConstraintSchema).default([]),
+    }).strict(),
+]);
+export const DesignIntentResultSchema = z.object({
+    spec: WireframeSpecSchema, reviewRequired: z.literal(true),
+    source: z.enum(['figma-auto-layout', 'reference-annotations']), notes: z.array(z.string()),
+}).strict();