@utopia-studio-design/design-system-cli 0.7.0 → 0.7.1

package/data/docs/ceramic-release-2026-09-06.md

@@ -0,0 +1,11 @@
+# Ceramic QA repair release — 2026-09-06
+
+Release branch: `codex/qa-fixes-round-12`.
+
+Includes the accumulated documented QA repairs through Round 12, plus the shared no-scrollbar-chrome contract. Native wheel, touch and keyboard scrolling remain enabled. Studio tabs and combobox hover states no longer opt back into visible scrollbars.
+
+Development validation: Vitest 13 files / 79 tests passed; CLI generation and MCP protocol, component contracts, semantic page ownership and workspace setup audits passed. Generated Dashboard Composer consumer build passed. Playwright asset concurrency, validation, retry and scrollbar regression suites: 20 passed across desktop/mobile Chromium and English/Arabic scrollbar cases. An initial run was interrupted by concurrent package rebuild; the isolated rerun passed all 20 cases.
+
+Rams quick_review was attempted but the workspace review credits were exhausted. The pre-commit review_files attempt failed at the provider transport; no score was obtained.
+
+This release does not mark independent QA reports closed. Server Designer Agent activation remains disabled under the existing production configuration.

package/lib/template-runtime.mjs

@@ -1 +1,56 @@
-export * from '../../design-system/src/lib/template-runtime.mjs'
+export const TEMPLATE_MODES = ['exact', 'adapt', 'explore']
+
+const MODE_POLICIES = {
+  exact: {
+    locked: ['sectionOrder', 'componentTree', 'layoutGrid', 'spacingScale', 'typeScale', 'responsiveRules'],
+    editable: ['content', 'media', 'approvedData'],
+  },
+  adapt: {
+    locked: ['sectionOrder', 'componentTree', 'layoutGrid', 'responsiveRules'],
+    editable: ['content', 'media', 'semanticTheme', 'approvedVariants', 'approvedData'],
+  },
+  explore: {
+    locked: ['semanticRoles', 'accessibility', 'componentAllowlist'],
+    editable: ['content', 'media', 'semanticTheme', 'approvedVariants', 'sectionOrder', 'optionalSections'],
+  },
+}
+
+export function resolveTemplateContract(template, { mode = 'adapt', theme = 'utopia-default' } = {}) {
+  if (!TEMPLATE_MODES.includes(mode)) throw new Error(`Unknown template mode "${mode}".`)
+  const contract = template.executionContract
+  if (!contract) throw new Error(`Template "${template.id}" has no executionContract.`)
+  const modePolicy = contract.modes?.[mode] ?? MODE_POLICIES[mode]
+  return {
+    apiVersion: 1,
+    templateId: template.id,
+    mode,
+    theme,
+    locked: [...new Set([...(contract.alwaysLocked ?? []), ...(modePolicy.locked ?? [])])],
+    editable: modePolicy.editable ?? [],
+    componentAllowlist: contract.componentAllowlist ?? [],
+    tokenPolicy: contract.tokenPolicy,
+    contentPolicy: contract.contentPolicy,
+    validation: contract.validation,
+  }
+}
+
+export function validateTemplateArtifact(contract, artifact) {
+  const errors = []
+  const allowed = new Set(contract.componentAllowlist ?? [])
+  for (const component of artifact.components ?? []) {
+    if (allowed.size && !allowed.has(component)) errors.push(`Unknown component: ${component}`)
+  }
+  if (contract.validation?.allowAdHocColors === false && (artifact.adHocColors?.length ?? 0) > 0) {
+    errors.push('Ad-hoc colors are not allowed.')
+  }
+  if (contract.validation?.allowAdHocSpacing === false && (artifact.adHocSpacing?.length ?? 0) > 0) {
+    errors.push('Ad-hoc spacing is not allowed.')
+  }
+  if (contract.locked.includes('sectionOrder') && artifact.sectionOrder) {
+    const expected = contract.contentPolicy?.sectionOrder ?? []
+    if (expected.length && JSON.stringify(expected) !== JSON.stringify(artifact.sectionOrder)) {
+      errors.push('Section order violates the template contract.')
+    }
+  }
+  return { ok: errors.length === 0, errors }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utopia-studio-design/design-system-cli",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "AI-readable CLI and MCP server for Ceramic Design System",
   "ceramic": {
     "designSystem": "^0.9.1"