npm - @utopia-studio-design/design-system-cli - Versions diffs - 0.6.1 → 0.7.0 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (123) hide show

package/data/templates/saas-solution-homepage/template.manifest.json CHANGED Viewed

@@ -19,8 +19,11 @@
     { "id": "customers", "path": "customers/index.html", "purpose": "Customer proof library" },
     { "id": "customer-story", "path": "customers/aster-labs/index.html", "purpose": "Long-form customer case study" },
     { "id": "pricing", "path": "pricing/index.html", "purpose": "Plans, comparison, and FAQ" },
+    { "id": "team", "path": "team/index.html", "purpose": "Company story, operating principles, team profiles, and recruiting CTA" },
     { "id": "changelog", "path": "changelog/index.html", "purpose": "Product update timeline" },
     { "id": "contact-sales", "path": "contact-sales/index.html", "purpose": "Sales qualification form and success state" }
+    ,{ "id": "terms", "path": "terms/index.html", "purpose": "Terms of Use legal template" }
+    ,{ "id": "privacy", "path": "privacy/index.html", "purpose": "Privacy Policy legal template" }
   ],
   "features": { "lightDark": true, "rtl": true, "responsive": true, "seededDemoData": true, "scrollAwareNavigation": true, "reducedMotion": true },
   "useWhen": ["A SaaS product needs a complete product-led marketing narrative", "A real interface preview can carry the product proof", "Automation, integrations, and reliability are material buying criteria"],
@@ -32,5 +35,43 @@
     "default": "utopia-default",
     "generationFlag": "--theme <id>",
     "ownership": "The active theme owns dark/light semantic mappings; the template owns no brand primitives."
+  },
+  "executionContract": {
+    "defaultMode": "adapt",
+    "alwaysLocked": ["semanticRoles", "accessibility", "componentAllowlist"],
+    "modes": {
+      "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": [],
+        "editable": ["content", "media", "semanticTheme", "approvedVariants", "sectionOrder", "optionalSections"]
+      }
+    },
+    "componentAllowlist": ["TopNav", "TopNavItem", "Button", "Badge", "Card", "CardContent", "CardDescription", "CardHeader", "CardTitle", "Select", "SelectContent", "SelectItem", "SelectTrigger", "SelectValue", "Textarea", "TextInput", "MotionProvider"],
+    "tokenPolicy": {
+      "mapping": "semantic-role-only",
+      "allowedNamespaces": ["background", "foreground", "surface", "border", "primary", "secondary", "muted", "ring", "radius-*", "space-*", "font-*", "motion-*"],
+      "forbidRawBrandPrimitives": true
+    },
+    "contentPolicy": {
+      "sectionOrder": ["Hero", "Product interface preview", "Core workflow", "Agents and automation", "Integrations", "Security and reliability", "Team proof", "Adoption CTA", "Footer"],
+      "headlineMaxLines": 3,
+      "ctaCount": { "min": 1, "max": 2 },
+      "mediaRoles": ["product-proof", "workflow-explanation", "customer-proof"]
+    },
+    "validation": {
+      "allowUnknownComponents": false,
+      "allowAdHocColors": false,
+      "allowAdHocSpacing": false,
+      "requireResponsiveRules": true,
+      "requireReducedMotion": true,
+      "requireRTL": true
+    }
   }
 }

package/data/templates/saas-solution-homepage/terms/index.html ADDED Viewed

@@ -0,0 +1 @@

+ <!doctype html><html lang="en" dir="ltr" data-theme="utopia-default" data-color-mode="dark"><head><meta charset="UTF-8" /><meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="color-scheme" content="dark light" /><style>html{color-scheme:dark}html[data-color-mode="light"]{color-scheme:light}html,body,#root{min-block-size:100%;margin:0;background:Canvas;color:CanvasText}</style><script>try{const mode=localStorage.getItem("ceramic-saas-mode");const locale=localStorage.getItem("ceramic-saas-locale");if(mode==="light")document.documentElement.dataset.colorMode="light";if(locale==="ar"){document.documentElement.lang="ar";document.documentElement.dir="rtl"}}catch{}</script><meta name="description" content="Terms of Use template." /><title>Terms of Use — SaaS Solution Template</title></head><body><a class="skip-link" href="#main-content">Skip to content</a><div id="root"></div><script type="module" src="../main.tsx"></script></body></html>

package/lib/api.mjs CHANGED Viewed

@@ -130,6 +130,44 @@ export function getMotionProfile(name) {
   return profile ? { ...profile, adapters: registry.adapters, contract: registry.contract } : null
 }
+export function getLogoSkillRegistry() {
+  return readJson(join(paths().manifests, 'logo-skills.json'))
+}
+export function listLogoSkills() {
+  return getLogoSkillRegistry().skills
+}
+export function getLogoSkill(name) {
+  const key = normalize(name)
+  return listLogoSkills().find((item) => normalize(item.id) === key || normalize(item.name) === key) ?? null
+}
+export function prepareLogoMakerRun({ skillId, brandName, brief, referenceIds = [] }, root = process.cwd()) {
+  const skill = getLogoSkill(skillId)
+  if (!skill) return { ok: false, code: 'UNKNOWN_LOGO_SKILL', message: `Unknown logo skill "${skillId}".`, allowedSkillIds: listLogoSkills().map((item) => item.id) }
+  const room = getRoomContext(root)
+  const resolvedBrandName = String(brandName || room?.brandName || '').trim()
+  const resolvedBrief = String(brief || '').trim()
+  if (!resolvedBrandName) return { ok: false, code: 'BRAND_NAME_REQUIRED', message: 'Provide brandName or connect a Ceramic Brand Room.' }
+  if (resolvedBrief.length < 12) return { ok: false, code: 'BRIEF_TOO_SHORT', message: 'Provide at least 12 characters of design intent.' }
+  const references = Array.isArray(referenceIds) ? referenceIds.filter((value) => typeof value === 'string').slice(0, 3) : []
+  const registry = getLogoSkillRegistry()
+  const prompt = [`Create a professional ${skill.name} logo design concept for the following brand: ${resolvedBrandName}. ${resolvedBrief}`, '', 'Design requirements:', ...skill.requirements.map((requirement) => `- ${requirement}`)].join('\n')
+  return {
+    ok: true,
+    toolId: 'logo-maker',
+    logoSkillId: skill.id,
+    room,
+    input: { brandName: resolvedBrandName, brief: resolvedBrief, referenceIds: references },
+    prompt,
+    qualityFramework: registry.qualityFramework,
+    review: { required: true, policy: registry.qualityFramework.approvalPolicy, referencePolicy: registry.workflow.referencePolicy },
+    workflow: registry.workflow.sequence,
+    nextAction: 'Generate a draft from this prompt, present it as a proposal, and request human review before checkpointing an approved artifact.',
+  }
+}
 export function listDocs() {
   return readdirSync(paths().docs)
     .filter((name) => name.endsWith('.md'))
@@ -143,6 +181,14 @@ export function getDoc(topic) {
   return { topic: match, content: readFileSync(join(paths().docs, `${match}.md`), 'utf8') }
 }
+export function getRoomContext(root = process.cwd()) {
+  const roomPath = join(resolve(root), '.ceramic', 'room.json')
+  if (!existsSync(roomPath)) return null
+  const room = readJson(roomPath)
+  if (room?.apiVersion !== 1 || typeof room?.id !== 'string' || typeof room?.brandName !== 'string') return null
+  return room
+}
 export function search(query) {
   const terms = String(query).toLowerCase().split(/\s+/).filter(Boolean)
   const score = (text) => terms.reduce((total, term) => total + (text.toLowerCase().includes(term) ? 1 : 0), 0)
@@ -153,6 +199,7 @@ export function search(query) {
     ...listTemplates().map((item) => ({ kind: 'template', id: item.id, title: item.title, summary: `${item.category} ${item.purpose}`, item })),
     ...listThemes().map((item) => ({ kind: 'theme', id: item.id, title: item.name, summary: item.role, item })),
     ...listMotionProfiles().map((item) => ({ kind: 'motion-profile', id: item.id, title: item.label, summary: `${item.description} ${item.rules.join(' ')}`, item })),
+    ...listLogoSkills().map((item) => ({ kind: 'logo-skill', id: item.id, title: item.name, summary: `${item.tagline} ${item.description} ${item.guidance}`, item })),
     ...listDocs().map((topic) => ({ kind: 'docs', id: topic, title: topic, summary: getDoc(topic)?.content.slice(0, 500) ?? '', item: { topic } })),
   ]
   return results
@@ -174,14 +221,16 @@ export function capabilityManifest() {
     ],
     commands: [
       { name: 'init', args: ['[directory]'], flags: ['--yes', '--theme <id>'], responseType: 'init-result' },
+      { name: 'room', args: ['connect'], flags: ['--id <id>', '--slug <slug>', '--name <room>', '--brand <brand>', '--source <mode>', '--client <client>', '--directory <path>'], responseType: 'room-connect-result' },
       { name: 'search', args: ['<query>'], flags: [], responseType: 'search-results' },
       { name: 'component', args: ['<name>|--list'], flags: [], responseType: 'component|component-list' },
       { name: 'registry', args: ['<block-id>|--list'], flags: ['--renderable'], responseType: 'block-definition|block-definition-list' },
       { name: 'layout', args: ['validate <file>', 'serialize <file>'], flags: [], responseType: 'layout-validation-result|layout-serialization-result' },
       { name: 'block', args: ['<id>|--list'], flags: ['--copy <directory>', '--force'], responseType: 'block|block-list|block-copy-result' },
-      { name: 'template', args: ['<id>|--list', 'validate [directory]', 'submit [directory]'], flags: ['--skeleton', '--copy <directory>', '--theme <id>', '--force'], responseType: 'template|template-list|template-copy-result|template-validation-result|template-submit-result' },
+      { name: 'template', args: ['<id>|--list', 'validate [directory]', 'submit [directory]'], flags: ['--skeleton', '--copy <directory>', '--theme <id>', '--mode <exact|adapt|explore>', '--force'], responseType: 'template|template-list|template-copy-result|template-validation-result|template-submit-result' },
       { name: 'theme', args: ['<id>|--list', 'create <id> [directory]'], flags: ['--force'], responseType: 'theme|theme-list|theme-create-result' },
       { name: 'motion', args: ['<id>|--list'], flags: [], responseType: 'motion-profile|motion-profile-list' },
+      { name: 'logo-skill', args: ['<id>|--list'], flags: [], responseType: 'logo-skill|logo-skill-list' },
       { name: 'docs', args: ['<topic>|--list'], flags: [], responseType: 'docs|docs-list' },
       { name: 'manifest', args: [], flags: [], responseType: 'manifest' },
       { name: 'doctor', args: [], flags: [], responseType: 'doctor-result' },
@@ -189,14 +238,14 @@ export function capabilityManifest() {
     ],
     mcp: {
       ...mcpLaunch,
-      tools: ['search', 'list_components', 'get_component', 'list_block_definitions', 'get_block_definition', 'validate_layout', 'validate_agent_layout_mutation', 'list_blocks', 'get_block', 'list_templates', 'get_template', 'list_themes', 'get_theme', 'list_motion_profiles', 'get_motion_profile', 'list_docs', 'get_docs', 'doctor'],
+      tools: ['get_room_context', 'search', 'list_components', 'get_component', 'list_block_definitions', 'get_block_definition', 'validate_layout', 'validate_agent_layout_mutation', 'list_blocks', 'get_block', 'list_templates', 'get_template', 'list_themes', 'get_theme', 'list_motion_profiles', 'get_motion_profile', 'list_logo_skills', 'get_logo_skill', 'prepare_logo_maker_run', 'list_docs', 'get_docs', 'doctor'],
     },
   }
 }
 export function repositoryDoctor() {
   const required = [
-    'catalog.json', 'components.json', 'blocks.json', 'composition-registry.json', 'templates.json', 'themes.json', 'motion-profiles.json',
+    'catalog.json', 'components.json', 'blocks.json', 'composition-registry.json', 'templates.json', 'themes.json', 'motion-profiles.json', 'logo-skills.json',
   ].map((name) => join(paths().manifests, name))
   const docs = ['quick-start-ai', 'arabic-friendly', 'theme-authoring', 'composition-registry'].map((name) => join(paths().docs, `${name}.md`))
   const missing = [...required, ...docs].filter((path) => !existsSync(path))

package/lib/template-runtime.mjs ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../design-system/src/lib/template-runtime.mjs'

package/package.json CHANGED Viewed

@@ -1,9 +1,9 @@
 {
   "name": "@utopia-studio-design/design-system-cli",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "AI-readable CLI and MCP server for Ceramic Design System",
   "ceramic": {
-    "designSystem": "^0.8.0"
+    "designSystem": "^0.9.1"
   },
   "type": "module",
   "license": "MIT",