@synap-core/workspace-templates 0.2.1

package/src/brand-library.yaml

@@ -0,0 +1,627 @@
+# Brand Library workspace template
+# Canonical brand source workspace. User-provided sources are first-class;
+# reusable system outputs are generated/reviewed from those sources.
+
+meta:
+  slug: brand-library
+  name: Brand Library
+  description: Reusable source of truth for brand identity, colors, typography, assets, tokens, templates, and generation rules.
+  icon: palette
+  color: "#B67A38"
+  tags: [brand, assets, tokens, templates, components, creative]
+  isPublic: true
+
+workspace:
+  name: Brand Library
+  description: Reusable source of truth for brand identity, colors, typography, assets, tokens, templates, and generation rules.
+  proposalId: brand-library-v1
+  subtype: brand-library
+  visibility: pod_visible
+  capabilities:
+    - brand.library
+    - brand.identity
+    - brand.assets
+    - brand.tokens
+    - brand.templates
+    - brand.components
+    - brand.context
+  sourceRoles:
+    brand: provider
+
+profiles:
+  - slug: brand-identity
+    displayName: Brand Identity
+    icon: fingerprint
+    color: amber
+    description: "Root brand context: positioning, audience, website, voice summary, and generation intent."
+    semanticSlug: brand.identity
+    properties:
+      - slug: brand-type
+        label: Brand type
+        valueType: string
+        inputType: select
+        enumValues: [product-digital, product-physical, agency, personal-brand, nonprofit, institutional, universal]
+        constraints: { defaultValue: universal }
+      - slug: brand-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, active, archived]
+        constraints: { defaultValue: active }
+      - slug: brand-tagline
+        label: Tagline
+        valueType: string
+        inputType: text
+      - slug: brand-website
+        label: Website
+        valueType: string
+        inputType: url
+      - slug: brand-industry
+        label: Industry
+        valueType: string
+        inputType: text
+      - slug: brand-positioning
+        label: Positioning
+        valueType: string
+        inputType: textarea
+      - slug: brand-audience-primary
+        label: Primary audience
+        valueType: string
+        inputType: textarea
+      - slug: brand-audience-secondary
+        label: Secondary audience
+        valueType: string
+        inputType: textarea
+      - slug: brand-voice-summary
+        label: Voice summary
+        valueType: string
+        inputType: textarea
+      - slug: brand-notes
+        label: Notes
+        valueType: string
+        inputType: textarea
+
+  - slug: brand-color
+    displayName: Brand Color
+    icon: swatch-book
+    color: violet
+    description: Approved palette entry with semantic role, usage notes, and print references.
+    semanticSlug: brand.color
+    properties:
+      - slug: color-role
+        label: Role
+        valueType: string
+        inputType: select
+        enumValues: [primary, secondary, accent, background, surface, surface-elevated, text, text-muted, border, success, warning, error, info, neutral, campaign, custom]
+        constraints: { defaultValue: custom }
+      - slug: color-group
+        label: Group
+        valueType: string
+        inputType: select
+        enumValues: [core, extended, semantic, neutral, seasonal, campaign]
+        constraints: { defaultValue: core }
+      - slug: color-hex
+        label: Hex
+        valueType: string
+        inputType: color
+      - slug: color-rgb
+        label: RGB
+        valueType: string
+        inputType: text
+      - slug: color-cmyk
+        label: CMYK
+        valueType: string
+        inputType: text
+      - slug: color-pantone
+        label: Pantone
+        valueType: string
+        inputType: text
+      - slug: color-ral
+        label: RAL
+        valueType: string
+        inputType: text
+      - slug: color-token-name
+        label: Token name
+        valueType: string
+        inputType: text
+      - slug: color-usage
+        label: Usage note
+        valueType: string
+        inputType: textarea
+      - slug: color-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, approved, deprecated]
+        constraints: { defaultValue: approved }
+
+  - slug: brand-font
+    displayName: Brand Typeface
+    icon: type
+    color: blue
+    description: Typeface with role, family, licensing, import URL, weights, and fallback stack.
+    semanticSlug: brand.font
+    properties:
+      - slug: font-role
+        label: Role
+        valueType: string
+        inputType: select
+        enumValues: [heading, body, display, mono, accent, ui, caption]
+        constraints: { defaultValue: body }
+      - slug: font-family
+        label: Family
+        valueType: string
+        inputType: text
+      - slug: font-foundry
+        label: Foundry
+        valueType: string
+        inputType: text
+      - slug: font-license
+        label: License
+        valueType: string
+        inputType: select
+        enumValues: [open-source, google-fonts, adobe-fonts, licensed, custom, system]
+        constraints: { defaultValue: google-fonts }
+      - slug: font-weights
+        label: Weights
+        valueType: string
+        inputType: text
+      - slug: font-fallback
+        label: Fallback stack
+        valueType: string
+        inputType: text
+      - slug: font-url
+        label: Import URL
+        valueType: string
+        inputType: url
+      - slug: font-document-id
+        label: Font document ID
+        valueType: string
+        inputType: text
+      - slug: font-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [active, draft, deprecated]
+        constraints: { defaultValue: active }
+
+  - slug: brand-asset
+    displayName: Brand Asset
+    icon: image
+    color: green
+    description: "Document-backed or URL-backed reusable media: logos, imagery, icons, fonts, video, references, and documents."
+    semanticSlug: brand.asset
+    properties:
+      - slug: asset-kind
+        label: Kind
+        valueType: string
+        inputType: select
+        enumValues: [logo, wordmark, symbol, monogram, pattern, texture, icon-set, illustration, photo, video, document, font, 3d-model, print-ready, reference, other]
+      - slug: asset-variant
+        label: Variant
+        valueType: string
+        inputType: select
+        enumValues: [primary, secondary, horizontal, stacked, mono-dark, mono-light, white, reversed, favicon, social-avatar, og-image, other]
+      - slug: asset-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, approved, deprecated]
+        constraints: { defaultValue: approved }
+      - slug: asset-usage
+        label: Usage notes
+        valueType: string
+        inputType: textarea
+      - slug: asset-tags
+        label: Tags
+        valueType: string
+        inputType: text
+      - slug: asset-url
+        label: External URL
+        valueType: string
+        inputType: url
+      - slug: asset-document-id
+        label: Document ID
+        valueType: string
+        inputType: text
+      - slug: asset-file-id
+        label: Legacy file ID
+        valueType: string
+        inputType: text
+      - slug: asset-alt-text
+        label: Alt text
+        valueType: string
+        inputType: textarea
+
+  - slug: brand-reference
+    displayName: Brand Reference
+    icon: bookmark
+    color: teal
+    description: Website, competitor, campaign, moodboard, or example used as source context for generation.
+    semanticSlug: brand.reference
+    properties:
+      - slug: reference-kind
+        label: Kind
+        valueType: string
+        inputType: select
+        enumValues: [website, competitor, campaign, moodboard, copy-example, design-example, customer-example, other]
+      - slug: reference-url
+        label: URL
+        valueType: string
+        inputType: url
+      - slug: reference-notes
+        label: Notes
+        valueType: string
+        inputType: textarea
+      - slug: reference-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, approved, archived]
+        constraints: { defaultValue: approved }
+
+  - slug: brand-token-set
+    displayName: Token Set
+    icon: code-2
+    color: violet
+    description: Generated or curated design tokens for color, typography, spacing, radii, and exported CSS variables.
+    semanticSlug: brand.tokens
+    properties:
+      - slug: token-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, active, archived]
+        constraints: { defaultValue: active }
+      - slug: token-mode
+        label: Mode
+        valueType: string
+        inputType: select
+        enumValues: [base, light, dark, high-contrast, campaign, experimental]
+        constraints: { defaultValue: base }
+      - slug: token-source-ids
+        label: Source IDs
+        valueType: string
+        inputType: textarea
+      - slug: token-json
+        label: Tokens JSON
+        valueType: string
+        inputType: textarea
+      - slug: token-css
+        label: CSS variables
+        valueType: string
+        inputType: textarea
+      - slug: token-notes
+        label: Notes
+        valueType: string
+        inputType: textarea
+
+  - slug: brand-voice-guide
+    displayName: Voice Guide
+    icon: message-circle
+    color: orange
+    description: "Generated or curated voice guidance by context: traits, tone, vocabulary, and copy examples."
+    semanticSlug: brand.voice
+    properties:
+      - slug: voice-context
+        label: Context
+        valueType: string
+        inputType: select
+        enumValues: [general, marketing, product, support, social, legal, editorial, investor]
+        constraints: { defaultValue: general }
+      - slug: voice-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, approved, deprecated]
+        constraints: { defaultValue: approved }
+      - slug: voice-personality-traits
+        label: Personality
+        valueType: string
+        inputType: textarea
+      - slug: voice-tone-descriptors
+        label: Tone
+        valueType: string
+        inputType: text
+      - slug: voice-vocabulary
+        label: Vocabulary
+        valueType: string
+        inputType: textarea
+      - slug: voice-example-do
+        label: Do
+        valueType: string
+        inputType: textarea
+      - slug: voice-example-dont
+        label: Don't
+        valueType: string
+        inputType: textarea
+      - slug: voice-source-ids
+        label: Source IDs
+        valueType: string
+        inputType: textarea
+
+  - slug: brand-rule
+    displayName: Brand Rule
+    icon: shield-check
+    color: red
+    description: Usage constraints, accessibility requirements, do/don't examples, and generation guidance.
+    semanticSlug: brand.rule
+    properties:
+      - slug: rule-kind
+        label: Kind
+        valueType: string
+        inputType: select
+        enumValues: [visual, voice, legal, accessibility, sizing, clearance, color-usage, typography-usage, do, dont, generation, other]
+      - slug: rule-subject
+        label: Subject
+        valueType: string
+        inputType: select
+        enumValues: [logo, color, typography, pattern, asset, voice, general, digital, print, packaging]
+      - slug: rule-severity
+        label: Severity
+        valueType: string
+        inputType: select
+        enumValues: [guideline, important, mandatory]
+        constraints: { defaultValue: important }
+      - slug: rule-content
+        label: Rule
+        valueType: string
+        inputType: textarea
+      - slug: rule-example
+        label: Example
+        valueType: string
+        inputType: textarea
+      - slug: rule-source-ids
+        label: Source IDs
+        valueType: string
+        inputType: textarea
+
+  - slug: brand-template
+    displayName: Brand Template
+    icon: layout-template
+    color: pink
+    description: Reusable output template for artboards, decks, carousels, banners, documents, or generated HTML.
+    semanticSlug: brand.template
+    properties:
+      - slug: template-kind
+        label: Kind
+        valueType: string
+        inputType: select
+        enumValues: [artboard, deck, carousel, banner, document, html, social, other]
+      - slug: template-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, approved, deprecated]
+        constraints: { defaultValue: approved }
+      - slug: template-format
+        label: Format
+        valueType: string
+        inputType: select
+        enumValues: [tldraw, html, json, markdown, image, mixed]
+      - slug: template-config
+        label: Config JSON
+        valueType: string
+        inputType: textarea
+      - slug: template-usage
+        label: Usage notes
+        valueType: string
+        inputType: textarea
+
+  - slug: brand-component
+    displayName: Brand Component
+    icon: component
+    color: green
+    description: "Reusable branded UI or content component: hero, CTA, card, quote, banner, section, or HTML snippet."
+    semanticSlug: brand.component
+    properties:
+      - slug: component-kind
+        label: Kind
+        valueType: string
+        inputType: select
+        enumValues: [hero, card, cta, quote, banner, section, layout, html, other]
+      - slug: component-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, approved, deprecated]
+        constraints: { defaultValue: approved }
+      - slug: component-html
+        label: HTML
+        valueType: string
+        inputType: textarea
+      - slug: component-props
+        label: Props JSON
+        valueType: string
+        inputType: textarea
+      - slug: component-usage
+        label: Usage notes
+        valueType: string
+        inputType: textarea
+
+views:
+  - name: Brand Identity
+    slug: brand-identities
+    type: table
+    scopeProfileSlug: brand-identity
+    description: Root brand context and active identities.
+    defaultView: true
+  - name: Color Palette
+    slug: brand-colors
+    type: grid
+    scopeProfileSlug: brand-color
+    description: Approved brand colors and semantic roles.
+  - name: Typography
+    slug: brand-fonts
+    type: list
+    scopeProfileSlug: brand-font
+    description: Approved typefaces, licensing, weights, and import URLs.
+  - name: Assets
+    slug: brand-assets
+    type: grid
+    scopeProfileSlug: brand-asset
+    description: Logos, media, documents, and visual references.
+  - name: References
+    slug: brand-references
+    type: list
+    scopeProfileSlug: brand-reference
+    description: Websites, examples, moodboards, and external references.
+  - name: Token Sets
+    slug: brand-token-sets
+    type: table
+    scopeProfileSlug: brand-token-set
+    description: Generated and approved design tokens.
+  - name: Voice Guides
+    slug: brand-voice-guides
+    type: list
+    scopeProfileSlug: brand-voice-guide
+    description: Voice and tone outputs by context.
+  - name: Rules
+    slug: brand-rules
+    type: list
+    scopeProfileSlug: brand-rule
+    description: Brand usage and generation constraints.
+  - name: Templates
+    slug: brand-templates
+    type: grid
+    scopeProfileSlug: brand-template
+    description: Artboard, carousel, banner, deck, and HTML templates.
+  - name: Components
+    slug: brand-components
+    type: grid
+    scopeProfileSlug: brand-component
+    description: Reusable branded blocks and snippets.
+
+entityLinks:
+  - sourceProfileSlug: brand-token-set
+    targetProfileSlug: brand-color
+    type: derived_from
+    label: Uses color
+  - sourceProfileSlug: brand-token-set
+    targetProfileSlug: brand-font
+    type: derived_from
+    label: Uses typeface
+  - sourceProfileSlug: brand-rule
+    targetProfileSlug: brand-asset
+    type: references
+    label: References asset
+  - sourceProfileSlug: brand-template
+    targetProfileSlug: brand-token-set
+    type: uses
+    label: Uses token set
+
+app:
+  kind: native
+  appId: brandLibrary
+  rendererType: native
+  title: Brand Library
+
+layout:
+  pinnedApps: [data, whiteboard, brandLibrary]
+  defaultView: Brand Command Center
+  defaultApp: brandLibrary
+  sidebarItems:
+    - kind: app
+      appId: brandLibrary
+      label: Brand Library
+      icon: palette
+      surface:
+        kind: app
+        appId: brandLibrary
+        rendererType: native
+        placement: main
+        displayMode: full
+        title: Brand Library
+    - kind: view
+      viewName: Brand Command Center
+      label: Command Center
+      icon: layout-dashboard
+    - kind: view
+      viewName: Color Palette
+      label: Colors
+      icon: swatch-book
+    - kind: view
+      viewName: Typography
+      label: Typography
+      icon: type
+    - kind: view
+      viewName: Assets
+      label: Assets
+      icon: image
+    - kind: view
+      viewName: Token Sets
+      label: Tokens
+      icon: code-2
+    - kind: view
+      viewName: Rules
+      label: Rules
+      icon: shield-check
+
+bento:
+  viewName: Brand Command Center
+  blocks:
+    - kind: view
+      viewName: Brand Identity
+      pos: { x: 0, y: 0, w: 6, h: 4 }
+    - kind: view
+      viewName: Assets
+      pos: { x: 6, y: 0, w: 6, h: 4 }
+    - kind: view
+      viewName: Color Palette
+      pos: { x: 0, y: 4, w: 4, h: 4 }
+    - kind: view
+      viewName: Typography
+      pos: { x: 4, y: 4, w: 4, h: 4 }
+    - kind: view
+      viewName: Token Sets
+      pos: { x: 8, y: 4, w: 4, h: 4 }
+    - kind: view
+      viewName: Rules
+      pos: { x: 0, y: 8, w: 6, h: 4 }
+    - kind: view
+      viewName: Templates
+      pos: { x: 6, y: 8, w: 6, h: 4 }
+
+seedEntities:
+  - profileSlug: brand-identity
+    title: Primary Brand
+    properties:
+      brand-type: universal
+      brand-status: active
+      brand-positioning: Describe the promise, category, and differentiation of this brand.
+      brand-audience-primary: Describe the primary audience and buying context.
+      brand-voice-summary: Clear, useful, specific, and calm.
+  - profileSlug: brand-color
+    title: Primary
+    properties:
+      color-role: primary
+      color-group: core
+      color-hex: "#B67A38"
+      color-token-name: brand-primary
+      color-status: approved
+      color-usage: Primary action and selection accent.
+  - profileSlug: brand-font
+    title: System Sans
+    properties:
+      font-role: body
+      font-family: system-ui
+      font-license: system
+      font-weights: "400, 500, 600, 700"
+      font-fallback: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif
+      font-status: active
+  - profileSlug: brand-token-set
+    title: Base Tokens
+    properties:
+      token-status: draft
+      token-mode: base
+      token-source-ids: seed
+      token-json: '{"colors":{"primary":"#B67A38"},"typography":{"body":"system-ui"}}'
+      token-css: ":root { --brand-primary: #B67A38; --brand-font-body: system-ui; }"
+  - profileSlug: brand-rule
+    title: Use approved sources first
+    properties:
+      rule-kind: generation
+      rule-subject: general
+      rule-severity: guideline
+      rule-content: Use approved colors, typefaces, assets, and token sets before creating variants.
+      rule-example: When generating an artboard, prefer the active token set and approved logo/image assets.