@sxl-studio/bridge 1.7.2 → 1.8.0

package/dist/tools/schema-contracts.js

@@ -0,0 +1,814 @@
+import { z } from "zod";
+export const DESIGN_DSL_V1_SCHEMA_URI = "sxl://agent/schemas/design-dsl-v1";
+export const DOC_SPEC_V2_SCHEMA_URI = "sxl://agent/schemas/doc-spec-v2";
+export const TOKEN_DOC_SPEC_V1_SCHEMA_URI = "sxl://agent/schemas/token-doc-v1";
+export const CODE_CONNECT_CONTEXT_V1_SCHEMA_URI = "sxl://agent/schemas/code-connect-context-v1";
+export const CODE_CONNECT_TEMPLATE_V1_SCHEMA_URI = "sxl://agent/schemas/code-connect-template-v1";
+const propertyValueZod = z.union([z.string(), z.boolean()]);
+export const designDslPropertiesMapZod = z.record(z.string(), propertyValueZod);
+export const designDslTextOverrideZod = z.object({
+    layerName: z.string().min(1).describe("TEXT layer name inside the instance to receive `value`."),
+    value: z.string().describe("New characters to write into that TEXT layer."),
+});
+export const designDslFillBindingZod = z.object({
+    layerName: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Optional child-layer name to scope the binding. When omitted, the binding applies to the host node itself."),
+    variableId: z.string().min(1).describe("Figma Variable id (must resolve to COLOR)."),
+    paintIndex: z.number().int().min(0).optional().describe("Which existing fill index to bind. Default: 0."),
+});
+export const designDslSizingSpecZod = z.object({
+    mode: z.enum(["HUG", "FIXED", "FILL"]).optional(),
+    width: z.number().positive().optional(),
+    height: z.number().positive().optional(),
+});
+export const designDslPaddingSpecZod = z.union([
+    z.number().min(0),
+    z.object({
+        top: z.number().min(0).optional(),
+        right: z.number().min(0).optional(),
+        bottom: z.number().min(0).optional(),
+        left: z.number().min(0).optional(),
+    }),
+]);
+export const designDslLayoutBackgroundZod = z.union([
+    z.object({ hex: z.string().regex(/^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$/, "hex must be #rrggbb[aa]") }),
+    z.object({ variableId: z.string().min(1) }),
+]);
+export const designDslLayoutSpecZod = z.object({
+    mode: z.enum(["VERTICAL", "HORIZONTAL", "WRAP"]).optional(),
+    itemSpacing: z.number().min(0).optional(),
+    counterAxisSpacing: z.number().min(0).optional(),
+    padding: designDslPaddingSpecZod.optional(),
+    primaryAxis: z.enum(["MIN", "CENTER", "MAX", "SPACE_BETWEEN"]).optional(),
+    counterAxis: z.enum(["MIN", "CENTER", "MAX", "BASELINE"]).optional(),
+    width: z.number().positive().optional(),
+    height: z.number().positive().optional(),
+    background: designDslLayoutBackgroundZod.optional(),
+});
+export const designDslItemZod = z.lazy(() => z.discriminatedUnion("kind", [
+    z.object({
+        kind: z.literal("instance"),
+        componentId: z.string().min(1).optional(),
+        componentKey: z.string().min(1).optional(),
+        componentName: z.string().min(1).optional(),
+        name: z.string().optional().describe("Override the resulting instance.name."),
+        properties: designDslPropertiesMapZod.optional().describe("Component property overrides keyed by base name."),
+        textOverrides: z.array(designDslTextOverrideZod).optional(),
+        fillBindings: z.array(designDslFillBindingZod).optional(),
+        layoutSizing: designDslSizingSpecZod.optional(),
+        count: z.number().int().positive().max(500).optional().describe("Repeat the same instance N times."),
+    }),
+    z.object({
+        kind: z.literal("spacer"),
+        size: z.number().min(0).optional().describe("Square size when fillContainer is false. Default: 8."),
+        fillContainer: z.boolean().optional().describe("Stretch along the parent's primary axis."),
+    }),
+    z.object({
+        kind: z.literal("text"),
+        value: z.string(),
+        name: z.string().optional(),
+        fontSize: z.number().positive().optional(),
+        fontName: z.object({ family: z.string(), style: z.string() }).optional(),
+        textStyleId: z.string().optional(),
+        fillBindings: z.array(designDslFillBindingZod).optional(),
+        layoutSizing: designDslSizingSpecZod.optional(),
+    }),
+    z.object({
+        kind: z.literal("section"),
+        name: z.string().optional(),
+        layout: designDslLayoutSpecZod.optional(),
+        layoutSizing: designDslSizingSpecZod.optional(),
+        items: z.array(designDslItemZod).min(1),
+    }),
+]));
+export const designDslScreenSpecShape = {
+    version: z.literal("1").optional(),
+    name: z.string().optional(),
+    targetParentId: z.string().optional(),
+    targetRootId: z.string().optional(),
+    layout: designDslLayoutSpecZod.optional(),
+    items: z.array(designDslItemZod).min(1),
+    dryRun: z.boolean().optional(),
+};
+export const designDslScreenSpecV1Zod = z.object(designDslScreenSpecShape)
+    .superRefine((spec, ctx) => {
+    if (spec.targetParentId && spec.targetRootId) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Design DSL v1 accepts targetParentId or targetRootId, not both.",
+            path: ["targetRootId"],
+        });
+    }
+})
+    .describe("Design DSL v1. Optional version:'1' keeps compatibility with existing agents.");
+export const designDslUpdateScreenSpecV1Zod = z.object({
+    version: z.literal("1").optional(),
+    name: z.string().optional(),
+    layout: designDslLayoutSpecZod.optional(),
+    items: z.array(designDslItemZod).min(1),
+    dryRun: z.boolean().optional(),
+}).strict().describe("Design DSL v1 update payload. targetRootId is passed separately; targetParentId is not allowed.");
+export const designDslBuildMockupArgs = designDslScreenSpecShape;
+export const tokenDocSpecV1Zod = z.object({
+    version: z.literal("1"),
+    title: z.string().optional(),
+    groups: z.array(z.object({
+        id: z.string().min(1),
+        title: z.string().optional(),
+        rows: z.array(z.object({
+            layerName: z.string().min(1),
+            tokenPath: z.string().min(1),
+            show: z.enum(["resolved", "path", "both"]).optional(),
+        })),
+    })),
+});
+const tokenRowZod = z.object({
+    layerName: z.string().min(1),
+    tokenPath: z.string().min(1),
+    show: z.enum(["resolved", "path", "both"]).optional(),
+});
+const sectionTitleZod = z.object({
+    type: z.literal("title"),
+    id: z.string().optional(),
+    text: z.string(),
+    layerName: z.string().optional(),
+});
+const sectionDescriptionZod = z.object({
+    type: z.literal("description"),
+    id: z.string().optional(),
+    markdown: z.string(),
+    layerName: z.string().optional(),
+});
+const sectionVariantsZod = z.object({
+    type: z.literal("variants"),
+    id: z.string().optional(),
+    componentSetId: z.string().optional(),
+    componentId: z.string().optional(),
+    layout: z.enum(["matrix", "grid", "list"]).optional(),
+    groupBy: z.string().optional(),
+    limit: z.number().int().positive().optional(),
+    labelLayerName: z.string().optional(),
+});
+const sectionPropsZod = z.object({
+    type: z.literal("props"),
+    id: z.string().optional(),
+    componentId: z.string().optional(),
+    componentSetId: z.string().optional(),
+    include: z.array(z.enum(["VARIANT", "BOOLEAN", "TEXT", "INSTANCE_SWAP"])).optional(),
+});
+const sectionTokenTableZod = z.object({
+    type: z.literal("tokenTable"),
+    id: z.string().optional(),
+    title: z.string().optional(),
+    rows: z.array(tokenRowZod),
+});
+const sectionPaletteZod = z.object({
+    type: z.literal("palette"),
+    id: z.string().optional(),
+    collectionName: z.string().optional(),
+    collectionId: z.string().optional(),
+    variableType: z.enum(["COLOR", "FLOAT", "STRING", "BOOLEAN"]).optional(),
+    templateNodeId: z.string().min(1),
+    swatchLayerName: z.string().optional(),
+    labelLayerName: z.string().optional(),
+    valueLayerName: z.string().optional(),
+    namePrefix: z.string().optional(),
+    limit: z.number().int().positive().optional(),
+});
+const annotationPropertyZod = z.object({ type: z.string() });
+const annotationZod = z.object({
+    label: z.string().optional(),
+    labelMarkdown: z.string().optional(),
+    categoryId: z.string().optional(),
+    properties: z.array(annotationPropertyZod).optional(),
+});
+const sectionMeasureZod = z.object({
+    type: z.literal("measure"),
+    id: z.string().optional(),
+    experimental: z.boolean().optional(),
+    nodeId: z.string().min(1),
+    annotations: z.array(annotationZod).optional(),
+});
+export const docSectionZod = z.discriminatedUnion("type", [
+    sectionTitleZod,
+    sectionDescriptionZod,
+    sectionVariantsZod,
+    sectionPropsZod,
+    sectionTokenTableZod,
+    sectionPaletteZod,
+    sectionMeasureZod,
+]);
+export const docSpecV2Zod = z.object({
+    version: z.literal("2"),
+    title: z.string().optional(),
+    frame: z.object({
+        targetParentId: z.string().optional(),
+        targetRootId: z.string().optional(),
+        createIfMissing: z.boolean().optional(),
+        name: z.string().optional(),
+    }).optional(),
+    sections: z.array(docSectionZod).min(1),
+});
+export const paletteSectionZod = sectionPaletteZod;
+export const annotationItemZod = annotationZod;
+const codeConnectFrameworkZod = z.enum(["react", "angular", "html", "swift", "kotlin", "vue3", "compose"]);
+const codeConnectStatusZod = z.enum(["complete", "ready-for-dev", "in-progress", "backlog"]);
+export const codeConnectTargetZod = z.object({
+    nodeId: z.string().optional(),
+    nodeName: z.string().min(1),
+    nodeType: z.string().optional(),
+});
+export const codeConnectComponentApiPropertyZod = z.object({
+    name: z.string().min(1),
+    kind: z.string().min(1),
+    defaultValue: z.union([z.string(), z.boolean()]).optional(),
+    options: z.array(z.string()).optional(),
+}).passthrough();
+export const codeConnectFileBindingZod = z.object({
+    id: z.string().min(1),
+    framework: codeConnectFrameworkZod,
+    filePath: z.string().min(1),
+    componentName: z.string().optional(),
+    importPath: z.string().optional(),
+    snippetTemplate: z.string().optional(),
+    instructions: z.string().optional(),
+    storybookDocsUrl: z.string().optional(),
+}).passthrough();
+export const codeConnectBindingZod = z.object({
+    gitlabUrl: z.string(),
+    displayName: z.string().min(1),
+    resourceType: z.enum(["source", "docs", "story", "package"]),
+    documentationUrl: z.string().optional(),
+    documentationDocsQuerySuffix: z.string().optional(),
+    documentationStoryPathTemplate: z.string().optional(),
+    importPath: z.string().optional(),
+    snippetTemplate: z.string().optional(),
+    files: z.array(codeConnectFileBindingZod).optional(),
+    storybook: z.object({
+        designEmbed: z.boolean().optional(),
+        figmaUrl: z.string().optional(),
+        compositionJson: z.boolean().optional(),
+        metadata: z.boolean().optional(),
+        description: z.string().optional(),
+        tokensReady: z.boolean().optional(),
+        status: codeConnectStatusZod.optional(),
+        compositionTokenFileId: z.string().optional(),
+        compositionName: z.string().optional(),
+        compositionFilePath: z.string().optional(),
+        componentApi: z.object({
+            properties: z.array(codeConnectComponentApiPropertyZod),
+        }).optional(),
+    }).passthrough().optional(),
+}).passthrough();
+export const codeConnectSuggestionZod = z.object({
+    score: z.number(),
+    confidence: z.enum(["high", "medium", "low"]),
+    reason: z.array(z.string()),
+    filePath: z.string(),
+    framework: codeConnectFrameworkZod,
+    componentName: z.string(),
+    importPath: z.string(),
+    binding: codeConnectBindingZod,
+}).passthrough();
+export const codeConnectContextV1Zod = z.object({
+    ok: z.literal(true),
+    source: z.literal("bridge-code-connect-context"),
+    generatedAt: z.string(),
+    targets: z.array(codeConnectTargetZod),
+    targetNodeIds: z.array(z.string()),
+    codegenLanguage: z.enum(["designer-json", "vue3", "swiftui", "kotlin", "divkit"]),
+    viewMode: z.enum(["styled", "decomposed", "raw"]),
+    clientFrameworks: z.array(z.string()).nullable(),
+    mappedFrameworks: z.array(codeConnectFrameworkZod).nullable(),
+    clientLanguages: z.array(z.string()).nullable(),
+    context: z.object({
+        selection: z.unknown().optional(),
+        globalSettings: z.unknown().optional(),
+        registry: z.unknown().optional(),
+        selectionStatus: z.unknown().optional(),
+        nodeTree: z.record(z.string(), z.unknown()).optional(),
+        codegen: z.record(z.string(), z.unknown()).optional(),
+        compositionJson: z.record(z.string(), z.unknown()).optional(),
+        existingBindings: z.record(z.string(), z.unknown()).optional(),
+        nodeUiStatus: z.record(z.string(), z.unknown()).optional(),
+        componentDiscovery: z.unknown().optional(),
+        suggestions: z.object({
+            ok: z.literal(true),
+            targets: z.array(z.object({
+                nodeId: z.string().optional(),
+                nodeName: z.string(),
+                nodeType: z.string().optional(),
+                suggestions: z.array(codeConnectSuggestionZod),
+            }).passthrough()),
+        }).passthrough().optional(),
+    }).passthrough(),
+    warnings: z.array(z.string()),
+    limitations: z.array(z.string()),
+    templateGuidance: z.array(z.string()),
+    nextStep: z.string(),
+}).passthrough();
+export const codeConnectTemplateV1Zod = z.object({
+    ok: z.literal(true),
+    source: z.literal("bridge-code-connect-template"),
+    dryRun: z.boolean(),
+    generatedAt: z.string(),
+    target: codeConnectTargetZod.nullable(),
+    binding: codeConnectBindingZod,
+    template: z.object({
+        fileName: z.string().min(1),
+        outputPath: z.string().min(1),
+        content: z.string(),
+        bytes: z.number().int().nonnegative(),
+        componentName: z.string().min(1),
+        importPath: z.string().nullable(),
+        sourceFilePath: z.string().nullable(),
+        propertyAccessors: z.array(z.string()),
+    }),
+    write: z.object({
+        requested: z.boolean(),
+        written: z.boolean(),
+        overwritten: z.boolean(),
+    }),
+    warnings: z.array(z.string()),
+    nextStep: z.string(),
+}).passthrough();
+export const BRIDGE_SCHEMA_INDEX = {
+    version: 1,
+    schemas: [
+        {
+            id: "design-dsl-v1",
+            uri: DESIGN_DSL_V1_SCHEMA_URI,
+            toolEntrypoints: ["validate_screen_spec", "build_screen", "update_screen", "build_mockup"],
+        },
+        {
+            id: "doc-spec-v2",
+            uri: DOC_SPEC_V2_SCHEMA_URI,
+            toolEntrypoints: ["apply_doc_spec"],
+        },
+        {
+            id: "token-doc-v1",
+            uri: TOKEN_DOC_SPEC_V1_SCHEMA_URI,
+            toolEntrypoints: ["build_token_documentation", "apply_token_doc_spec"],
+        },
+        {
+            id: "code-connect-context-v1",
+            uri: CODE_CONNECT_CONTEXT_V1_SCHEMA_URI,
+            toolEntrypoints: ["get_context_for_code_connect"],
+        },
+        {
+            id: "code-connect-template-v1",
+            uri: CODE_CONNECT_TEMPLATE_V1_SCHEMA_URI,
+            toolEntrypoints: ["generate_code_connect_template"],
+        },
+    ],
+};
+export const DESIGN_DSL_V1_JSON_SCHEMA = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: DESIGN_DSL_V1_SCHEMA_URI,
+    title: "SXL Design DSL v1",
+    type: "object",
+    required: ["items"],
+    additionalProperties: false,
+    properties: {
+        version: { const: "1" },
+        name: { type: "string" },
+        targetParentId: { type: "string" },
+        targetRootId: { type: "string" },
+        dryRun: { type: "boolean" },
+        layout: { $ref: "#/$defs/layout" },
+        items: { type: "array", minItems: 1, items: { $ref: "#/$defs/item" } },
+    },
+    allOf: [
+        {
+            not: {
+                required: ["targetParentId", "targetRootId"],
+            },
+        },
+    ],
+    $defs: {
+        sizing: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                mode: { enum: ["HUG", "FIXED", "FILL"] },
+                width: { type: "number", exclusiveMinimum: 0 },
+                height: { type: "number", exclusiveMinimum: 0 },
+            },
+        },
+        layout: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                mode: { enum: ["VERTICAL", "HORIZONTAL", "WRAP"] },
+                itemSpacing: { type: "number", minimum: 0 },
+                counterAxisSpacing: { type: "number", minimum: 0 },
+                padding: {
+                    oneOf: [
+                        { type: "number", minimum: 0 },
+                        {
+                            type: "object",
+                            additionalProperties: false,
+                            properties: {
+                                top: { type: "number", minimum: 0 },
+                                right: { type: "number", minimum: 0 },
+                                bottom: { type: "number", minimum: 0 },
+                                left: { type: "number", minimum: 0 },
+                            },
+                        },
+                    ],
+                },
+                primaryAxis: { enum: ["MIN", "CENTER", "MAX", "SPACE_BETWEEN"] },
+                counterAxis: { enum: ["MIN", "CENTER", "MAX", "BASELINE"] },
+                width: { type: "number", exclusiveMinimum: 0 },
+                height: { type: "number", exclusiveMinimum: 0 },
+                background: {
+                    oneOf: [
+                        {
+                            type: "object",
+                            required: ["hex"],
+                            additionalProperties: false,
+                            properties: { hex: { type: "string", pattern: "^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$" } },
+                        },
+                        {
+                            type: "object",
+                            required: ["variableId"],
+                            additionalProperties: false,
+                            properties: { variableId: { type: "string", minLength: 1 } },
+                        },
+                    ],
+                },
+            },
+        },
+        textOverride: {
+            type: "object",
+            required: ["layerName", "value"],
+            additionalProperties: false,
+            properties: { layerName: { type: "string", minLength: 1 }, value: { type: "string" } },
+        },
+        fillBinding: {
+            type: "object",
+            required: ["variableId"],
+            additionalProperties: false,
+            properties: {
+                layerName: { type: "string", minLength: 1 },
+                variableId: { type: "string", minLength: 1 },
+                paintIndex: { type: "integer", minimum: 0 },
+            },
+        },
+        item: {
+            oneOf: [
+                {
+                    type: "object",
+                    required: ["kind"],
+                    additionalProperties: false,
+                    properties: {
+                        kind: { const: "instance" },
+                        componentId: { type: "string", minLength: 1 },
+                        componentKey: { type: "string", minLength: 1 },
+                        componentName: { type: "string", minLength: 1 },
+                        name: { type: "string" },
+                        properties: { type: "object", additionalProperties: { oneOf: [{ type: "string" }, { type: "boolean" }] } },
+                        textOverrides: { type: "array", items: { $ref: "#/$defs/textOverride" } },
+                        fillBindings: { type: "array", items: { $ref: "#/$defs/fillBinding" } },
+                        layoutSizing: { $ref: "#/$defs/sizing" },
+                        count: { type: "integer", minimum: 1, maximum: 500 },
+                    },
+                },
+                {
+                    type: "object",
+                    required: ["kind", "items"],
+                    additionalProperties: false,
+                    properties: {
+                        kind: { const: "section" },
+                        name: { type: "string" },
+                        layout: { $ref: "#/$defs/layout" },
+                        layoutSizing: { $ref: "#/$defs/sizing" },
+                        items: { type: "array", minItems: 1, items: { $ref: "#/$defs/item" } },
+                    },
+                },
+                {
+                    type: "object",
+                    required: ["kind"],
+                    additionalProperties: false,
+                    properties: {
+                        kind: { const: "spacer" },
+                        size: { type: "number", minimum: 0 },
+                        fillContainer: { type: "boolean" },
+                    },
+                },
+                {
+                    type: "object",
+                    required: ["kind", "value"],
+                    additionalProperties: false,
+                    properties: {
+                        kind: { const: "text" },
+                        value: { type: "string" },
+                        name: { type: "string" },
+                        fontSize: { type: "number", exclusiveMinimum: 0 },
+                        fontName: {
+                            type: "object",
+                            required: ["family", "style"],
+                            additionalProperties: false,
+                            properties: { family: { type: "string" }, style: { type: "string" } },
+                        },
+                        textStyleId: { type: "string" },
+                        fillBindings: { type: "array", items: { $ref: "#/$defs/fillBinding" } },
+                        layoutSizing: { $ref: "#/$defs/sizing" },
+                    },
+                },
+            ],
+        },
+    },
+};
+export const DOC_SPEC_V2_JSON_SCHEMA = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: DOC_SPEC_V2_SCHEMA_URI,
+    title: "SXL Doc Spec v2",
+    type: "object",
+    required: ["version", "sections"],
+    additionalProperties: false,
+    properties: {
+        version: { const: "2" },
+        title: { type: "string" },
+        frame: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                targetParentId: { type: "string" },
+                targetRootId: { type: "string" },
+                createIfMissing: { type: "boolean" },
+                name: { type: "string" },
+            },
+        },
+        sections: {
+            type: "array",
+            minItems: 1,
+            items: {
+                oneOf: [
+                    { type: "object", required: ["type", "text"], properties: { type: { const: "title" }, id: { type: "string" }, text: { type: "string" }, layerName: { type: "string" } }, additionalProperties: false },
+                    { type: "object", required: ["type", "markdown"], properties: { type: { const: "description" }, id: { type: "string" }, markdown: { type: "string" }, layerName: { type: "string" } }, additionalProperties: false },
+                    { type: "object", required: ["type"], properties: { type: { const: "variants" }, id: { type: "string" }, componentSetId: { type: "string" }, componentId: { type: "string" }, layout: { enum: ["matrix", "grid", "list"] }, groupBy: { type: "string" }, limit: { type: "integer", minimum: 1 }, labelLayerName: { type: "string" } }, additionalProperties: false },
+                    { type: "object", required: ["type"], properties: { type: { const: "props" }, id: { type: "string" }, componentId: { type: "string" }, componentSetId: { type: "string" }, include: { type: "array", items: { enum: ["VARIANT", "BOOLEAN", "TEXT", "INSTANCE_SWAP"] } } }, additionalProperties: false },
+                    { type: "object", required: ["type", "rows"], properties: { type: { const: "tokenTable" }, id: { type: "string" }, title: { type: "string" }, rows: { type: "array", items: { $ref: "#/$defs/tokenRow" } } }, additionalProperties: false },
+                    { type: "object", required: ["type", "templateNodeId"], properties: { type: { const: "palette" }, id: { type: "string" }, collectionName: { type: "string" }, collectionId: { type: "string" }, variableType: { enum: ["COLOR", "FLOAT", "STRING", "BOOLEAN"] }, templateNodeId: { type: "string", minLength: 1 }, swatchLayerName: { type: "string" }, labelLayerName: { type: "string" }, valueLayerName: { type: "string" }, namePrefix: { type: "string" }, limit: { type: "integer", minimum: 1 } }, additionalProperties: false },
+                    { type: "object", required: ["type", "nodeId"], properties: { type: { const: "measure" }, id: { type: "string" }, experimental: { type: "boolean" }, nodeId: { type: "string", minLength: 1 }, annotations: { type: "array", items: { type: "object" } } }, additionalProperties: false },
+                ],
+            },
+        },
+    },
+    $defs: {
+        tokenRow: {
+            type: "object",
+            required: ["layerName", "tokenPath"],
+            additionalProperties: false,
+            properties: {
+                layerName: { type: "string", minLength: 1 },
+                tokenPath: { type: "string", minLength: 1 },
+                show: { enum: ["resolved", "path", "both"] },
+            },
+        },
+    },
+};
+export const TOKEN_DOC_SPEC_V1_JSON_SCHEMA = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: TOKEN_DOC_SPEC_V1_SCHEMA_URI,
+    title: "SXL Token Doc Spec v1",
+    type: "object",
+    required: ["version", "groups"],
+    additionalProperties: false,
+    properties: {
+        version: { const: "1" },
+        title: { type: "string" },
+        groups: {
+            type: "array",
+            items: {
+                type: "object",
+                required: ["id", "rows"],
+                additionalProperties: false,
+                properties: {
+                    id: { type: "string", minLength: 1 },
+                    title: { type: "string" },
+                    rows: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            required: ["layerName", "tokenPath"],
+                            additionalProperties: false,
+                            properties: {
+                                layerName: { type: "string", minLength: 1 },
+                                tokenPath: { type: "string", minLength: 1 },
+                                show: { enum: ["resolved", "path", "both"] },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    },
+};
+const CODE_CONNECT_JSON_DEFS = {
+    target: {
+        type: "object",
+        required: ["nodeName"],
+        additionalProperties: true,
+        properties: {
+            nodeId: { type: "string" },
+            nodeName: { type: "string", minLength: 1 },
+            nodeType: { type: "string" },
+        },
+    },
+    componentApiProperty: {
+        type: "object",
+        required: ["name", "kind"],
+        additionalProperties: true,
+        properties: {
+            name: { type: "string", minLength: 1 },
+            kind: { type: "string", minLength: 1 },
+            defaultValue: { oneOf: [{ type: "string" }, { type: "boolean" }] },
+            options: { type: "array", items: { type: "string" } },
+        },
+    },
+    fileBinding: {
+        type: "object",
+        required: ["id", "framework", "filePath"],
+        additionalProperties: true,
+        properties: {
+            id: { type: "string", minLength: 1 },
+            framework: { enum: ["react", "angular", "html", "swift", "kotlin", "vue3", "compose"] },
+            filePath: { type: "string", minLength: 1 },
+            componentName: { type: "string" },
+            importPath: { type: "string" },
+            snippetTemplate: { type: "string" },
+            instructions: { type: "string" },
+            storybookDocsUrl: { type: "string" },
+        },
+    },
+    binding: {
+        type: "object",
+        required: ["gitlabUrl", "displayName", "resourceType"],
+        additionalProperties: true,
+        properties: {
+            gitlabUrl: { type: "string" },
+            displayName: { type: "string", minLength: 1 },
+            resourceType: { enum: ["source", "docs", "story", "package"] },
+            documentationUrl: { type: "string" },
+            documentationDocsQuerySuffix: { type: "string" },
+            documentationStoryPathTemplate: { type: "string" },
+            importPath: { type: "string" },
+            snippetTemplate: { type: "string" },
+            files: { type: "array", items: { $ref: "#/$defs/fileBinding" } },
+            storybook: {
+                type: "object",
+                additionalProperties: true,
+                properties: {
+                    designEmbed: { type: "boolean" },
+                    figmaUrl: { type: "string" },
+                    compositionJson: { type: "boolean" },
+                    metadata: { type: "boolean" },
+                    description: { type: "string" },
+                    tokensReady: { type: "boolean" },
+                    status: { enum: ["complete", "ready-for-dev", "in-progress", "backlog"] },
+                    compositionTokenFileId: { type: "string" },
+                    compositionName: { type: "string" },
+                    compositionFilePath: { type: "string" },
+                    componentApi: {
+                        type: "object",
+                        required: ["properties"],
+                        additionalProperties: true,
+                        properties: {
+                            properties: { type: "array", items: { $ref: "#/$defs/componentApiProperty" } },
+                        },
+                    },
+                },
+            },
+        },
+    },
+    suggestion: {
+        type: "object",
+        required: ["score", "confidence", "filePath", "framework", "componentName", "importPath", "binding"],
+        additionalProperties: true,
+        properties: {
+            score: { type: "number" },
+            confidence: { enum: ["high", "medium", "low"] },
+            reason: { type: "array", items: { type: "string" } },
+            filePath: { type: "string" },
+            framework: { enum: ["react", "angular", "html", "swift", "kotlin", "vue3", "compose"] },
+            componentName: { type: "string" },
+            importPath: { type: "string" },
+            binding: { $ref: "#/$defs/binding" },
+        },
+    },
+};
+export const CODE_CONNECT_CONTEXT_V1_JSON_SCHEMA = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: CODE_CONNECT_CONTEXT_V1_SCHEMA_URI,
+    title: "SXL Code Connect Context v1",
+    description: "Bridge response contract for get_context_for_code_connect. Use before saving SXL bindings or generating .figma.ts templates.",
+    type: "object",
+    required: ["ok", "source", "generatedAt", "targets", "targetNodeIds", "context", "warnings", "limitations", "templateGuidance", "nextStep"],
+    additionalProperties: true,
+    properties: {
+        ok: { const: true },
+        source: { const: "bridge-code-connect-context" },
+        generatedAt: { type: "string" },
+        targets: { type: "array", items: { $ref: "#/$defs/target" } },
+        targetNodeIds: { type: "array", items: { type: "string" } },
+        codegenLanguage: { enum: ["designer-json", "vue3", "swiftui", "kotlin", "divkit"] },
+        viewMode: { enum: ["styled", "decomposed", "raw"] },
+        clientFrameworks: { oneOf: [{ type: "array", items: { type: "string" } }, { type: "null" }] },
+        mappedFrameworks: { oneOf: [{ type: "array", items: { enum: ["react", "angular", "html", "swift", "kotlin", "vue3", "compose"] } }, { type: "null" }] },
+        clientLanguages: { oneOf: [{ type: "array", items: { type: "string" } }, { type: "null" }] },
+        context: {
+            type: "object",
+            additionalProperties: true,
+            properties: {
+                selection: {},
+                globalSettings: {},
+                registry: {},
+                selectionStatus: {},
+                nodeTree: { type: "object", additionalProperties: true },
+                codegen: { type: "object", additionalProperties: true },
+                compositionJson: { type: "object", additionalProperties: true },
+                existingBindings: { type: "object", additionalProperties: true },
+                nodeUiStatus: { type: "object", additionalProperties: true },
+                componentDiscovery: {},
+                suggestions: {
+                    type: "object",
+                    required: ["ok", "targets"],
+                    additionalProperties: true,
+                    properties: {
+                        ok: { const: true },
+                        targets: {
+                            type: "array",
+                            items: {
+                                type: "object",
+                                required: ["nodeName", "suggestions"],
+                                additionalProperties: true,
+                                properties: {
+                                    nodeId: { type: "string" },
+                                    nodeName: { type: "string" },
+                                    nodeType: { type: "string" },
+                                    suggestions: { type: "array", items: { $ref: "#/$defs/suggestion" } },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        warnings: { type: "array", items: { type: "string" } },
+        limitations: { type: "array", items: { type: "string" } },
+        templateGuidance: { type: "array", items: { type: "string" } },
+        nextStep: { type: "string" },
+    },
+    $defs: CODE_CONNECT_JSON_DEFS,
+};
+export const CODE_CONNECT_TEMPLATE_V1_JSON_SCHEMA = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: CODE_CONNECT_TEMPLATE_V1_SCHEMA_URI,
+    title: "SXL Code Connect Template v1",
+    description: "Bridge response contract for generate_code_connect_template. Dry-run by default; file writes require writeFile=true.",
+    type: "object",
+    required: ["ok", "source", "dryRun", "generatedAt", "target", "binding", "template", "write", "warnings", "nextStep"],
+    additionalProperties: true,
+    properties: {
+        ok: { const: true },
+        source: { const: "bridge-code-connect-template" },
+        dryRun: { type: "boolean" },
+        generatedAt: { type: "string" },
+        target: { oneOf: [{ $ref: "#/$defs/target" }, { type: "null" }] },
+        binding: { $ref: "#/$defs/binding" },
+        template: {
+            type: "object",
+            required: ["fileName", "outputPath", "content", "bytes", "componentName", "importPath", "sourceFilePath", "propertyAccessors"],
+            additionalProperties: false,
+            properties: {
+                fileName: { type: "string", minLength: 1 },
+                outputPath: { type: "string", minLength: 1 },
+                content: { type: "string" },
+                bytes: { type: "integer", minimum: 0 },
+                componentName: { type: "string", minLength: 1 },
+                importPath: { oneOf: [{ type: "string" }, { type: "null" }] },
+                sourceFilePath: { oneOf: [{ type: "string" }, { type: "null" }] },
+                propertyAccessors: { type: "array", items: { type: "string" } },
+            },
+        },
+        write: {
+            type: "object",
+            required: ["requested", "written", "overwritten"],
+            additionalProperties: false,
+            properties: {
+                requested: { type: "boolean" },
+                written: { type: "boolean" },
+                overwritten: { type: "boolean" },
+            },
+        },
+        warnings: { type: "array", items: { type: "string" } },
+        nextStep: { type: "string" },
+    },
+    $defs: CODE_CONNECT_JSON_DEFS,
+};
+//# sourceMappingURL=schema-contracts.js.map