desen-core 1.0.0-draft.3 → 1.0.0-draft.31

package/src/schemas/style.ts

@@ -29,6 +29,16 @@ export const styleSpec = z.object({
     font_weight_token: dtcgTokenPath.optional(),
     line_height: z.number().optional(),
     line_height_token: dtcgTokenPath.optional(),
+    line_height_percent: z.number().optional(),
+    letter_spacing: z.number().optional(),
+    letter_spacing_token: dtcgTokenPath.optional(),
+    letter_spacing_percent: z.number().optional(),
+    text_align: z.string().optional(),
+    text_decoration: z.string().optional(),
+    text_transform: z.string().optional(),
+
+    // ── Nested text_style (for composition children) ──
+    text_style: z.record(z.any()).optional(),
 
     // ── Spacing Properties ──
     padding: z.union([
@@ -53,10 +63,14 @@ export const styleSpec = z.object({
     margin_token: dtcgTokenPath.optional(),
 
     // ── Border Properties ──
-    border_radius: z.number().optional(),
+    border_radius: z.union([z.number(), z.array(z.number())]).optional(),
     border_radius_token: dtcgTokenPath.optional(),
     border_width: z.number().optional(),
     border_width_token: dtcgTokenPath.optional(),
+    border_top_width: z.number().optional(),
+    border_right_width: z.number().optional(),
+    border_bottom_width: z.number().optional(),
+    border_left_width: z.number().optional(),
 
     // ── Dimension Properties ──
     min_height: z.number().optional(),
@@ -68,10 +82,76 @@ export const styleSpec = z.object({
     height: z.union([z.number(), z.string()]).optional(),
     height_token: dtcgTokenPath.optional(),
 
-    // ── Opacity ──
+    // ── Visual ──
     opacity: z.number().min(0).max(1).optional(),
     opacity_token: dtcgTokenPath.optional(),
-}).passthrough(); // Allow vendor extensions (§2.9)
+    box_shadow: z.string().optional(),
+}).passthrough().superRefine((data, ctx) => {
+    // Fail-Closed Governance: If a literal style value exists, its corresponding token MUST exist.
+    const rules = [
+        { literal: 'bg_color', token: 'bg_color_token' },
+        { literal: 'text_color', token: 'text_color_token' },
+        { literal: 'border_color', token: 'border_color_token' },
+        { literal: 'font_family', token: 'font_family_token' },
+        { literal: 'font_size', token: 'font_size_token' },
+        { literal: 'font_weight', token: 'font_weight_token' },
+        { literal: 'line_height', token: 'line_height_token' },
+        { literal: 'line_height_percent', token: 'line_height_token' },
+        { literal: 'letter_spacing', token: 'letter_spacing_token' },
+        { literal: 'letter_spacing_percent', token: 'letter_spacing_token' },
+        { literal: 'padding', token: 'padding_token' },
+        { literal: 'margin', token: 'margin_token' },
+        { literal: 'border_radius', token: 'border_radius_token' },
+        { literal: 'border_width', token: 'border_width_token' },
+        { literal: 'border_top_width', token: 'border_width_token' },
+        { literal: 'border_right_width', token: 'border_width_token' },
+        { literal: 'border_bottom_width', token: 'border_width_token' },
+        { literal: 'border_left_width', token: 'border_width_token' }
+    ];
+
+    rules.forEach(({ literal, token }) => {
+        const val = data[literal as keyof typeof data];
+        if (val !== undefined && data[token as keyof typeof data] === undefined) {
+
+            // EXEMPTION: Border widths of 0 or 1 do not require token binding
+            if (literal.includes('border_width') || literal.includes('border_top_width') || literal.includes('border_right_width') || literal.includes('border_bottom_width') || literal.includes('border_left_width')) {
+                if (val === 0 || val === 1) return;
+            }
+
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `Fail-Closed Governance: Unbound Literal Value. Element declares [${literal}] but is missing [${token}]. Hardcoded visual styles are rejected by the design system.`,
+                path: [literal],
+            });
+        }
+    });
+
+    // Also validate nested text_style if present
+    if (data.text_style && typeof data.text_style === 'object') {
+        const ts = data.text_style as Record<string, any>;
+        const textRules = [
+            { literal: 'text_color', token: 'text_color_token' },
+            { literal: 'font_family', token: 'font_family_token' },
+            { literal: 'font_size', token: 'font_size_token' },
+            { literal: 'font_weight', token: 'font_weight_token' },
+            { literal: 'line_height', token: 'line_height_token' },
+            { literal: 'line_height_percent', token: 'line_height_token' },
+            { literal: 'letter_spacing', token: 'letter_spacing_token' },
+            { literal: 'letter_spacing_percent', token: 'letter_spacing_token' },
+        ];
+        textRules.forEach(({ literal, token }) => {
+            if (ts[literal] !== undefined && ts[token] === undefined) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: `Fail-Closed Governance: Unbound Literal Value. text_style declares [${literal}] but is missing [${token}]. Hardcoded visual styles are rejected.`,
+                    path: ['text_style', literal],
+                });
+            }
+        });
+    }
+
+    return true;
+}); // Allow vendor extensions (§2.9)
 
 // ─── Types ───────────────────────────────────────────────────────
 export type StyleSpec = z.infer<typeof styleSpec>;

package/src/schemas/surface.ts

@@ -10,11 +10,12 @@ import { telemetrySpec } from "./telemetry";
 // root level; it must be contained within a Composition.
 export const surfaceSpec = z.object({
     id: z.string().min(1).regex(/^[A-Za-z][A-Za-z0-9_.:-]{0,127}$/),
+    name: z.string().optional(),
     root: compositionSpec,
     telemetry: telemetrySpec,
     metadata: z.record(z.any()).optional(),
     environment: z.record(z.any()).optional(),
-}).passthrough();
+}).strict();
 
 // ─── Types ───────────────────────────────────────────────────────
 export type SurfaceSpec = z.infer<typeof surfaceSpec>;