@mich8060/unified-design-system 0.2.13 → 0.2.15

package/dist/ai/policies/policy.engine.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../manifest/governance.manifest.cjs"),o=require("./rules/composition.rules.cjs"),c=require("./rules/action.rules.cjs"),t=require("./rules/spacing.rules.cjs"),s=require("./rules/accessibility.rules.cjs"),u=[o.enforceCompositionRule,c.enforcePrimaryActionLimitRule,t.enforceSpacingTokenRule,s.enforceAccessibilityRule];function l(e,n=r.UDSGovernance){return u.flatMap(i=>i({tree:e,governanceConfig:n}))}exports.runPolicyEngine=l;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("../manifest/governance.manifest.cjs"),o=require("./rules/composition.rules.cjs"),c=require("./rules/action.rules.cjs"),l=require("./rules/spacing.rules.cjs"),s=require("./rules/accessibility.rules.cjs"),u=require("./rules/props.rules.cjs"),t=require("./rules/token-variable.rules.cjs"),a=require("./rules/tailwind.rules.cjs"),f=[o.enforceCompositionRule,c.enforcePrimaryActionLimitRule,l.enforceSpacingTokenRule,t.enforceTokenVariableRule,a.enforceTailwindDisallowRule,s.enforceAccessibilityRule,u.enforceCanonicalPropsRule];function p(e,r=i.UDSGovernance){return f.flatMap(n=>n({tree:e,governanceConfig:r}))}exports.runPolicyEngine=p;

package/dist/ai/policies/policy.engine.js

@@ -1 +1 @@
-import{UDSGovernance as i}from"../manifest/governance.manifest.js";import{enforceCompositionRule as n}from"./rules/composition.rules.js";import{enforcePrimaryActionLimitRule as t}from"./rules/action.rules.js";import{enforceSpacingTokenRule as m}from"./rules/spacing.rules.js";import{enforceAccessibilityRule as c}from"./rules/accessibility.rules.js";const f=[n,t,m,c];function s(o,r=i){return f.flatMap(e=>e({tree:o,governanceConfig:r}))}export{s as runPolicyEngine};
+import{UDSGovernance as i}from"../manifest/governance.manifest.js";import{enforceCompositionRule as n}from"./rules/composition.rules.js";import{enforcePrimaryActionLimitRule as m}from"./rules/action.rules.js";import{enforceSpacingTokenRule as f}from"./rules/spacing.rules.js";import{enforceAccessibilityRule as t}from"./rules/accessibility.rules.js";import{enforceCanonicalPropsRule as c}from"./rules/props.rules.js";import{enforceTokenVariableRule as l}from"./rules/token-variable.rules.js";import{enforceTailwindDisallowRule as p}from"./rules/tailwind.rules.js";const a=[n,m,f,l,p,t,c];function T(o,r=i){return a.flatMap(e=>e({tree:o,governanceConfig:r}))}export{T as runPolicyEngine};

package/dist/ai/policies/rules/composition.rules.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("../../manifest/components.manifest.cjs"),m=new Set(["div","span","button","input","textarea","select","option","label","ul","li","section","article","header","footer","main","nav","form"]),u=({tree:i,governanceConfig:n})=>{const o=[],s=(e,t)=>{const l=!!p.ComponentRegistry[e.type],r=m.has(e.type);!l&&!n.enforcement.allowUnknownComponents&&o.push({severity:"error",code:"RULE_UNKNOWN_COMPONENT",message:`Unknown component "${e.type}" is not allowed in governed mode.`,path:t,component:e.type}),r&&!n.enforcement.allowAdHocValues&&o.push({severity:"error",code:"RULE_RAW_HTML_DISALLOWED",message:`Raw HTML tag "${e.type}" is disallowed unless policy allows ad-hoc values.`,path:t,component:e.type}),(e.children??[]).forEach((c,a)=>s(c,`${t}.children[${a}]`))};return s(i,"root"),o};exports.enforceCompositionRule=u;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const w=require("../../manifest/components.manifest.cjs"),r=require("../../manifest/composition.manifest.cjs"),f=new Set(["div","span","button","input","textarea","select","option","label","ul","li","section","article","header","footer","main","nav","form"]),R=({tree:m,governanceConfig:c})=>{const n=[],y=(e,t)=>r.CompositionRules.disallowedPairs.some(o=>o.parent===e&&o.child===t),p=(e,t,o)=>{const u=!!w.ComponentRegistry[e.type],d=f.has(e.type);if(!u&&!c.enforcement.allowUnknownComponents&&n.push({severity:"error",code:"RULE_UNKNOWN_COMPONENT",message:`Unknown component "${e.type}" is not allowed in governed mode.`,path:t,component:e.type}),d&&!c.enforcement.allowAdHocValues&&n.push({severity:"error",code:"RULE_RAW_HTML_DISALLOWED",message:`Raw HTML tag "${e.type}" is disallowed unless policy allows ad-hoc values.`,path:t,component:e.type}),o){const s=r.CompositionRules.allowedParentsByChild[e.type];if(Array.isArray(s)&&!s.includes(o)&&n.push({severity:"error",code:"RULE_INVALID_PARENT_COMPOSITION",message:`${e.type} must be nested under one of: ${s.join(", ")}.`,path:t,component:e.type}),y(o,e.type)){const i=r.CompositionRules.disallowedPairs.find(l=>l.parent===o&&l.child===e.type);n.push({severity:"error",code:"RULE_DISALLOWED_NESTING",message:`${e.type} cannot be nested in ${o}.${i!=null&&i.reason?` ${i.reason}`:""}`,path:t,component:e.type})}}const a=r.CompositionRules.allowedChildrenByParent[e.type];(e.children??[]).forEach((s,i)=>{const l=`${t}.children[${i}]`;Array.isArray(a)&&!a.includes(s.type)&&n.push({severity:"error",code:"RULE_INVALID_COMPOSITION",message:`${s.type} is not an allowed child of ${e.type}. Allowed: ${a.join(", ")}.`,path:l,component:s.type}),p(s,l,e.type)})};return p(m,"root"),n};exports.enforceCompositionRule=R;

package/dist/ai/policies/rules/composition.rules.js

@@ -1 +1 @@
-import{ComponentRegistry as p}from"../../manifest/components.manifest.js";const m=new Set(["div","span","button","input","textarea","select","option","label","ul","li","section","article","header","footer","main","nav","form"]),u=({tree:l,governanceConfig:n})=>{const o=[],s=(e,t)=>{const r=!!p[e.type],i=m.has(e.type);!r&&!n.enforcement.allowUnknownComponents&&o.push({severity:"error",code:"RULE_UNKNOWN_COMPONENT",message:`Unknown component "${e.type}" is not allowed in governed mode.`,path:t,component:e.type}),i&&!n.enforcement.allowAdHocValues&&o.push({severity:"error",code:"RULE_RAW_HTML_DISALLOWED",message:`Raw HTML tag "${e.type}" is disallowed unless policy allows ad-hoc values.`,path:t,component:e.type}),(e.children??[]).forEach((a,c)=>s(a,`${t}.children[${c}]`))};return s(l,"root"),o};export{u as enforceCompositionRule};
+import{ComponentRegistry as u}from"../../manifest/components.manifest.js";import{CompositionRules as l}from"../../manifest/composition.manifest.js";const f=new Set(["div","span","button","input","textarea","select","option","label","ul","li","section","article","header","footer","main","nav","form"]),_=({tree:y,governanceConfig:c})=>{const n=[],m=(e,t)=>l.disallowedPairs.some(o=>o.parent===e&&o.child===t),p=(e,t,o)=>{const d=!!u[e.type],w=f.has(e.type);if(!d&&!c.enforcement.allowUnknownComponents&&n.push({severity:"error",code:"RULE_UNKNOWN_COMPONENT",message:`Unknown component "${e.type}" is not allowed in governed mode.`,path:t,component:e.type}),w&&!c.enforcement.allowAdHocValues&&n.push({severity:"error",code:"RULE_RAW_HTML_DISALLOWED",message:`Raw HTML tag "${e.type}" is disallowed unless policy allows ad-hoc values.`,path:t,component:e.type}),o){const s=l.allowedParentsByChild[e.type];if(Array.isArray(s)&&!s.includes(o)&&n.push({severity:"error",code:"RULE_INVALID_PARENT_COMPOSITION",message:`${e.type} must be nested under one of: ${s.join(", ")}.`,path:t,component:e.type}),m(o,e.type)){const r=l.disallowedPairs.find(i=>i.parent===o&&i.child===e.type);n.push({severity:"error",code:"RULE_DISALLOWED_NESTING",message:`${e.type} cannot be nested in ${o}.${r!=null&&r.reason?` ${r.reason}`:""}`,path:t,component:e.type})}}const a=l.allowedChildrenByParent[e.type];(e.children??[]).forEach((s,r)=>{const i=`${t}.children[${r}]`;Array.isArray(a)&&!a.includes(s.type)&&n.push({severity:"error",code:"RULE_INVALID_COMPOSITION",message:`${s.type} is not an allowed child of ${e.type}. Allowed: ${a.join(", ")}.`,path:i,component:s.type}),p(s,i,e.type)})};return p(y,"root"),n};export{_ as enforceCompositionRule};

package/dist/ai/policies/rules/props.rules.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("../../manifest/prop-aliases.manifest.cjs"),l=r=>({...a.PropAliasRules.global??{},...a.PropAliasRules.byComponent[r]??{}}),u=({tree:r})=>{const n=[],t=(o,p)=>{const c=l(o.type),i=o.props??{};for(const e of Object.keys(i)){const s=c[e];s&&n.push({severity:"error",code:"RULE_AMBIGUOUS_PROP_ALIAS",message:`Prop "${e}" is ambiguous for ${o.type}. Use canonical prop "${s}".`,path:`${p}.props.${e}`,component:o.type})}(o.children??[]).forEach((e,s)=>t(e,`${p}.children[${s}]`))};return t(r,"root"),n};exports.enforceCanonicalPropsRule=u;

package/dist/ai/policies/rules/props.rules.js

@@ -0,0 +1 @@
+import{PropAliasRules as c}from"../../manifest/prop-aliases.manifest.js";const l=p=>({...c.global??{},...c.byComponent[p]??{}}),f=({tree:p})=>{const n=[],t=(o,e)=>{const a=l(o.type),i=o.props??{};for(const r of Object.keys(i)){const s=a[r];s&&n.push({severity:"error",code:"RULE_AMBIGUOUS_PROP_ALIAS",message:`Prop "${r}" is ambiguous for ${o.type}. Use canonical prop "${s}".`,path:`${e}.props.${r}`,component:o.type})}(o.children??[]).forEach((r,s)=>t(r,`${e}.children[${s}]`))};return t(p,"root"),n};export{f as enforceCanonicalPropsRule};

package/dist/ai/policies/rules/tailwind.rules.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=new Set(["class","className","classes","tw","tailwind"]),f=[/^(?:sm|md|lg|xl|2xl):/,/^(?:hover|focus|active|disabled|dark|group-hover):/,/^(?:m|mx|my|mt|mr|mb|ml|p|px|py|pt|pr|pb|pl)-/,/^(?:w|h|min-w|min-h|max-w|max-h)-/,/^(?:bg|text|font|tracking|leading|rounded|shadow|border|ring)-/,/^(?:flex|grid|inline-flex|inline-grid|contents|block|inline-block|hidden)$/,/^(?:items|justify|content|self|place-items|place-content|place-self)-/,/^(?:gap|space-x|space-y|col-span|row-span|order)-/,/^tw-/],d=e=>{const t=e.trim();return t?f.some(n=>n.test(t)):!1},m=e=>e.split(/\s+/g).map(t=>t.trim()).filter(Boolean),l=(e,t,n,i)=>{if(typeof e=="string"){const s=m(e);for(const r of s)d(r)&&i.push({severity:"error",code:"RULE_TAILWIND_CLASS_DISALLOWED",message:`Tailwind utility token "${r}" is disallowed. Use UDS components and tokenized props.`,path:t,component:n,token:r});return}if(Array.isArray(e)){e.forEach((s,r)=>l(s,`${t}[${r}]`,n,i));return}typeof e!="object"||e===null||Object.entries(e).forEach(([s,r])=>{if(a.has(s)){l(r,`${t}.${s}`,n,i);return}l(r,`${t}.${s}`,n,i)})},p=({tree:e})=>{const t=[],n=(i,s)=>{const r=i.props??{};Object.entries(r).forEach(([o,c])=>{if(a.has(o)){l(c,`${s}.props.${o}`,i.type,t);return}typeof c=="string"&&/\b(?:className|tailwind|tw)\b/i.test(o)&&l(c,`${s}.props.${o}`,i.type,t)}),(i.children??[]).forEach((o,c)=>n(o,`${s}.children[${c}]`))};return n(e,"root"),t};exports.enforceTailwindDisallowRule=p;

package/dist/ai/policies/rules/tailwind.rules.js

@@ -0,0 +1 @@
+const a=new Set(["class","className","classes","tw","tailwind"]),f=[/^(?:sm|md|lg|xl|2xl):/,/^(?:hover|focus|active|disabled|dark|group-hover):/,/^(?:m|mx|my|mt|mr|mb|ml|p|px|py|pt|pr|pb|pl)-/,/^(?:w|h|min-w|min-h|max-w|max-h)-/,/^(?:bg|text|font|tracking|leading|rounded|shadow|border|ring)-/,/^(?:flex|grid|inline-flex|inline-grid|contents|block|inline-block|hidden)$/,/^(?:items|justify|content|self|place-items|place-content|place-self)-/,/^(?:gap|space-x|space-y|col-span|row-span|order)-/,/^tw-/],d=e=>{const s=e.trim();return s?f.some(n=>n.test(s)):!1},p=e=>e.split(/\s+/g).map(s=>s.trim()).filter(Boolean),l=(e,s,n,i)=>{if(typeof e=="string"){const t=p(e);for(const r of t)d(r)&&i.push({severity:"error",code:"RULE_TAILWIND_CLASS_DISALLOWED",message:`Tailwind utility token "${r}" is disallowed. Use UDS components and tokenized props.`,path:s,component:n,token:r});return}if(Array.isArray(e)){e.forEach((t,r)=>l(t,`${s}[${r}]`,n,i));return}typeof e!="object"||e===null||Object.entries(e).forEach(([t,r])=>{if(a.has(t)){l(r,`${s}.${t}`,n,i);return}l(r,`${s}.${t}`,n,i)})},m=({tree:e})=>{const s=[],n=(i,t)=>{const r=i.props??{};Object.entries(r).forEach(([o,c])=>{if(a.has(o)){l(c,`${t}.props.${o}`,i.type,s);return}typeof c=="string"&&/\b(?:className|tailwind|tw)\b/i.test(o)&&l(c,`${t}.props.${o}`,i.type,s)}),(i.children??[]).forEach((o,c)=>n(o,`${t}.children[${c}]`))};return n(e,"root"),s};export{m as enforceTailwindDisallowRule};

package/dist/ai/policies/rules/token-variable.rules.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=/--[a-zA-Z0-9_-]+/g,u=(e,s,i,t,r,o)=>{e.push({severity:"error",code:s,message:i,path:t,component:r,token:o})},a=(e,s,i,t)=>{if(typeof e=="string"){const r=e.match(f)??[];new Set(r).forEach(n=>{n.startsWith("--uds-")||u(t,"RULE_CUSTOM_CSS_VAR_DISALLOWED",`Custom CSS variable "${n}" is not allowed. Use --uds-* variables or hardcoded literals.`,s,i,n)});return}if(Array.isArray(e)){e.forEach((r,o)=>a(r,`${s}[${o}]`,i,t));return}typeof e!="object"||e===null||Object.entries(e).forEach(([r,o])=>{r.startsWith("--")&&u(t,"RULE_CSS_VAR_DEFINITION_DISALLOWED",`Defining CSS variable "${r}" is not allowed in generated output.`,`${s}.${r}`,i,r),a(o,`${s}.${r}`,i,t)})},S=({tree:e})=>{const s=[],i=(t,r)=>{const o=t.props??{};Object.entries(o).forEach(([n,c])=>{a(c,`${r}.props.${n}`,t.type,s)}),(t.children??[]).forEach((n,c)=>i(n,`${r}.children[${c}]`))};return i(e,"root"),s};exports.enforceTokenVariableRule=S;

package/dist/ai/policies/rules/token-variable.rules.js

@@ -0,0 +1 @@
+const S=/--[a-zA-Z0-9_-]+/g,f=(t,e,i,s,r,o)=>{t.push({severity:"error",code:e,message:i,path:s,component:r,token:o})},a=(t,e,i,s)=>{if(typeof t=="string"){const r=t.match(S)??[];new Set(r).forEach(c=>{c.startsWith("--uds-")||f(s,"RULE_CUSTOM_CSS_VAR_DISALLOWED",`Custom CSS variable "${c}" is not allowed. Use --uds-* variables or hardcoded literals.`,e,i,c)});return}if(Array.isArray(t)){t.forEach((r,o)=>a(r,`${e}[${o}]`,i,s));return}typeof t!="object"||t===null||Object.entries(t).forEach(([r,o])=>{r.startsWith("--")&&f(s,"RULE_CSS_VAR_DEFINITION_DISALLOWED",`Defining CSS variable "${r}" is not allowed in generated output.`,`${e}.${r}`,i,r),a(o,`${e}.${r}`,i,s)})},u=({tree:t})=>{const e=[],i=(s,r)=>{const o=s.props??{};Object.entries(o).forEach(([c,n])=>{a(n,`${r}.props.${c}`,s.type,e)}),(s.children??[]).forEach((c,n)=>i(c,`${r}.children[${n}]`))};return i(t,"root"),e};export{u as enforceTokenVariableRule};

package/dist/ai/prompts/figma-make.prompt.md

@@ -0,0 +1,48 @@
+You are implementing UI from Figma Make using `@mich8060/unified-design-system`.
+
+Hard requirements:
+- Use only UDS components and UDS exports.
+- Do not use Tailwind classes or utility CSS.
+- Do not use ad-hoc `className` styling.
+- Do not create custom CSS variables.
+- Use only `--uds-*` variables or hardcoded literals.
+- Return deterministic JSON only.
+
+Preferred flow:
+1. Start from `@mich8060/unified-design-system/ai/templates`.
+2. Resolve remaining intent decisions using `@mich8060/unified-design-system/ai/manifest.json` -> `intentComponentMappings`.
+3. Fill template slots.
+4. Keep canonical prop names.
+5. Validate against `@mich8060/unified-design-system/ai/validation`.
+
+Starter scaffold:
+```json
+{
+  "manifestVersion": "1.0.0",
+  "governanceVersion": "1.0.0",
+  "policyVersion": "1.0.0",
+  "tree": {
+    "type": "Container",
+    "props": { "gap": "--uds-spacing-24" },
+    "children": [
+      {
+        "type": "Card",
+        "children": [
+          { "type": "Text", "props": { "variant": "heading-24", "text": "Title" } },
+          {
+            "type": "Flex",
+            "children": [
+              { "type": "Button", "props": { "appearance": "primary", "label": "Primary" } },
+              { "type": "Button", "props": { "appearance": "text", "label": "Secondary" } }
+            ]
+          }
+        ]
+      }
+    ]
+  },
+  "audit": {
+    "source": "figma-make",
+    "notes": "UDS-only generation"
+  }
+}
+```

package/dist/ai/schemas/ai-output.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "UDS AI Output",
+  "type": "object",
+  "required": [
+    "manifestVersion",
+    "governanceVersion",
+    "policyVersion",
+    "tree",
+    "audit"
+  ],
+  "properties": {
+    "manifestVersion": { "type": "string", "minLength": 1 },
+    "governanceVersion": { "type": "string", "minLength": 1 },
+    "policyVersion": { "type": "string", "minLength": 1 },
+    "tree": {
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "type": { "type": "string", "minLength": 1 },
+        "props": { "type": "object" },
+        "children": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/node" }
+        }
+      },
+      "additionalProperties": true
+    },
+    "audit": {
+      "type": "object",
+      "required": [
+        "timestamp",
+        "model",
+        "promptHash",
+        "udsVersion",
+        "manifestVersion",
+        "policyVersion",
+        "componentsUsed",
+        "tokensUsed",
+        "violationsCount",
+        "validationStatus"
+      ],
+      "properties": {
+        "timestamp": { "type": "string" },
+        "model": { "type": "string" },
+        "promptHash": { "type": "string" },
+        "udsVersion": { "type": "string" },
+        "manifestVersion": { "type": "string" },
+        "policyVersion": { "type": "string" },
+        "componentsUsed": { "type": "array", "items": { "type": "string" } },
+        "tokensUsed": { "type": "array", "items": { "type": "string" } },
+        "violationsCount": { "type": "number", "minimum": 0 },
+        "validationStatus": { "type": "string", "enum": ["pass", "fail"] }
+      },
+      "additionalProperties": true
+    }
+  },
+  "$defs": {
+    "node": {
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "type": { "type": "string", "minLength": 1 },
+        "props": { "type": "object" },
+        "children": { "type": "array", "items": { "$ref": "#/$defs/node" } }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/dist/ai/sdk/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./runtime-sdk.cjs");exports.createUDSRuntimeHelperSDK=e.createUDSRuntimeHelperSDK;

package/dist/ai/sdk/index.js

@@ -0,0 +1 @@
+import{createUDSRuntimeHelperSDK as t}from"./runtime-sdk.js";export{t as createUDSRuntimeHelperSDK};

package/dist/ai/sdk/runtime-sdk.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("../manifest/components.manifest.cjs"),u=require("../manifest/governance.manifest.cjs"),f=require("../manifest/system.manifest.cjs"),g=require("../manifest/prop-aliases.manifest.cjs"),l=require("../validation/validateAIOutput.cjs");function d(p={}){const s=p.governance??u.UDSGovernance;return{governance:s,getVersionLineage:()=>u.getVersionLineage(),getManifest:()=>f.UDSManifest,getComponent:e=>m.ComponentRegistry[e],canonicalizeProps(e,t){const i={},a={};for(const[n,o]of Object.entries(t)){const r=g.getCanonicalPropName(e,n);i[r]=o,r!==n&&(a[n]=r)}return{canonicalProps:i,aliasesApplied:a}},validate(e){return l.validateAIOutput(e,s)},validateOrThrow(e){var r,c;const t=l.validateAIOutput(e,s);if(t.status==="pass")return t;const i=`Validation failed with ${t.violations.length} error(s).`,a=((r=t.deterministicFeedback)==null?void 0:r.summary)??i,n=(c=t.deterministicFeedback)==null?void 0:c.fingerprint,o=[`[UDS AI SDK] ${a}`];throw n&&o.push(`Fingerprint: ${n}`),new Error(o.join(`
+`))}}}exports.createUDSRuntimeHelperSDK=d;

package/dist/ai/sdk/runtime-sdk.js

@@ -0,0 +1,2 @@
+import{ComponentRegistry as l}from"../manifest/components.manifest.js";import{UDSGovernance as f,getVersionLineage as g}from"../manifest/governance.manifest.js";import{UDSManifest as u}from"../manifest/system.manifest.js";import{getCanonicalPropName as d}from"../manifest/prop-aliases.manifest.js";import{validateAIOutput as m}from"../validation/validateAIOutput.js";function b(p={}){const s=p.governance??f;return{governance:s,getVersionLineage:()=>g(),getManifest:()=>u,getComponent:e=>l[e],canonicalizeProps(e,n){const i={},o={};for(const[t,a]of Object.entries(n)){const r=d(e,t);i[r]=a,r!==t&&(o[t]=r)}return{canonicalProps:i,aliasesApplied:o}},validate(e){return m(e,s)},validateOrThrow(e){var r,c;const n=m(e,s);if(n.status==="pass")return n;const i=`Validation failed with ${n.violations.length} error(s).`,o=((r=n.deterministicFeedback)==null?void 0:r.summary)??i,t=(c=n.deterministicFeedback)==null?void 0:c.fingerprint,a=[`[UDS AI SDK] ${o}`];throw t&&a.push(`Fingerprint: ${t}`),new Error(a.join(`
+`))}}}export{b as createUDSRuntimeHelperSDK};

package/dist/ai/templates/layouts.json

@@ -0,0 +1,416 @@
+{
+  "contractName": "uds.ai.layout-templates",
+  "schemaVersion": "1.0.0",
+  "templates": [
+    {
+      "id": "auth-form-card",
+      "intent": "Authentication form with one primary action and optional secondary action.",
+      "tags": [
+        "form",
+        "auth",
+        "card"
+      ],
+      "slots": {
+        "title": "Sign in",
+        "subtitle": "Use your work account",
+        "primaryActionLabel": "Sign in",
+        "secondaryActionLabel": "Forgot password?"
+      },
+      "tree": {
+        "type": "Container",
+        "props": {
+          "gap": "--uds-spacing-24"
+        },
+        "children": [
+          {
+            "type": "Card",
+            "children": [
+              {
+                "type": "Text",
+                "props": {
+                  "variant": "heading-24",
+                  "text": "{{title}}"
+                }
+              },
+              {
+                "type": "Text",
+                "props": {
+                  "variant": "body-16",
+                  "text": "{{subtitle}}"
+                }
+              },
+              {
+                "type": "Field",
+                "children": [
+                  {
+                    "type": "TextInput",
+                    "props": {
+                      "type": "email"
+                    }
+                  }
+                ]
+              },
+              {
+                "type": "Field",
+                "children": [
+                  {
+                    "type": "TextInput",
+                    "props": {
+                      "type": "password"
+                    }
+                  }
+                ]
+              },
+              {
+                "type": "Flex",
+                "children": [
+                  {
+                    "type": "Button",
+                    "props": {
+                      "appearance": "primary",
+                      "label": "{{primaryActionLabel}}"
+                    }
+                  },
+                  {
+                    "type": "Button",
+                    "props": {
+                      "appearance": "text",
+                      "label": "{{secondaryActionLabel}}"
+                    }
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      },
+      "constraints": [
+        "Keep max one primary Button in the section.",
+        "Wrap all form controls with Field."
+      ],
+      "priority": "first-choice",
+      "recommendedFor": [
+        "figma-make"
+      ]
+    },
+    {
+      "id": "dashboard-table-summary",
+      "intent": "Summary header with data table and row actions.",
+      "tags": [
+        "dashboard",
+        "table",
+        "summary"
+      ],
+      "slots": {
+        "heading": "Open Requests",
+        "primaryActionLabel": "Create request"
+      },
+      "tree": {
+        "type": "Container",
+        "props": {
+          "gap": "--uds-spacing-16"
+        },
+        "children": [
+          {
+            "type": "Flex",
+            "children": [
+              {
+                "type": "Text",
+                "props": {
+                  "variant": "heading-24",
+                  "text": "{{heading}}"
+                }
+              },
+              {
+                "type": "Button",
+                "props": {
+                  "appearance": "primary",
+                  "label": "{{primaryActionLabel}}"
+                }
+              }
+            ]
+          },
+          {
+            "type": "Table",
+            "children": [
+              {
+                "type": "Status",
+                "props": {
+                  "variant": "success",
+                  "text": "Ready"
+                }
+              },
+              {
+                "type": "Tag",
+                "props": {
+                  "color": "blue",
+                  "label": "Active"
+                }
+              },
+              {
+                "type": "ActionMenu",
+                "props": {
+                  "triggerLabel": "Row actions"
+                }
+              }
+            ]
+          }
+        ]
+      },
+      "constraints": [
+        "Only use allowed Table children (Tag, Status, Avatar, Button, ActionMenu, ProgressIndicator, DotStatus)."
+      ],
+      "priority": "first-choice",
+      "recommendedFor": [
+        "figma-make"
+      ]
+    },
+    {
+      "id": "settings-two-column",
+      "intent": "Two-column settings page with form area and contextual summary card.",
+      "tags": [
+        "settings",
+        "form",
+        "two-column"
+      ],
+      "slots": {
+        "pageTitle": "Account Settings",
+        "saveLabel": "Save changes"
+      },
+      "tree": {
+        "type": "Container",
+        "props": {
+          "gap": "--uds-spacing-24"
+        },
+        "children": [
+          {
+            "type": "Text",
+            "props": {
+              "variant": "heading-24",
+              "text": "{{pageTitle}}"
+            }
+          },
+          {
+            "type": "Flex",
+            "props": {
+              "gap": "--uds-spacing-24"
+            },
+            "children": [
+              {
+                "type": "Card",
+                "children": [
+                  {
+                    "type": "Field",
+                    "children": [
+                      {
+                        "type": "TextInput",
+                        "props": {
+                          "type": "text"
+                        }
+                      }
+                    ]
+                  },
+                  {
+                    "type": "Field",
+                    "children": [
+                      {
+                        "type": "Dropdown"
+                      }
+                    ]
+                  },
+                  {
+                    "type": "Button",
+                    "props": {
+                      "appearance": "primary",
+                      "label": "{{saveLabel}}"
+                    }
+                  }
+                ]
+              },
+              {
+                "type": "Card",
+                "children": [
+                  {
+                    "type": "Text",
+                    "props": {
+                      "variant": "body-16",
+                      "text": "Changes apply to your profile."
+                    }
+                  },
+                  {
+                    "type": "Tag",
+                    "props": {
+                      "color": "neutral",
+                      "label": "Profile"
+                    }
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      },
+      "constraints": [
+        "Avoid multiple primary buttons in the same section.",
+        "Use spacing tokens from the governed spacing system."
+      ],
+      "priority": "first-choice",
+      "recommendedFor": [
+        "figma-make"
+      ]
+    },
+    {
+      "id": "modal-confirmation",
+      "intent": "Confirmation flow in modal with primary and dismissive actions.",
+      "tags": [
+        "modal",
+        "confirmation",
+        "destructive"
+      ],
+      "slots": {
+        "title": "Delete item?",
+        "body": "This action cannot be undone.",
+        "confirmLabel": "Delete",
+        "cancelLabel": "Cancel"
+      },
+      "tree": {
+        "type": "Modal",
+        "children": [
+          {
+            "type": "Text",
+            "props": {
+              "variant": "heading-24",
+              "text": "{{title}}"
+            }
+          },
+          {
+            "type": "Text",
+            "props": {
+              "variant": "body-16",
+              "text": "{{body}}"
+            }
+          },
+          {
+            "type": "Flex",
+            "children": [
+              {
+                "type": "Button",
+                "props": {
+                  "appearance": "text",
+                  "label": "{{cancelLabel}}"
+                }
+              },
+              {
+                "type": "Button",
+                "props": {
+                  "appearance": "destructive",
+                  "label": "{{confirmLabel}}"
+                }
+              }
+            ]
+          }
+        ]
+      },
+      "constraints": [
+        "Do not nest Modal inside Modal.",
+        "Keep one destructive primary-like action."
+      ],
+      "priority": "first-choice",
+      "recommendedFor": [
+        "figma-make"
+      ]
+    },
+    {
+      "id": "wizard-steps-form",
+      "intent": "Multi-step form shell with progress indicator and staged actions.",
+      "tags": [
+        "wizard",
+        "steps",
+        "form"
+      ],
+      "slots": {
+        "title": "Create Job Posting",
+        "nextLabel": "Next",
+        "backLabel": "Back"
+      },
+      "tree": {
+        "type": "Container",
+        "children": [
+          {
+            "type": "Text",
+            "props": {
+              "variant": "heading-24",
+              "text": "{{title}}"
+            }
+          },
+          {
+            "type": "Steps"
+          },
+          {
+            "type": "Card",
+            "children": [
+              {
+                "type": "Field",
+                "children": [
+                  {
+                    "type": "TextInput",
+                    "props": {
+                      "type": "text"
+                    }
+                  }
+                ]
+              },
+              {
+                "type": "Field",
+                "children": [
+                  {
+                    "type": "Textarea"
+                  }
+                ]
+              },
+              {
+                "type": "Flex",
+                "children": [
+                  {
+                    "type": "Button",
+                    "props": {
+                      "appearance": "text",
+                      "label": "{{backLabel}}"
+                    }
+                  },
+                  {
+                    "type": "Button",
+                    "props": {
+                      "appearance": "primary",
+                      "label": "{{nextLabel}}"
+                    }
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      },
+      "constraints": [
+        "Fields must contain form controls.",
+        "Keep one primary action for each step section."
+      ],
+      "priority": "first-choice",
+      "recommendedFor": [
+        "figma-make"
+      ]
+    }
+  ],
+  "selectionPolicy": {
+    "mode": "template-first",
+    "recommendedFor": [
+      "figma-make"
+    ],
+    "fallback": "Only use freeform composition when no template intent matches.",
+    "guards": [
+      "Use UDS components only.",
+      "Do not use Tailwind utilities or className styling.",
+      "Use --uds-* tokens or hardcoded literals only."
+    ]
+  }
+}

package/dist/ai/validation/deterministicFeedback.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const I={SCHEMA_NODE_OBJECT:"Return each tree node as an object with type/props/children keys.",SCHEMA_NODE_TYPE:"Set node.type to a non-empty UDS component name.",SCHEMA_NODE_PROPS:"Provide node.props as a plain object.",SCHEMA_NODE_CHILDREN:"Provide node.children as an array of child nodes.",RULE_UNKNOWN_COMPONENT:"Replace unknown components with supported UDS components.",RULE_RAW_HTML_DISALLOWED:"Use UDS components instead of raw HTML tags.",RULE_INVALID_COMPOSITION:"Use only allowed child components for the parent component.",RULE_INVALID_PARENT_COMPOSITION:"Move the component under one of its allowed parent components.",RULE_DISALLOWED_NESTING:"Remove or refactor disallowed parent/child nesting.",RULE_MAX_PRIMARY_ACTIONS:"Keep at most one primary Button per section.",RULE_SPACING_TOKEN_ONLY:"Use --uds-spacing-* tokens for spacing-related props.",RULE_UNKNOWN_SPACING_TOKEN:"Replace unknown spacing token with an allowed spacing token.",RULE_CUSTOM_CSS_VAR_DISALLOWED:"Use only --uds-* CSS variables or hardcoded literals.",RULE_CSS_VAR_DEFINITION_DISALLOWED:"Do not define CSS custom properties in generated output.",RULE_TAILWIND_CLASS_DISALLOWED:"Remove Tailwind utilities and use UDS components/tokens instead.",RULE_AMBIGUOUS_PROP_ALIAS:"Replace ambiguous alias props with canonical prop names.",RULE_VERSION_MISMATCH_MANIFESTVERSION:"Set manifestVersion to the current manifest contract version.",RULE_VERSION_MISMATCH_GOVERNANCEVERSION:"Set governanceVersion to the current governance version.",RULE_VERSION_MISMATCH_POLICYVERSION:"Set policyVersion to the current policy version.",RULE_MAX_NESTING_DEPTH:"Reduce UI nesting depth to stay within governance limits.",RULE_INLINE_STYLE_DISALLOWED:"Remove inline styles and use tokenized component props.",DRIFT_UNKNOWN_COMPONENT:"Align with ComponentRegistry component names.",DRIFT_DISALLOWED_NESTING:"Align nesting with layout disallowed pair rules.",DRIFT_MARGIN_USAGE:"Replace margin usage with composition spacing tokens.",DRIFT_INLINE_STYLE:"Replace inline style usage with UDS tokenized styling.",DRIFT_UNKNOWN_TOKEN:"Use a known token from the published UDS token contract.",DRIFT_HARDCODED_COLOR:"Replace color literals with semantic UDS tokens."},r=(e,t)=>String(e??"").localeCompare(String(t??"")),c=e=>[e.severity,e.code,e.path,e.component??"",e.token??"",e.message].join("|"),E=e=>{let t=2166136261;for(let i=0;i<e.length;i+=1)t^=e.charCodeAt(i),t=Math.imul(t,16777619);return(t>>>0).toString(16).padStart(8,"0")};function N(e){const t=[...e].sort((n,o)=>{const s=r(n.severity,o.severity);if(s!==0)return s;const p=r(n.code,o.code);if(p!==0)return p;const _=r(n.path,o.path);if(_!==0)return _;const d=r(n.component,o.component);if(d!==0)return d;const S=r(n.token,o.token);return S!==0?S:r(n.message,o.message)}),i=[],a=new Set;for(const n of t){const o=c(n);a.has(o)||(a.add(o),i.push(n))}return i}function l(e){const t=N(e),i=t.map(c).join("||"),a=`fb-${E(i)}`,n=t.map(s=>({id:`${s.code}:${s.path}:${E(c(s))}`,code:s.code,path:s.path,message:s.message,fix:I[s.code]??"Apply governance-compliant correction for this violation.",severity:s.severity})),o=`${n.length} deterministic violation(s)`;return{fingerprint:a,summary:o,items:n}}exports.buildDeterministicFeedback=l;exports.sortAndDedupeViolations=N;

package/dist/ai/validation/deterministicFeedback.js

@@ -0,0 +1 @@
+const N={SCHEMA_NODE_OBJECT:"Return each tree node as an object with type/props/children keys.",SCHEMA_NODE_TYPE:"Set node.type to a non-empty UDS component name.",SCHEMA_NODE_PROPS:"Provide node.props as a plain object.",SCHEMA_NODE_CHILDREN:"Provide node.children as an array of child nodes.",RULE_UNKNOWN_COMPONENT:"Replace unknown components with supported UDS components.",RULE_RAW_HTML_DISALLOWED:"Use UDS components instead of raw HTML tags.",RULE_INVALID_COMPOSITION:"Use only allowed child components for the parent component.",RULE_INVALID_PARENT_COMPOSITION:"Move the component under one of its allowed parent components.",RULE_DISALLOWED_NESTING:"Remove or refactor disallowed parent/child nesting.",RULE_MAX_PRIMARY_ACTIONS:"Keep at most one primary Button per section.",RULE_SPACING_TOKEN_ONLY:"Use --uds-spacing-* tokens for spacing-related props.",RULE_UNKNOWN_SPACING_TOKEN:"Replace unknown spacing token with an allowed spacing token.",RULE_CUSTOM_CSS_VAR_DISALLOWED:"Use only --uds-* CSS variables or hardcoded literals.",RULE_CSS_VAR_DEFINITION_DISALLOWED:"Do not define CSS custom properties in generated output.",RULE_TAILWIND_CLASS_DISALLOWED:"Remove Tailwind utilities and use UDS components/tokens instead.",RULE_AMBIGUOUS_PROP_ALIAS:"Replace ambiguous alias props with canonical prop names.",RULE_VERSION_MISMATCH_MANIFESTVERSION:"Set manifestVersion to the current manifest contract version.",RULE_VERSION_MISMATCH_GOVERNANCEVERSION:"Set governanceVersion to the current governance version.",RULE_VERSION_MISMATCH_POLICYVERSION:"Set policyVersion to the current policy version.",RULE_MAX_NESTING_DEPTH:"Reduce UI nesting depth to stay within governance limits.",RULE_INLINE_STYLE_DISALLOWED:"Remove inline styles and use tokenized component props.",DRIFT_UNKNOWN_COMPONENT:"Align with ComponentRegistry component names.",DRIFT_DISALLOWED_NESTING:"Align nesting with layout disallowed pair rules.",DRIFT_MARGIN_USAGE:"Replace margin usage with composition spacing tokens.",DRIFT_INLINE_STYLE:"Replace inline style usage with UDS tokenized styling.",DRIFT_UNKNOWN_TOKEN:"Use a known token from the published UDS token contract.",DRIFT_HARDCODED_COLOR:"Replace color literals with semantic UDS tokens."},i=(e,t)=>String(e??"").localeCompare(String(t??"")),c=e=>[e.severity,e.code,e.path,e.component??"",e.token??"",e.message].join("|"),E=e=>{let t=2166136261;for(let r=0;r<e.length;r+=1)t^=e.charCodeAt(r),t=Math.imul(t,16777619);return(t>>>0).toString(16).padStart(8,"0")};function I(e){const t=[...e].sort((n,o)=>{const s=i(n.severity,o.severity);if(s!==0)return s;const p=i(n.code,o.code);if(p!==0)return p;const _=i(n.path,o.path);if(_!==0)return _;const S=i(n.component,o.component);if(S!==0)return S;const d=i(n.token,o.token);return d!==0?d:i(n.message,o.message)}),r=[],a=new Set;for(const n of t){const o=c(n);a.has(o)||(a.add(o),r.push(n))}return r}function R(e){const t=I(e),r=t.map(c).join("||"),a=`fb-${E(r)}`,n=t.map(s=>({id:`${s.code}:${s.path}:${E(c(s))}`,code:s.code,path:s.path,message:s.message,fix:N[s.code]??"Apply governance-compliant correction for this violation.",severity:s.severity})),o=`${n.length} deterministic violation(s)`;return{fingerprint:a,summary:o,items:n}}export{R as buildDeterministicFeedback,I as sortAndDedupeViolations};

package/dist/ai/validation/driftDetection.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("../manifest/components.manifest.cjs"),p=require("../manifest/layout.manifest.cjs"),a=require("../manifest/tokens.intent.manifest.cjs"),f=/#(?:[a-fA-F0-9]{3,8})\b|rgb\(|rgba\(|hsl\(|hsla\(/,y=new Set([...p.LayoutRules.spacingSystem.allowedTokens,...Object.values(a.TokenIntentMap.surface),...Object.values(a.TokenIntentMap.action),...Object.values(a.TokenIntentMap.text),...Object.values(a.TokenIntentMap.border),...Object.values(a.TokenIntentMap.state),"--uds-radius-8","--uds-elevation-overlay"]),i=(l,n,c,t,o,r)=>{l.push({severity:"warning",code:n,message:c,path:t,component:o,token:r})};function T(l){const n=[],c=(t,o,r)=>{d.ComponentRegistry[t.type]||i(n,"DRIFT_UNKNOWN_COMPONENT",`Component "${t.type}" is not in ComponentRegistry.`,o,t.type),r&&p.LayoutRules.disallowedNesting.some(e=>e.parent===r.type&&e.child===t.type)&&i(n,"DRIFT_DISALLOWED_NESTING",`${t.type} nested inside ${r.type} violates layout rules.`,o,t.type);const u=t.props??{};Object.entries(u).forEach(([s,e])=>{s.toLowerCase().startsWith("margin")&&i(n,"DRIFT_MARGIN_USAGE","Margin usage detected. Prefer governed spacing composition tokens.",`${o}.${s}`,t.type),(s==="style"||s==="inlineStyle")&&i(n,"DRIFT_INLINE_STYLE","Inline CSS detected. Use tokenized props or class-based styling.",`${o}.${s}`,t.type),typeof e=="string"&&(e.startsWith("--uds-")&&!y.has(e)&&i(n,"DRIFT_UNKNOWN_TOKEN",`Unknown UDS token "${e}".`,`${o}.${s}`,t.type,e),f.test(e)&&i(n,"DRIFT_HARDCODED_COLOR","Hardcoded color literal detected. Use semantic UDS token values.",`${o}.${s}`,t.type))}),(t.children??[]).forEach((s,e)=>c(s,`${o}.children[${e}]`,t))};return c(l,"root"),n}exports.detectDrift=T;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("../manifest/components.manifest.cjs"),p=require("../manifest/layout.manifest.cjs"),r=require("../manifest/tokens.intent.manifest.cjs"),f=new Set([...p.LayoutRules.spacingSystem.allowedTokens,...Object.values(r.TokenIntentMap.surface),...Object.values(r.TokenIntentMap.action),...Object.values(r.TokenIntentMap.text),...Object.values(r.TokenIntentMap.border),...Object.values(r.TokenIntentMap.state),"--uds-radius-8","--uds-elevation-overlay"]),a=(l,n,c,t,i,o)=>{l.push({severity:"warning",code:n,message:c,path:t,component:i,token:o})};function d(l){const n=[],c=(t,i,o)=>{y.ComponentRegistry[t.type]||a(n,"DRIFT_UNKNOWN_COMPONENT",`Component "${t.type}" is not in ComponentRegistry.`,i,t.type),o&&p.LayoutRules.disallowedNesting.some(e=>e.parent===o.type&&e.child===t.type)&&a(n,"DRIFT_DISALLOWED_NESTING",`${t.type} nested inside ${o.type} violates layout rules.`,i,t.type);const u=t.props??{};Object.entries(u).forEach(([s,e])=>{s.toLowerCase().startsWith("margin")&&a(n,"DRIFT_MARGIN_USAGE","Margin usage detected. Prefer governed spacing composition tokens.",`${i}.${s}`,t.type),(s==="style"||s==="inlineStyle")&&a(n,"DRIFT_INLINE_STYLE","Inline CSS detected. Use tokenized props or class-based styling.",`${i}.${s}`,t.type),typeof e=="string"&&e.startsWith("--uds-")&&!f.has(e)&&a(n,"DRIFT_UNKNOWN_TOKEN",`Unknown UDS token "${e}".`,`${i}.${s}`,t.type,e)}),(t.children??[]).forEach((s,e)=>c(s,`${i}.children[${e}]`,t))};return c(l,"root"),n}exports.detectDrift=d;