<!-- Domula Single-File Complete AI Design System Pack | URL: https://domula-ds-61073.pages.dev -->

---
name: domula-design-system
description: Official Domula (domula.com) Design System V2: locked visual DNA, W3C DTCG & CSS tokens, perceptual contrast rules, bilingual copy guardrails (en-US & zh-Hans-US), and canonical storefront page blueprints. Activate whenever designing, coding, reviewing, or writing UI/copy for Domula.
---

# Domula Design System Skill (`domula-design-system`)

> **Dedicated Brand Design System URL**: `https://domula-ds-61073.pages.dev`
> **1-Click Local Refresh Command**:
> ```bash
> python -c "import urllib.request as u; exec(u.urlopen(u.Request('https://domula-ds-61073.pages.dev/save-ds.py', headers={'User-Agent':'Mozilla/5.0'})).read().decode('utf-8'))" ./design-system/domula
> ```

## Quick Integration in Any Frontend / Prototype

1. **Link Brand Tokens & Offline Fonts** (from extracted local folder):
   ```html
   <link rel="stylesheet" href="./tokens/brand-fonts.css">
   <link rel="stylesheet" href="./tokens/tokens.css">
   <link rel="stylesheet" href="./tokens/semantic-bridge.css">
   ```
2. **Core Locked Tokens**:
   - **Canvas / Surface / Band / Footer**: `#FFFFFF` / `#FAFAFA` / `#F4F4F4` / `#161616`
   - **Primary / Secondary Ink**: `#161616` / `#545454`
   - **Primary CTA Fill / Text / Label**: `#A6192E` / `#FFFFFF` / `Apply to join` (`申请加入`)
   - **Button / Card / Input Radius**: `999px` / `20px` / `12px`
   - **Display / Body / CJK Fonts**: `Albert Sans` / `Albert Sans` / `Noto Sans SC`
3. **Self-Verify Generated Pages Before Delivery**:
   ```bash
   python tools/ds_lint.py --target path/to/your-page.html
   ```

---

# Domula Design System V2 · AI Agent Replication Guide (`CLAUDE.md`)

## 1. Brand Identity & Business Model

- **Brand**: Domula (`domula.com`)
- **Category & Public Price Band**: Los Angeles Phase 1 Designer-First B2B2C Custom Production & Project Delivery Platform | Zero public retail pricing (Designer Portal project BOM quote only)
- **Business Model (EN)**: Los Angeles Phase 1 Designer-First B2B2C Design-to-Delivery Platform (Custom Manufacturing + Third-Party Receiving & Single-Visit Setup)
- **Business Model (ZH)**: 第一阶段聚焦洛杉矶的设计师优先 B2B2C 设计到交付平台（自有按图定制生产 + 第三方货物代收验货合单 + 一次上门送装）
- **Core Positioning**: Good Design Finds Its Home. (`好设计，自有归处。` · `Designers draw it. We make it, ship it and set it up.`): Los Angeles Phase 1 designer-first platform providing same-day quotes and bills of materials once drawings are ready, two settlement paths, 12-month client protection, custom manufacturing (8-10 weeks; COM 12-16 weeks), 48h LA warehouse receiving inspection for third-party items, shipped and set up in one visit, and 72h aftercare.
- **Self-Contained Package**: Every token file, offline webfont, bilingual runtime helper, Brand Book chapter, component preview, asset, and specimen referenced below lives inside this folder using portable relative paths.

## 2. Canonical Entrypoints (Read Order)

1. **Machine Contract**: `ai-replication-contract.json` (`schemaVersion: "4.0.0"`)
2. **Design Tokens & Offline Runtime**:
   - Canonical JSON: `tokens/tokens.json`
   - W3C DTCG 10-Group JSON: `tokens/tokens.dtcg.json`
   - Brand CSS Variables: `tokens/tokens.css`
   - 48-Variable Cross-Brand Semantic Bridge: `tokens/semantic-bridge.css`
   - Shopify OS 2.0 Theme Settings Bridge: `tokens/shopify-theme-tokens.css`
   - Multi-Platform Token Exports: `tokens/tailwind.preset.json`, `tokens/tokens.tailwind.config.js`, `tokens/tokens.style-dictionary.json`, `tokens/shopify-settings_schema.json`, `tokens/figma-variables.json`
   - Offline Brand Webfonts & CJK Mono Stack: `tokens/brand-fonts.css` (`assets/Fonts/*.woff2`)
   - Bilingual Switcher Helper: `tokens/ds-i18n.js`
3. **Bilingual Brand Book**:
   - Chinese (`zh-Hans-US` governance): `docs/`
   - English (`en-US` governance): `docs/en/`
4. **Brand Evidence & Dossier**:
   - Manifest: `brand-archive/manifest.json`
   - Official Materials: `brand-archive/official-materials.md` and `brand-archive/en/official-materials.md`
   - Strategic Dossier: `brand-archive/third-party-dossier.md` and `brand-archive/en/third-party-dossier.md`
5. **Interactive Viewers & Candidates**:
   - Standalone Bilingual System Viewer: `index.html` (`?lang=en` / `?lang=zh`)
   - Baseline V1 Structural Specimen: `candidates/baseline_v1/specimen.html`
   - Flagship V2 Interactive Specimen: `candidates/optimized_v2/specimen.html`

## 3. Locked Visual DNA

| Property | Locked Value |
| --- | --- |
| Primary Page Ground | `#FFFFFF` |
| Card / Elevated Surface | `#FAFAFA` |
| Alternating Band / Footer | `#F4F4F4` / `#161616` |
| Primary / Secondary Ink | `#161616` / `#545454` |
| Primary Action Fill / Text | `#A6192E` / `#FFFFFF` |
| Button / Card Corner Radius | `999px` / `20px` |
| Display / Body / CJK Fonts | `Albert Sans` / `Albert Sans` / `Noto Sans SC` |
| Elevation & Shadow Rule | Pure neutral achromatic planes (#FFFFFF primary canvas, #FAFAFA workspace surface, #F4F4F4 neutral light gray bands, 20px cards, 28px hero media, 12px inputs, and 1px solid #EAEAEA hairlines; default card shadow none); reserve shadows strictly for floating overlays. |

## 4. Commercial & Legal Guardrails

- **primaryCta**: Public website CTAs: hero `See the homes` / `查看作品`, designer & process pages `Apply to join` / `申请加入`, form `Send application` / `提交申请`, showroom `Book a visit` / `预约参观`, portfolio `Contact {Designer}` / `联系 {设计师}`. Designer Portal CTAs: `New project` / `新建项目`, `Add to the project` / `加入项目`, `Send to client` / `发送给客户`, client proposal `Approve and pay the deposit` / `确认并支付定金` (`999px` pill, `#A6192E` crimson fill, sentence case).
- **accessAndSettlement**: Phase 1 serves Los Angeles interior designers (`Los Angeles, for now` / `先在洛杉矶`) (walk-in homeowners without a designer are served by Domula's paid project design team, credited toward furniture). Two settlement paths: Path A designer net purchase with a valid California Resale Certificate (CDTFA-230 per CDTFA Pub 35); Path B client retail payment with post-delivery designer commission (never expose commission split ratios publicly). Includes 12-month client protection.
- **pricingVisibility**: Zero public consumer retail dollar figures on the public website; itemized quotes are generated per whole-project BOM inside the Designer Portal.
- **fulfillmentAndAftercare**: Same-day quotes and bills of materials; custom manufacturing in 8-10 weeks (12-16 weeks for COM or special craft); third-party items received at the LA hub with open-box photo inspection within 48 hours (billed per piece/project); once complete, shipped and set up in one LA visit (unpacking, placement, packaging removal); 72-hour post-delivery aftercare response.
- **designerAttribution**: Completed home portfolios always credit the interior designer and studio first; never imply consumer shoppable room bundles, nationwide shipping, free design, or third-party brand marketplace onboarding.

## 5. Non-Negotiable Redlines

- Zero public consumer retail prices, zero `Add to cart` / `Shop now` / all-caps buttons, and zero promotional discount banners anywhere on public pages.
- Zero fabricated star ratings (`★★★★★` / `★★★★☆`) anywhere in website or portal components.
- Zero confidential business-plan financial projections, internal margin or commission split ratios, or single-project forecast numbers in any public or design-system file.
- Maintain locked Pure Neutral Gray-White visual system (`#FFFFFF` primary canvas, `#FAFAFA` workspace surface, `#F4F4F4` neutral light gray bands, `#161616` neutral near-black ink, `#545454` secondary ink, `20px` card radius, `28px` hero radius, `12px` input radius, `1px solid #EAEAEA` border, `Albert Sans` + `Noto Sans SC`); never introduce warm beige grounds, serif display fonts, or `12px` card radius descriptions.
- Use `shipped and set up in one visit` / `一次上门送装` (never luxury glove-delivery cliches), state `same-day quotes and bills of materials` (never 5-day drawing turnaround), and restrict Phase 1 geographic claims to Los Angeles (`Los Angeles, for now` / `先在洛杉矶`, never cities beyond Los Angeles).
- Primary CTA buttons use `#A6192E` Domula red (`999px` pill); checkboxes, radio buttons, and active tabs use `#161616` neutral ink (`selection-mark`), never red.

## 6. Nine Canonical Platform & Designer Portal Blueprints

| Blueprint ID | Primary Specimen (`en-US`) | Localized Specimen (`zh-Hans-US`) | Implementation Notes |
| --- | --- | --- | --- |
| `SiteHome` | `components/SiteHome/preview.html` | `components/SiteHomeZh/preview.html` | Public LA B2B2C platform homepage (`SiteHome`, `SiteHomeMobile`, `SiteHomeZh`) leading with `See the homes` and `Apply to join`. |
| `SitePortfolioHomes` | `components/SiteHomes/preview.html` | `components/SiteProjectsZh/preview.html` | Completed LA residences portfolio (`SiteHomes` / `SiteProjectsZh`) crediting the lead interior designer on every home. |
| `PortalMaterialLibrary` | `components/PortalLibrary/preview.html` | `components/SiteProjectsZh/preview.html` | Designer Portal customizable piece & material library (`PortalLibrary`, trade-authenticated, `Add to the project`). |
| `PortalPieceConfigurator` | `components/PortalConfigure/preview.html` | `components/PortalQuoteZh/preview.html` | Designer Portal custom piece & COM specification configurator (`PortalConfigure` + `SiteProject`) with `Add to the project` (zero retail PDP/cart chrome). |
| `PortalSampleTrayAndQuote` | `components/SampleTray/preview.html` | `components/PortalQuoteZh/preview.html` | Designer Sample Tray & Project BOM Quote (`SampleTray` / `PortalQuote` with Path A CDTFA-230 vs Path B client settlement, `Send to client`, and `Approve and pay the deposit`). |
| `SiteDesignerApplication` | `components/SiteApply/preview.html` | `components/SiteProcessZh/preview.html` | Designer partnership page (`SiteForDesigners` -> `Apply to join`) and application form (`SiteApply` -> `Send application`). |
| `SiteEditorialJournal` | `components/SiteJournal/preview.html` | `components/SiteHomeZh/preview.html` | Editorial journal (`SiteJournal`, `SiteArticle`) documenting LA residential architecture and designer collaborations. |
| `SiteHowItWorks` | `components/SiteHowItWorks/preview.html` | `components/SiteProcessZh/preview.html` | End-to-end LA design-to-delivery workflow (`SiteHowItWorks` / `SiteProcessZh` / `SiteAbout`). |
| `SiteAndPortalShowroom` | `components/PortalShowroom/preview.html` | `components/SiteShowroom/preview.html` | Los Angeles showroom (`Book a visit`) and physical material sample tray (`SiteShowroom` / `PortalShowroom`). |

## 7. Bilingual Copy & Typography Checklist (`en-US` & `zh-Hans-US`)

- **Preferred `en-US` Terms**: `Good Design Finds Its Home.`, `Designers draw it. We make it, ship it and set it up.`, `See the homes`, `Apply to join`, `Add to the project`, `Send to client`, `shipped and set up in one visit`
- **Prohibited `en-US` Terms**: `Add to Cart`, `Add to Bag`, `Shop now`, `SUBMIT PROJECT BOM`, `Submit Project Drawings`, `Request Designer Trade Access`, `shoppable whole-room sets`, `Verified US Buyers`
- **Preferred `zh-Hans-US` Terms**: `好设计，自有归处。`, `设计师来画，我们负责做出来、送到、装好。`, `查看作品`, `申请加入`, `加入项目`, `发送给客户`, `一次上门送装`
- **Prohibited `zh-Hans-US` Terms**: `加入购物车`, `立即抢购`, `品牌入驻`, `全国配送`, `免费设计`, `美元`, `美刀`, `包邮`, `亲`
- **Imperial Furniture Units**: Always format inches with `"` and feet with `'` (for example `96"W x 38"D x 30"H` and `12' x 14'` room size). Always state Overall Depth separately from Inside Seat Depth (`22"` to `28"`).

---

## Machine Replication Contract (`ai-replication-contract.json` Core)

```json
{
  "schemaVersion": "4.0.0",
  "brand": {
    "key": "domula",
    "folder": "17_Domula",
    "name": "Domula",
    "domain": "domula.com",
    "siteUrl": "https://domula.com",
    "isOwnBrand": true,
    "bmTrack": "BM0",
    "category": "Los Angeles Phase 1 Designer-First B2B2C Custom Production & Project Delivery Platform",
    "categoryZh": "第一阶段聚焦洛杉矶的设计师优先 B2B2C 按图定制生产与整案交付平台",
    "publicPriceAnchor": "Zero public retail pricing (Designer Portal project BOM quote only)"
  },
  "businessModel": {
    "en": "Los Angeles Phase 1 Designer-First B2B2C Design-to-Delivery Platform (Custom Manufacturing + Third-Party Receiving & Single-Visit Setup)",
    "zh": "第一阶段聚焦洛杉矶的设计师优先 B2B2C 设计到交付平台（自有按图定制生产 + 第三方货物代收验货合单 + 一次上门送装）",
    "positioning": "Good Design Finds Its Home. (`好设计，自有归处。` · `Designers draw it. We make it, ship it and set it up.`): Los Angeles Phase 1 designer-first platform providing same-day quotes and bills of materials once drawings are ready, two settlement paths, 12-month client protection, custom manufacturing (8-10 weeks; COM 12-16 weeks), 48h LA warehouse receiving inspection for third-party items, shipped and set up in one visit, and 72h aftercare."
  },
  "visualDna": {
    "bgCanvas": "#FFFFFF",
    "bgSurface": "#FAFAFA",
    "bgBand": "#F4F4F4",
    "bgFooter": "#161616",
    "inkPrimary": "#161616",
    "inkSecondary": "#545454",
    "inkMuted": "#737373",
    "borderSubtle": "#EAEAEA",
    "actionPrimaryBg": "#A6192E",
    "actionPrimaryFg": "#FFFFFF",
    "selectionMark": "#161616",
    "radiusButton": "999px",
    "radiusCard": "20px",
    "radiusHero": "28px",
    "radiusInput": "12px",
    "shadowPolicy": "Pure neutral achromatic planes (#FFFFFF primary canvas, #FAFAFA workspace surface, #F4F4F4 neutral light gray bands, 20px cards, 28px hero media, 12px inputs, and 1px solid #EAEAEA hairlines; default card shadow none); reserve shadows strictly for floating overlays.",
    "fontDisplay": "Albert Sans",
    "fontBody": "Albert Sans",
    "fontCjk": "Noto Sans SC"
  },
  "commercialPolicies": {
    "primaryCta": "Public website CTAs: hero `See the homes` / `查看作品`, designer & process pages `Apply to join` / `申请加入`, form `Send application` / `提交申请`, showroom `Book a visit` / `预约参观`, portfolio `Contact {Designer}` / `联系 {设计师}`. Designer Portal CTAs: `New project` / `新建项目`, `Add to the project` / `加入项目`, `Send to client` / `发送给客户`, client proposal `Approve and pay the deposit` / `确认并支付定金` (`999px` pill, `#A6192E` crimson fill, sentence case).",
    "accessAndSettlement": "Phase 1 serves Los Angeles interior designers (`Los Angeles, for now` / `先在洛杉矶`) (walk-in homeowners without a designer are served by Domula's paid project design team, credited toward furniture). Two settlement paths: Path A designer net purchase with a valid California Resale Certificate (CDTFA-230 per CDTFA Pub 35); Path B client retail payment with post-delivery designer commission (never expose commission split ratios publicly). Includes 12-month client protection.",
    "pricingVisibility": "Zero public consumer retail dollar figures on the public website; itemized quotes are generated per whole-project BOM inside the Designer Portal.",
    "fulfillmentAndAftercare": "Same-day quotes and bills of materials; custom manufacturing in 8-10 weeks (12-16 weeks for COM or special craft); third-party items received at the LA hub with open-box photo inspection within 48 hours (billed per piece/project); once complete, shipped and set up in one LA visit (unpacking, placement, packaging removal); 72-hour post-delivery aftercare response.",
    "designerAttribution": "Completed home portfolios always credit the interior designer and studio first; never imply consumer shoppable room bundles, nationwide shipping, free design, or third-party brand marketplace onboarding.",
    "taxAndComplianceGuardrails": "Tax: Path A resale exemption requires a timely, good-faith California Resale Certificate (CDTFA-230 per CDTFA Pub 35); installation/fabrication labor taxability follows CDTFA Pub 108. Compliance: Derive applicable standards strictly from piece attributes (CPSC 16 CFR 1261 / ASTM F2057 only for clothing storage units >=27\"H; EPA TSCA Title VI only for composite wood panels, never solid wood; CA TB117-2013 for upholstered seating; Prop 65 is a statutory chemical warning disclosure, not a certification). Display 'Pending test report' ('待检测报告') until verified lab reports are on file."
  },
  "nonNegotiableRedlines": [
    "Zero public consumer retail prices, zero `Add to cart` / `Shop now` / all-caps buttons, and zero promotional discount banners anywhere on public pages.",
    "Zero fabricated star ratings (`★★★★★` / `★★★★☆`) anywhere in website or portal components.",
    "Zero confidential business-plan financial projections, internal margin or commission split ratios, or single-project forecast numbers in any public or design-system file.",
    "Maintain locked Pure Neutral Gray-White visual system (`#FFFFFF` primary canvas, `#FAFAFA` workspace surface, `#F4F4F4` neutral light gray bands, `#161616` neutral near-black ink, `#545454` secondary ink, `20px` card radius, `28px` hero radius, `12px` input radius, `1px solid #EAEAEA` border, `Albert Sans` + `Noto Sans SC`); never introduce warm beige grounds, serif display fonts, or `12px` card radius descriptions.",
    "Use `shipped and set up in one visit` / `一次上门送装` (never luxury glove-delivery cliches), state `same-day quotes and bills of materials` (never 5-day drawing turnaround), and restrict Phase 1 geographic claims to Los Angeles (`Los Angeles, for now` / `先在洛杉矶`, never cities beyond Los Angeles).",
    "Primary CTA buttons use `#A6192E` Domula red (`999px` pill); checkboxes, radio buttons, and active tabs use `#161616` neutral ink (`selection-mark`), never red."
  ],
  "copyLexicon": {
    "preferredEn": [
      "Good Design Finds Its Home.",
      "Designers draw it. We make it, ship it and set it up.",
      "See the homes",
      "Apply to join",
      "Add to the project",
      "Send to client",
      "shipped and set up in one visit"
    ],
    "bannedEn": [
      "Add to Cart",
      "Add to Bag",
      "Shop now",
      "SUBMIT PROJECT BOM",
      "Submit Project Drawings",
      "Request Designer Trade Access",
      "shoppable whole-room sets",
      "Verified US Buyers"
    ],
    "preferredZh": [
      "好设计，自有归处。",
      "设计师来画，我们负责做出来、送到、装好。",
      "查看作品",
      "申请加入",
      "加入项目",
      "发送给客户",
      "一次上门送装"
    ],
    "bannedZh": [
      "加入购物车",
      "立即抢购",
      "品牌入驻",
      "全国配送",
      "免费设计",
      "美元",
      "美刀",
      "包邮",
      "亲"
    ]
  },
  "perceptualAndMotionPhysics": {
    "schemaRevision": "4.0.0",
    "colorSpace": "OKLCH (Bjorn Ottosson 2020 perceptual cylindrical space)",
    "oklchPalette": {
      "bgCanvas": {
        "hex": "#FFFFFF",
        "l": 1.0,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(1.0000 0.0000 0.00)",
        "isAchromatic": true
      },
      "bgSurface": {
        "hex": "#FAFAFA",
        "l": 0.9851,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(0.9851 0.0000 0.00)",
        "isAchromatic": true
      },
      "bgSubtle": {
        "hex": "#F4F4F4",
        "l": 0.9672,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(0.9672 0.0000 0.00)",
        "isAchromatic": true
      },
      "textPrimary": {
        "hex": "#161616",
        "l": 0.2002,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(0.2002 0.0000 0.00)",
        "isAchromatic": true
      },
      "textSecondary": {
        "hex": "#545454",
        "l": 0.4459,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(0.4459 0.0000 0.00)",
        "isAchromatic": true
      },
      "textMuted": {
        "hex": "#6E6E6E",
        "l": 0.5382,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(0.5382 0.0000 0.00)",
        "isAchromatic": true
      },
      "borderSubtle": {
        "hex": "#EAEAEA",
        "l": 0.937,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(0.9370 0.0000 0.00)",
        "isAchromatic": true
      },
      "ctaBg": {
        "hex": "#A6192E",
        "l": 0.4697,
        "c": 0.1733,
        "h": 20.42,
        "css": "oklch(0.4697 0.1733 20.42)",
        "isAchromatic": false
      },
      "ctaText": {
        "hex": "#FFFFFF",
        "l": 1.0,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(1.0000 0.0000 0.00)",
        "isAchromatic": true
      },
      "accent": {
        "hex": "#161616",
        "l": 0.2002,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(0.2002 0.0000 0.00)",
        "isAchromatic": true
      },
      "footerBg": {
        "hex": "#161616",
        "l": 0.2002,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(0.2002 0.0000 0.00)",
        "isAchromatic": true
      },
      "footerText": {
        "hex": "#FFFFFF",
        "l": 1.0,
        "c": 0.0,
        "h": 0.0,
        "css": "oklch(1.0000 0.0000 0.00)",
        "isAchromatic": true
      }
    },
    "canvasToleranceGate": {
      "targetHex": "#FFFFFF",
      "targetOklch": "oklch(1.0000 0.0000 0.00)",
      "maxAbsDeltaL": 0.03,
      "maxAbsDeltaC": 0.0,
      "note": "Strict zero-chroma gate (`OKLCH C == 0.0000`) across all Domula neutral grounds (#FFFFFF, #FAFAFA, #F4F4F4, #EAEAEA, #161616)."
    },
    "contrastMatrix": {
      "algorithm": "APCA-W3 (0.0.98G-4g) + WCAG 2.1 Relative Luminance",
      "pairs": {
        "bodyOnCanvas": {
          "role": "Editorial body & headings on primary canvas",
          "foregroundHex": "#161616",
          "backgroundHex": "#FFFFFF",
          "foregroundOklch": "oklch(0.2002 0.0000 0.00)",
          "backgroundOklch": "oklch(1.0000 0.0000 0.00)",
          "apcaLc": 104.82,
          "apcaAbsLc": 104.82,
          "apcaPolarity": "BoW (dark-on-light)",
          "apcaTargetAbsLc": 75.0,
          "apcaPasses": true,
          "wcag21Ratio": 18.1
        },
        "bodyOnSurface": {
          "role": "Card & specification copy on secondary surface",
          "foregroundHex": "#161616",
          "backgroundHex": "#FAFAFA",
          "foregroundOklch": "oklch(0.2002 0.0000 0.00)",
          "backgroundOklch": "oklch(0.9851 0.0000 0.00)",
          "apcaLc": 101.83,
          "apcaAbsLc": 101.83,
          "apcaPolarity": "BoW (dark-on-light)",
          "apcaTargetAbsLc": 75.0,
          "apcaPasses": true,
          "wcag21Ratio": 17.34
        },
        "secondaryOnCanvas": {
          "role": "Metadata & dimension captions on primary canvas",
          "foregroundHex": "#545454",
          "backgroundHex": "#FFFFFF",
          "foregroundOklch": "oklch(0.4459 0.0000 0.00)",
          "backgroundOklch": "oklch(1.0000 0.0000 0.00)",
          "apcaLc": 86.34,
          "apcaAbsLc": 86.34,
          "apcaPolarity": "BoW (dark-on-light)",
          "apcaTargetAbsLc": 55.0,
          "apcaPasses": true,
          "wcag21Ratio": 7.57
        },
        "ctaLabelOnFill": {
          "role": "Primary CTA button label on solid CTA fill",
          "foregroundHex": "#FFFFFF",
          "backgroundHex": "#A6192E",
          "foregroundOklch": "oklch(1.0000 0.0000 0.00)",
          "backgroundOklch": "oklch(0.4697 0.1733 20.42)",
          "apcaLc": -89.26,
          "apcaAbsLc": 89.26,
          "apcaPolarity": "WoB (light-on-dark)",
          "apcaTargetAbsLc": 60.0,
          "apcaPasses": true,
          "wcag21Ratio": 7.5
        },
        "footerLabelOnGround": {
          "role": "Footer navigation copy on footer ground",
          "foregroundHex": "#FFFFFF",
          "backgroundHex": "#161616",
          "foregroundOklch": "oklch(1.0000 0.0000 0.00)",
          "backgroundOklch": "oklch(0.2002 0.0000 0.00)",
          "apcaLc": -106.97,
          "apcaAbsLc": 106.97,
          "apcaPolarity": "WoB (light-on-dark)",
          "apcaTargetAbsLc": 60.0,
          "apcaPasses": true,
          "wcag21Ratio": 18.1
        }
      },
      "cvdDistinguishability": {
        "deuteranopiaCtaPair": {
          "ctaBgSimHex": "#695F29",
          "ctaFgSimHex": "#FFFFFF",
          "apcaAbsLcUnderDeuteranopia": 86.95,
          "ctaVsCanvasDeltaEOk": 0.5224
        },
        "protanopiaCtaPair": {
          "ctaBgSimHex": "#47422E",
          "ctaFgSimHex": "#FFFFFF",
          "apcaAbsLcUnderProtanopia": 97.47,
          "ctaVsCanvasDeltaEOk": 0.6226
        }
      }
    },
    "typographyOpticalMetrics": {
      "bundledWoff2Count": 4,
      "bundledWoff2Files": [
        {
          "file": "assets/Fonts/albert-sans-latin-ext-wght-normal.woff2",
          "bytes": 23372,
          "sha256Prefix": "78b26c5d5d82",
          "variableWeightRange": "400 700"
        },
        {
          "file": "assets/Fonts/albert-sans-latin-wght-normal.woff2",
          "bytes": 32020,
          "sha256Prefix": "c2fb6fda415c",
          "variableWeightRange": "400 700"
        },
        {
          "file": "assets/Fonts/jetbrains-mono-latin-ext-wght-normal.woff2",
          "bytes": 11624,
          "sha256Prefix": "db5ff4db83e5",
          "variableWeightRange": "400 600"
        },
        {
          "file": "assets/Fonts/jetbrains-mono-latin-wght-normal.woff2",
          "bytes": 31432,
          "sha256Prefix": "83c005d49d8a",
          "variableWeightRange": "400 600"
        }
      ],
      "display": {
        "fileName": "albert-sans-latin-wght-normal.woff2",
        "byteSize": 32020,
        "sha256Prefix": "c2fb6fda415c",
        "family": "Albert Sans",
        "unitsPerEm": 1000,
        "sxHeight": 500,
        "sCapHeight": 700,
        "sTypoAscender": 950,
        "sTypoDescender": -250,
        "xHeightRatio": 0.5,
        "capHeightRatio": 0.7,
        "cssFontSizeAdjust": "ex-height 0.5000",
        "ascentOverridePct": "95.00%",
        "descentOverridePct": "25.00%",
        "lineGapOverridePct": "0.00%",
        "extractionMethod": "live_woff2_binary_tables",
        "configuredFamily": "Albert Sans"
      },
      "sans": {
        "fileName": "albert-sans-latin-wght-normal.woff2",
        "byteSize": 32020,
        "sha256Prefix": "c2fb6fda415c",
        "family": "Albert Sans",
        "unitsPerEm": 1000,
        "sxHeight": 500,
        "sCapHeight": 700,
        "sTypoAscender": 950,
        "sTypoDescender": -250,
        "xHeightRatio": 0.5,
        "capHeightRatio": 0.7,
        "cssFontSizeAdjust": "ex-height 0.5000",
        "ascentOverridePct": "95.00%",
        "descentOverridePct": "25.00%",
        "lineGapOverridePct": "0.00%",
        "extractionMethod": "live_woff2_binary_tables",
        "configuredFamily": "Albert Sans"
      },
      "mono": {
        "fileName": "jetbrains-mono-latin-wght-normal.woff2",
        "byteSize": 31432,
        "sha256Prefix": "83c005d49d8a",
        "family": "JetBrains Mono",
        "unitsPerEm": 1000,
        "sxHeight": 550,
        "sCapHeight": 730,
        "sTypoAscender": 1020,
        "sTypoDescender": -300,
        "xHeightRatio": 0.55,
        "capHeightRatio": 0.73,
        "cssFontSizeAdjust": "ex-height 0.5500",
        "ascentOverridePct": "102.00%",
        "descentOverridePct": "30.00%",
        "lineGapOverridePct": "0.00%",
        "extractionMethod": "live_woff2_binary_tables",
        "configuredFamily": "JetBrains Mono"
      },
      "clsTargetMax": 0.01
    },
    "motionPhysics": {
      "archetype": "architectural_precision_glide",
      "archetypeLabelZh": "建筑精密导轨动效（干脆制动、零拖泥带水）",
      "archetypeLabelEn": "Architectural Precision Glide (Crisp Mechanical Settle, Zero Overshoot)",
      "easePrimary": "cubic-bezier(0.16, 1, 0.3, 1)",
      "easeDrawer": "cubic-bezier(0.2, 0.9, 0.25, 1)",
      "easeExit": "cubic-bezier(0.35, 0, 0.9, 1)",
      "durationMicroMs": 140,
      "durationDrawerMs": 280,
      "durationEditorialRevealMs": 460,
      "springOvershootAllowed": false,
      "reducedMotionPolicy": "Disable transform slides and enforce instant state border/opacity transitions under `@media (prefers-reduced-motion: reduce)`."
    }
  },
  "artDirectionAndOpticalSpec": {
    "archetype": "tilt_shift_architectural_neutral",
    "archetypeLabelZh": "移轴级垂直建筑透视与零色偏中性光场",
    "archetypeLabelEn": "Tilt-Shift Vertical Perspective & Zero-Cast Neutral Daylight",
    "lensFocalLengthMm": "35mm-50mm tilt-shift architectural rectilinear lens",
    "daylightKelvinRange": "5000K-5500K neutral gallery daylight",
    "lightingContrastRatio": "2.5:1 crisp architectural modeling preserving neutral white/gray ground truth",
    "cameraElevationCm": "95cm-115cm orthogonal elevation or 2-point gallery angle; zero converging verticals",
    "shadowDiscipline": "Crisp floor-contact shadow line only; UI cards enforce strict hairline borders rather than blurred shadows.",
    "macroTextureShareMin": "25% minimum close-up frames verifying seam tolerance, metal hardware, or upholstery weave",
    "brandOpticalGuardrail": "Lock UI chrome strictly to achromatic #FFFFFF / #FAFAFA / #F4F4F4 planes so designer CAD renders, stone samples, and upholstery swatches never suffer warm-beige chromatic adaptation drift.",
    "positivePromptEn": "Architectural & product photography for Domula (domula.com), canvas ground #FFFFFF (oklch(1.0000 0.0000 0.00)), shot on 35mm-50mm tilt-shift architectural rectilinear lens, 5000K-5500K neutral gallery daylight, 2.5:1 crisp architectural modeling preserving neutral white/gray ground truth, 95cm-115cm orthogonal elevation or 2-point gallery angle; zero converging verticals, authentic matte surface texture, zero CGI plastic sheen, zero wide-angle edge distortion. Lock UI chrome strictly to achromatic #FFFFFF / #FAFAFA / #F4F4F4 planes so designer CAD renders, stone samples, and upholstery swatches never suffer warm-beige chromatic adaptation drift.",
    "positivePromptZh": "Domula（domula.com）空间与单品光学规范：主画布基准色 #FFFFFF（oklch(1.0000 0.0000 0.00)），采用 35mm-50mm tilt-shift architectural rectilinear lens 焦段，5000K-5500K neutral gallery daylight 照明色温，2.5:1 crisp architectural modeling preserving neutral white/gray ground truth 光比与 95cm-115cm orthogonal elevation or 2-point gallery angle; zero converging verticals 机位高度；保留哑光天然材质肌理，严禁塑料反光感、高饱和促销滤镜与广角边缘拉伸。",
    "lockedGalleryDaylightPolicy": "Strict 5000K-5500K neutral gallery daylight only; consumer 2700K/4000K/6500K warm-room filter toggles are prohibited on Domula surfaces so designer CAD renders and material swatches remain zero-cast.",
    "fiveShotPortfolioAndSpecSequenceEn": [
      "01 Neutral Gallery Custom Living Installation",
      "02 Orthogonal CAD Elevation & BOM Callouts",
      "03 85mm Travertine, Timber & Bouclé Swatch Board",
      "04 Multi-Piece Room Scale & Sightline Proof",
      "05 Consolidated Crating & Single-Visit LA Setup"
    ],
    "fiveShotPortfolioAndSpecSequenceZh": [
      "01 零色偏纯白画廊整屋定制实景",
      "02 正交 CAD 立面图与项目 BOM 节点标注",
      "03 85mm 洞石、木皮与面料实物样板微距",
      "04 多件套空间比例与视线通透校验",
      "05 跨厂集货木箱与洛杉矶全屋一次上门摆位安装"
    ]
  }
}
```

---

## Production CSS Custom Properties (`tokens/tokens.css`)

```css
/* Domula — tokens.css compiled from tokens.json for local use (2026-10-22). Edit tokens.json, not this file. */
:root, [data-theme="default"] {
  --neutral-0: #ffffff;
  --neutral-25: #fafafa;
  --neutral-50: #f4f4f4;
  --neutral-100: #eaeaea;
  --neutral-200: #d9d9d9;
  --neutral-300: #bdbdbd;
  --neutral-400: #888888;
  --neutral-500: #6b6b6b;
  --neutral-600: #545454;
  --neutral-700: #3b3b3b;
  --neutral-800: #262626;
  --neutral-900: #161616;
  --red-50: #fbeff1;
  --red-100: #f3d7db;
  --red-500: #a6192e;
  --red-600: #8c1426;
  --red-700: #701020;
  --green-600: #2f6a4f;
  --green-50: #edf5f0;
  --amber-700: #8a5300;
  --logo-ink: #4b4846;
  --bg-page: var(--neutral-0);
  --bg-band: var(--neutral-50);
  --bg-app: var(--neutral-25);
  --bg-inverse: var(--neutral-900);
  --surface-card: var(--neutral-0);
  --surface-muted: var(--neutral-50);
  --surface-selected: var(--neutral-50);
  --text-primary: var(--neutral-900);
  --text-secondary: var(--neutral-600);
  --text-subtle: var(--neutral-500);
  --text-disabled: var(--neutral-300);
  --text-inverse: var(--neutral-0);
  --text-inverse-muted: var(--neutral-300);
  --text-accent: var(--red-500);
  --border-subtle: var(--neutral-100);
  --border-default: var(--neutral-200);
  --border-strong: var(--neutral-900);
  --control-border: var(--neutral-400);
  --control-border-hover: var(--neutral-600);
  --action-primary: var(--red-500);
  --action-primary-hover: var(--red-600);
  --action-primary-active: var(--red-700);
  --action-primary-text: var(--neutral-0);
  --action-secondary-border: var(--neutral-900);
  --action-secondary-hover: var(--neutral-50);
  --action-disabled: var(--neutral-100);
  --accent-mark: var(--red-500);
  --selection-mark: var(--neutral-900);
  --status-action-text: var(--red-600);
  --status-action-bg: var(--red-50);
  --status-progress-text: var(--neutral-900);
  --status-progress-bg: var(--neutral-50);
  --status-done-text: var(--green-600);
  --status-done-bg: var(--green-50);
  --status-wait-text: var(--amber-700);
  --status-wait-bg: var(--neutral-50);
  --feedback-error-text: var(--red-600);
  --feedback-error-bg: var(--red-50);
  --scrim: rgba(0, 0, 0, 0.45);
  --photo-scrim: rgba(0, 0, 0, 0.38);
  --focus-ring-color: var(--neutral-900);
  --focus-ring-inverse-color: var(--neutral-0);
  --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.06), 0 4px 12px rgba(0, 0, 0, 0.05);
  --shadow-lg: 0 16px 48px rgba(0, 0, 0, 0.16), 0 2px 8px rgba(0, 0, 0, 0.06);
  --focus-ring: 0 0 0 2px #ffffff, 0 0 0 4px #161616;
  --focus-ring-inverse: 0 0 0 2px #161616, 0 0 0 4px #ffffff;
}
:root {
  --space-2: 2px;
  --space-4: 4px;
  --space-8: 8px;
  --space-12: 12px;
  --space-16: 16px;
  --space-20: 20px;
  --space-24: 24px;
  --space-32: 32px;
  --space-40: 40px;
  --space-48: 48px;
  --space-64: 64px;
  --space-80: 80px;
  --space-96: 96px;
  --gutter: 48px;
  --gutter-t: 32px;
  --gutter-m: 16px;
  --section-y: 112px;
  --section-y-t: 80px;
  --section-y-m: 56px;
  --panel-pad: 24px;
  --panel-pad-t: 20px;
  --radius-xs: 4px;
  --radius-sm: 8px;
  --radius-md: 12px;
  --radius-lg: 20px;
  --radius-xl: 28px;
  --radius-full: 999px;
  --display-1: 64px;
  --display-1-t: 52px;
  --display-1-m: 40px;
  --display-2: 48px;
  --display-2-t: 40px;
  --display-2-m: 34px;
  --heading-h1: 40px;
  --heading-h1-t: 34px;
  --heading-h1-m: 30px;
  --heading-h2: 32px;
  --heading-h2-t: 28px;
  --heading-h2-m: 26px;
  --heading-h3: 24px;
  --heading-h3-m: 21px;
  --heading-h4: 20px;
  --heading-h4-m: 18px;
  --heading-h5: 17px;
  --heading-h5-m: 16px;
  --body-large: 19px;
  --body-large-m: 17px;
  --body-base: 16px;
  --body-small: 14px;
  --body-caption: 12px;
  --zh-display-1: 56px;
  --zh-display-1-t: 44px;
  --zh-display-1-m: 34px;
  --zh-display-2: 42px;
  --zh-display-2-t: 36px;
  --zh-display-2-m: 28px;
  --zh-heading-h1: 34px;
  --zh-heading-h1-t: 30px;
  --zh-heading-h1-m: 26px;
  --zh-heading-h2: 28px;
  --zh-heading-h2-t: 25px;
  --zh-heading-h2-m: 23px;
  --zh-heading-h3: 21px;
  --zh-heading-h3-m: 19px;
  --zh-heading-h4: 19px;
  --zh-heading-h4-m: 17px;
  --zh-heading-h5: 16px;
  --zh-heading-h5-m: 15px;
  --zh-body-large: 18px;
  --zh-body-large-m: 16px;
  --control-lg: 52px;
  --control-md: 44px;
  --control-sm: 36px;
  --icon-sm: 16px;
  --icon-md: 20px;
  --icon-lg: 24px;
  --sidebar-w: 248px;
  --rail-w: 76px;
  --topbar-h: 64px;
  --bp-max-mobile: 599px;
  --bp-max-tablet: 1023px;
  --bp-max-laptop: 1279px;
  --container-max: 1280px;
  --content-narrow: 720px;
  --grid-gap: 24px;
  --grid-gap-m: 16px;
  --z-header: 100;
  --z-drawer: 300;
  --z-toast: 500;
  --font-sans: "Albert Sans", "Helvetica Neue", Arial, sans-serif;
  --font-zh: "Albert Sans", "Noto Sans SC", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
}
.display-1 { font-family: var(--font-sans); font-size: 64px; line-height: 1.05; font-weight: 500; }
.display-2 { font-family: var(--font-sans); font-size: 48px; line-height: 1.1; font-weight: 500; }
.heading-h1 { font-family: var(--font-sans); font-size: 40px; line-height: 1.15; font-weight: 500; }
.heading-h2 { font-family: var(--font-sans); font-size: 32px; line-height: 1.2; font-weight: 500; }
.heading-h3 { font-family: var(--font-sans); font-size: 24px; line-height: 1.3; font-weight: 500; }
.heading-h4 { font-family: var(--font-sans); font-size: 20px; line-height: 1.35; font-weight: 600; }
.heading-h5 { font-family: var(--font-sans); font-size: 17px; line-height: 1.4; font-weight: 600; }
.body-large { font-family: var(--font-sans); font-size: 19px; line-height: 1.6; font-weight: 400; }
.body-base { font-family: var(--font-sans); font-size: 16px; line-height: 1.6; font-weight: 400; }
.body-small { font-family: var(--font-sans); font-size: 14px; line-height: 1.5; font-weight: 400; }
.caption { font-family: var(--font-sans); font-size: 12px; line-height: 1.45; font-weight: 500; }
.label { font-family: var(--font-sans); font-size: 12px; line-height: 1.2; font-weight: 600; }
.button { font-family: var(--font-sans); font-size: 15px; line-height: 1.2; font-weight: 600; }
.data { font-family: var(--font-sans); font-size: 14px; line-height: 1.4; font-weight: 500; }
.zh-display-1 { font-family: var(--font-zh); font-size: 56px; line-height: 1.2; font-weight: 500; }
.zh-display-2 { font-family: var(--font-zh); font-size: 42px; line-height: 1.25; font-weight: 500; }
.zh-heading-h2 { font-family: var(--font-zh); font-size: 28px; line-height: 1.35; font-weight: 500; }
.zh-heading-h3 { font-family: var(--font-zh); font-size: 21px; line-height: 1.45; font-weight: 500; }
.zh-body-base { font-family: var(--font-zh); font-size: 16px; line-height: 1.8; font-weight: 400; }
.zh-body-small { font-family: var(--font-zh); font-size: 14px; line-height: 1.7; font-weight: 400; }
.zh-label { font-family: var(--font-zh); font-size: 13px; line-height: 1.3; font-weight: 600; }
```

---

## 48-Variable Semantic Bridge (`tokens/semantic-bridge.css`)

```css
/* 17_Domula - Canonical 48-Variable Semantic Bridge (Stage R9 Contract v3.0.0) */
/* Maps locked brand primitives onto the 4 Cross-Brand Design Fusion & AI Replication axes. */
:root {
  /* Axis 1: Space, Canvas & Color Proportion (25 vars) */
  --ds-sem-bg-canvas: #FFFFFF;
  --ds-sem-bg-surface: #FFFFFF;
  --ds-sem-bg-elevated: #FAFAFA;
  --ds-sem-bg-band: #F4F4F4;
  --ds-sem-bg-footer: #161616;
  --ds-sem-ink-primary: #161616;
  --ds-sem-ink-secondary: #545454;
  --ds-sem-ink-muted: #6B6B6B;
  --ds-sem-ink-on-footer: #FFFFFF;
  --ds-sem-border-hairline: #EAEAEA;
  --ds-sem-border-strong: #161616;
  --ds-sem-action-primary-bg: #A6192E;
  --ds-sem-action-primary-fg: #FFFFFF;
  --ds-sem-action-secondary-bg: #FFFFFF;
  --ds-sem-action-secondary-fg: #161616;
  --ds-sem-accent-brand: #A6192E;
  --ds-sem-status-offer: #A6192E;
  --ds-sem-status-error: #8C1426;
  --ds-sem-announcement-bg: #161616;
  --ds-sem-announcement-fg: #FFFFFF;
  --ds-sem-section-pad-y: 112px;
  --ds-sem-section-pad-x: 48px;
  --ds-sem-container-max: 1280px;
  --ds-sem-grid-gutter: 24px;
  --ds-sem-whitespace-ratio: 0.72;

  /* Axis 2: Typography & Editorial Scale (18 vars) */
  --ds-sem-font-display: "Albert Sans", "Helvetica Neue", Arial, sans-serif;
  --ds-sem-font-sans: "Albert Sans", "Helvetica Neue", Arial, sans-serif;
  --ds-sem-font-mono: "JetBrains Mono", "DM Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, "Noto Sans SC", "PingFang SC", "Microsoft YaHei", sans-serif;
  --ds-sem-font-cjk: "Albert Sans", "Noto Sans SC", "PingFang SC", sans-serif;
  --ds-sem-display-size-desktop: 64px;
  --ds-sem-display-size-mobile: 40px;
  --ds-sem-h2-size: 32px;
  --ds-sem-pdp-title-size: 24px;
  --ds-sem-body-size: 16px;
  --ds-sem-kicker-size: 12px;
  --ds-sem-heading-weight: 500;
  --ds-sem-body-weight: 400;
  --ds-sem-cta-weight: 600;
  --ds-sem-heading-tracking: -0.02em;
  --ds-sem-cta-tracking: 0em;
  --ds-sem-heading-transform: none;
  --ds-sem-cta-transform: none;
  --ds-sem-measure-prose: 65ch;

  /* Axis 3: Corner Geometry & Control Elevation (7 vars) */
  --ds-sem-radius-btn: 999px;
  --ds-sem-radius-card: 20px;
  --ds-sem-radius-input: 12px;
  --ds-sem-btn-height: 52px;
  --ds-sem-header-height: 64px;
  --ds-sem-card-shadow: none;
  --ds-sem-focus-ring: 0 0 0 2px #FFFFFF, 0 0 0 4px #161616;
}

/* === BEGIN DS-V4 PERCEPTUAL OKLCH, APCA, WOFF2 & MOTION PHYSICS === */
:root {
  /* Perceptual OKLCH Coordinates (Domula · Schema v4.0.0) */
  --ds-oklch-canvas: oklch(1.0000 0.0000 0.00);
  --ds-oklch-surface: oklch(0.9851 0.0000 0.00);
  --ds-oklch-subtle: oklch(0.9672 0.0000 0.00);
  --ds-oklch-ink: oklch(0.2002 0.0000 0.00);
  --ds-oklch-ink-secondary: oklch(0.4459 0.0000 0.00);
  --ds-oklch-border: oklch(0.9370 0.0000 0.00);
  --ds-oklch-cta-bg: oklch(0.4697 0.1733 20.42);
  --ds-oklch-cta-ink: oklch(1.0000 0.0000 0.00);
  --ds-oklch-accent: oklch(0.2002 0.0000 0.00);
  --ds-oklch-footer-bg: oklch(0.2002 0.0000 0.00);
  --ds-oklch-footer-ink: oklch(1.0000 0.0000 0.00);

  /* APCA-W3 (0.0.98G-4g) Perceptual Contrast Readouts */
  --ds-apca-body-on-canvas-lc: 104.82;
  --ds-apca-body-on-surface-lc: 101.83;
  --ds-apca-cta-label-lc: -89.26;
  --ds-apca-footer-label-lc: -106.97;

  /* WOFF2 Binary OS/2 Optical x-height Calibration */
  --ds-font-display-x-ratio: 0.5000;
  --ds-font-sans-x-ratio: 0.5000;
  --ds-font-mono-x-ratio: 0.5500;
  --ds-font-size-adjust-display: ex-height 0.5000;
  --ds-font-size-adjust-sans: ex-height 0.5000;

  /* Physical Motion & Photographic Optical Tokens */
  --ds-motion-ease-primary: cubic-bezier(0.16, 1, 0.3, 1);
  --ds-motion-ease-drawer: cubic-bezier(0.2, 0.9, 0.25, 1);
  --ds-motion-ease-exit: cubic-bezier(0.35, 0, 0.9, 1);
  --ds-motion-dur-micro: 140ms;
  --ds-motion-dur-drawer: 280ms;
  --ds-motion-dur-reveal: 460ms;
  --ds-optics-kelvin-daylight: 6500K;
  --ds-optics-kelvin-gallery: 4000K;
  --ds-optics-kelvin-evening: 2700K;
  --ds-optics-archetype: "tilt_shift_architectural_neutral";
}
@media (prefers-reduced-motion: reduce) {
  :root {
    --ds-motion-dur-micro: 0ms;
    --ds-motion-dur-drawer: 100ms;
    --ds-motion-dur-reveal: 120ms;
  }
}
/* === END DS-V4 PERCEPTUAL OKLCH, APCA, WOFF2 & MOTION PHYSICS === */
```

---

## Bundled Reference: `docs/01-brand-core.md`

# 01 品牌核心

**Good Design Finds Its Home.** 好设计，自有归处。

Designers draw it. We make it, ship it and set it up. 设计师来画，我们负责做出来、送到、装好。

## 规则

| 编号 | 规则 | 用在 |
|---|---|---|
| DML-CORE-01 | **价值主张**：主句 **Good Design Finds Its Home.**（中文：**好设计，自有归处。**）；支撑句 **Designers draw it. We make it, ship it and set it up.**（中文：**设计师来画，我们负责做出来、送到、装好。**）。两句一起出现在官网首屏、页脚和对外材料开头；照用原文，不改写、不拆开、不加感叹号。 | Hero、SiteFooter、Statement、BrandCore |
| DML-CORE-02 | **定位**：Domula 是赋能型的设计到交付平台，设计师优先。对设计师：你只管设计，建造、运输、安装交给我们。对房主：一个方案，一次到家。 | Hero、Statement、SiteDesigners |
| DML-CORE-03 | **设计是主角**：每个画面先出现设计师的作品：真实室内照片，照片上署设计师名和地点。Domula 退在后面：页眉一个小字标、页脚一次；给房主看的方案页以设计师工作室为主，Domula 只写“制作与送装”。 | Hero、Photo、HomeCard、Gallery、MediaWithText、PortalClientView |
| DML-CORE-04 | **受众**：主受众：室内设计师（先在洛杉矶）。次受众：设计师的客户（房主）；没有设计师、来展厅的房主由 Domula 自有设计团队服务。文案先对设计师说话，房主内容放在专门的区块和表单里。 | SiteHeader、SiteApply、SiteShowroom |
| DML-CORE-05 | **只说正在做的服务**：可以说：素材库、设计工作台、当天出报价和物料清单、两种付款路径、客户登记保护 12 个月、合作工厂按图生产与质检、海运清关、洛杉矶集货与第三方货物代收、一次入户送装、72 小时售后回复、洛杉矶展厅和样品、自有设计团队（设计费按项目报价，可抵扣货款）。不说：品牌入驻或第三方品牌上架、面向消费者的直购入口、洛杉矶以外的城市、第二产地、免费设计、任何金额。 | 全部组件 |
| DML-CORE-06 | **和设计师的规则**：文案和流程都守这四条：不和设计师抢客户（登记客户 12 个月内归原设计师，自有设计团队不接触）；零售价全渠道一致；不以免费设计做宣传；成交归属、付款和结算对设计师可查。 | SiteAbout、ClientProtection、FAQ、PortalClients |
| DML-CORE-07 | **名称**：品牌名写 Domula（正文首字母大写，字标为全大写图形），任何语言都不翻译、不起中文名。设计师名、工作室名照原样。产品名 = 英文系列名 + 品类：Arden Sofa；中文写 Arden 沙发。说“合作的设计师”（designers we work with），不说“我们的设计师”。 | Logo、PieceCard、HomeCard、DesignerCard |

## 正反例

| 编号 | English ✓ | English ✗ | 中文 ✓ | 中文 ✗ |
|---|---|---|---|---|
| DML-CORE-01 | Good Design Finds Its Home. | Where Great Design Comes Home! | 好设计，自有归处。 | 好设计终于回家了！ |
| DML-CORE-02 | You design. We take it from the drawing to the doorstep. | Domula designs your dream home. | 您专心设计，从图纸到进门交给我们。 | Domula 为您打造梦想之家。 |
| DML-CORE-03 | Designed by Mara Ellis · Silver Lake | A Domula home | 设计 Mara Ellis · 洛杉矶银湖区 | Domula 之家 |
| DML-CORE-04 | For designers · For homeowners | Shop our collection | 给设计师 · 给房主 | 立即选购 |
| DML-CORE-05 | Receiving is billed per item or per project. | Shop 200+ brands, delivered nationwide. | 代收按件或按项目收费。 | 200+ 品牌入驻，全国配送。 |
| DML-CORE-06 | We do not compete for clients. | Free design with every order! | 不和设计师抢客户。 | 下单即送免费设计！ |
| DML-CORE-07 | Designers we work with | Our designers | 合作设计师 | 我们的设计师 / 多木拉 |

## 服务边界速查

| 可以说 | 不说 |
|---|---|
| 素材库、设计工作台、当天报价与物料清单 | 品牌入驻、第三方品牌上架 |
| 两种付款路径，每个项目自选 | 折扣率、佣金率、任何金额 |
| 客户登记，保护 12 个月 | 面向消费者的直购入口（套组、单件） |
| 合作工厂按图生产与质检；海运清关 | 第二产地 |
| 洛杉矶集货、第三方货物代收、一次入户送装 | 洛杉矶以外的城市、全国配送 |
| 洛杉矶展厅和样品；自有设计团队（设计费按项目报价） | 免费设计 |

---

## Bundled Reference: `docs/en/01-brand-core.md`

# 01 Brand core

**Good Design Finds Its Home.**

Designers draw it. We make it, ship it and set it up.

## Rules

| ID | Rule | Used in |
|---|---|---|
| DML-CORE-01 | **Value proposition**: Lead line **Good Design Finds Its Home.**. Support line **Designers draw it. We make it, ship it and set it up.**. Use both on the website hero, in the footer and at the start of external materials. Use them as written: no rewording, no splitting, no exclamation marks. | Hero, SiteFooter, Statement, BrandCore |
| DML-CORE-02 | **Positioning**: Domula is an enabling design-to-delivery platform, designer first. To designers: you design; we build, ship and install. To homeowners: one plan, one delivery. | Hero, Statement, SiteDesigners |
| DML-CORE-03 | **The design leads**: Every screen opens with a designer’s work: a real interior photo with the designer’s name and place on it. Domula stays behind: one small wordmark in the header, once in the footer. Pages a homeowner sees lead with the designer’s studio; Domula appears only as “Made and delivered by”. | Hero, Photo, HomeCard, Gallery, MediaWithText, PortalClientView |
| DML-CORE-04 | **Audiences**: First: interior designers, starting in Los Angeles. Second: the designers’ clients. Homeowners without a designer who visit the showroom are served by the Domula studio team. Copy speaks to designers first; homeowner content lives in its own sections and forms. | SiteHeader, SiteApply, SiteShowroom |
| DML-CORE-05 | **Only offer what runs today**: You may say: the library, the design workbench, same-day quotes and bills of materials, two payment paths, client registration with 12 months of protection, production and inspection by our factory partner, ocean freight and customs, receiving and third-party goods in Los Angeles, one-visit delivery and setup, aftercare replies within 72 hours, the Los Angeles showroom and samples, the studio team (design fees quoted per project and creditable toward furniture). Do not say: brand onboarding or third-party brands, a consumer shop, cities beyond Los Angeles, a second production country, free design, any amount of money. | all components |
| DML-CORE-06 | **Rules with designers**: Copy and flows keep four rules: we do not compete for clients (registered clients stay with their designer for 12 months; the studio team never contacts them); one retail price in every channel; no “free design” promotion; attribution, payments and payouts are visible to the designer. | SiteAbout, ClientProtection, FAQ, PortalClients |
| DML-CORE-07 | **Names**: Write Domula (capital D in text; the wordmark is all caps as artwork). Never translate it or give it a Chinese name. Keep designer and studio names as they are. Product names are an English series name plus the category: Arden Sofa; in Chinese, English series name + localized category noun (see Chapter 03). Say “designers we work with”, never “our designers”. | Logo, PieceCard, HomeCard, DesignerCard |

## Examples

| ID | English ✓ | English ✗ |
|---|---|---|
| DML-CORE-01 | Good Design Finds Its Home. | Where Great Design Comes Home! |
| DML-CORE-02 | You design. We take it from the drawing to the doorstep. | Domula designs your dream home. |
| DML-CORE-03 | Designed by Mara Ellis · Silver Lake | A Domula home |
| DML-CORE-04 | For designers · For homeowners | Shop our collection |
| DML-CORE-05 | Receiving is billed per item or per project. | Shop 200+ brands, delivered nationwide. |
| DML-CORE-06 | We do not compete for clients. | Free design with every order! |
| DML-CORE-07 | Designers we work with | Our designers |

---

## Bundled Reference: `docs/02-language-en.md`

# 02 英文语言规范（en-US）

## 规则

| 编号 | 规则 | 用在 |
|---|---|---|
| DML-EN-01 | **美式英语与 AP 风格**：美式拼写；AP 风格：不用 serial comma；一到九拼写，10 以上用数字；尺寸、日期、周数一律用数字。 | 全部组件 |
| DML-EN-02 | **Voice：Plain · Specific · Credit-giving · Warm**：Plain：短句、常用词。Specific：给出周数、步骤、谁负责。Credit-giving：先说设计师和他们的作品，再说 Domula。Warm：像展厅里懂行的同事，不像广告。 | Hero、SectionHeader、FAQ、EmptyState |
| DML-EN-03 | **大小写**：导航用 Title Case（For Designers）；页面标题、区块标题、按钮、标签用句子式（Apply to join）；价值主张主句保留定稿的写法。全大写只由 CSS 实现（eyebrow），源文案不打大写。 | SiteHeader、SectionHeader、Button、Eyebrow |
| DML-EN-04 | **格式**：日期 Oct 20 / Oct 20, 2026；时间 9:00 a.m. PT；范围用短横 8–10 weeks；尺寸 88″ W；编号保留系统格式 DM-SF-2041、Q-2026-0142。 | OrderTimeline、PieceCard、QuoteTable、ReceivingLog |
| DML-EN-05 | **人称**：“we” 是 Domula 团队；设计师页面里的 “you” 是设计师，房主页面里的 “you” 是房主；同一区块不混用两种 “you”。 | SiteDesigners、SiteShowroom、PortalClientView |
| DML-EN-06 | **错误与空状态**：先说发生了什么，再说怎么办；不怪用户，不用 Oops。 | TextField、FileUpload、EmptyState、Alert |
| DML-EN-07 | **禁用词**：见本章“禁用词”表：无法核验的最高级、空洞形容词、未开展的服务、金额与比例。 | 全部组件 |

## Voice

| 特质 | 是 | 不是 | 例句 |
|---|---|---|---|
| Plain | 短句、常用词 | 行业黑话、长从句 | We make it, ship it and set it up. |
| Specific | 周数、步骤、谁负责 | “fast”“seamless” | Production and inspection: 3–4 weeks. |
| Credit-giving | 先说设计师和作品 | 先说 Domula | Designed by Mara Ellis · Silver Lake |
| Warm | 像展厅里懂行的同事 | 销售话术 | Bring clients to the showroom and take samples with you. |

## 场景语气

| 场景 | 怎么写 | 例句 |
|---|---|---|
| 官网首屏与营销 | 先作品，后 Domula；一句话说清分工 | Good Design Finds Its Home. |
| 设计师后台 | 动词开头，给出下一步 | Choose a payment path before you send the quote. |
| 订单与物流 | 先给事实：日期、件数、谁负责 | Delivery window Nov 12–14. |
| 问题与破损 | 先认事实，再给办法 | Damage noted: corner crushed. Use the photos for your claim. |
| 给房主的页面 | 以设计师为主语，Domula 只做落款 | Design by Mara Ellis · Made and delivered by Domula |

## 格式速查

| 项 | 写法 |
|---|---|
| 日期 | Oct 20；Oct 20, 2026 |
| 时间 | 9:00 a.m. PT |
| 范围 | 8–10 weeks（短横） |
| 尺寸 | 88″ W；30 × 40 in |
| 大小写 | 导航 Title Case；标题、按钮、标签句子式；全大写只用 CSS |
| 金额 | 样例不写；界面用 Money 占位 |

## 禁用词

| 词或句式 | 原因 | 规则 |
|---|---|---|
| best, #1, world-class, best-in-class, luxury, seamless | 无法核验或空洞 | DML-EN-07 |
| our designers（指合作设计师） | 设计师是独立的 | DML-CORE-07 |
| free design, free consultation | 设计费按项目报价 | DML-PX-11 |
| shop now, add to cart, 200+ brands, brands on Domula | 没有消费者直购和品牌入驻 | DML-CORE-05 |
| nationwide, ships anywhere | 只在洛杉矶 | DML-CORE-05 |
| 任何金额、折扣率、佣金率（$XX,XXX · XX% off · earn XX%） | 金额由报价系统填入 | DML-PX-01 |
| 24/7, instant, fast delivery | 承诺必须可核验 | DML-PX-02 |
| Oops!, !!! | 语气不符 | DML-EN-06 |

## 示例库

| 触点 | ✓ | ✗ | 规则 |
|---|---|---|---|
| 首页首屏 | Good Design Finds Its Home. | Your dream home, delivered by Domula! | DML-CORE-01 |
| 作品署名 | Designed by Mara Ellis · Silver Lake | Domula Living Room Collection | DML-CORE-03 |
| 设计师页标题 | Your design, made and delivered. | Join the #1 design platform | DML-EN-07 |
| 付款路径 | Client pays, you earn a commission | Earn XX% on every order | DML-PX-03 |
| 交期 | Standard custom pieces arrive in 8–10 weeks. | Ships fast! | DML-PX-02 |
| 报价合计 | Total · $ ••• | Total · $XX,XXX | DML-PX-01 |
| 房主没有设计师 | Design fees are quoted per project. | Free design with every order | DML-PX-11 |
| 登记客户 | Registered clients are protected for 12 months. | We may contact your clients directly. | DML-PX-04 |
| 表单报错 | Enter an email address like name@studio.com. | Oops! Invalid email. | DML-EN-06 |
| 破损 | Damage noted: corner crushed | Item damaged!!! | DML-PX-08 |

---

## Bundled Reference: `docs/03-language-zh.md`

# 03 中文语言规范（zh-Hans-US）

中文写给在美国的华语设计师和房主。和英文各按读者写，不逐字翻译。

## 规则

| 编号 | 规则 | 用在 |
|---|---|---|
| DML-ZH-01 | **受众与字形**：中文写给在美国的华语设计师和房主，简体（zh-Hans-US）。官网和设计师后台都可切换中文；中文和英文各按读者写，不逐字翻译。 | Locale、LangSwitch、Website、DesignerPortal |
| DML-ZH-02 | **称呼与语气**：对设计师和房主都用“您”；社媒可用“你”。语气实在、懂行，不用“亲”“宝子”，不堆感叹号。 | Alert、Toast、EmptyState、SiteApply |
| DML-ZH-03 | **主张的中文**：价值主张和支撑句只用定稿中文：好设计，自有归处。／设计师来画，我们负责做出来、送到、装好。不另译。 | Hero、SiteFooter |
| DML-ZH-04 | **名称写法**：Domula、设计师名、工作室名、产品系列名保留英文；品类写中文：Arden 沙发、Nori 床头柜。洛杉矶地名用通用中文名：银湖区、帕萨迪纳、圣莫尼卡。 | PieceCard、HomeCard、DesignerCard、QuoteTable |
| DML-ZH-05 | **中文排版**：中文与英文、数字之间加半角空格（日期、时间除外：10月20日、上午9:00）；全角标点；范围用短横 8–10 周；不用斜体、全大写和字距；正文行高 1.8。 | 全部组件、tokens: zh-* |
| DML-ZH-06 | **格式**：日期 10月20日、2026年10月20日；时间 上午9:00（太平洋时间）；尺寸 宽 88″；邮编写“邮编（ZIP）”；电话保留美国格式 (323) 555-0148。 | OrderTimeline、ReceivingLog、TextField |
| DML-ZH-07 | **术语表**：按本章“术语表”统一：设计师价、佣金、转售证明、客供面料（COM）、交期、物料清单、代收、一次入户、保护期、定金、尾款。 | 全部组件 |
| DML-ZH-08 | **中文禁用词**：极限词（最、第一、顶级）、“免费设计”、“品牌入驻”“全国配送”“立即购买”、“我们的设计师”（指合作设计师时）、网络流行语。 | 全部组件 |

## 场景语气

| 场景 | 怎么写 | 例句 |
|---|---|---|
| 官网首屏与营销 | 先作品，后 Domula | 好设计，自有归处。 |
| 设计师后台 | 动词开头，说清下一步 | 发报价之前，请先选择付款方式。 |
| 订单与物流 | 日期前置 | 送达时间段：11月12–14日。 |
| 问题与破损 | 先说明情况，再说怎么办 | 发现破损：边角压坏。照片可用于向供应商索赔。 |
| 给房主的页面 | 设计师在前，Domula 落款 | 设计：Mara Ellis · 制作与送装：Domula |

## 排版与格式速查

| 项 | 写法 | 不写 |
|---|---|---|
| 中英、中数之间 | 半角空格：Arden 沙发、8–10 周 | Arden沙发、8–10周 |
| 日期 | 10月20日；2026年10月20日 | 10/20、2026-10-20 |
| 时间 | 上午9:00（太平洋时间） | 9am PST |
| 范围 | 8–10（短横） | 8~10、8-10 |
| 标点 | 全角：，。：；（）“” | 半角逗号句号 |
| 强调 | 加粗 | 斜体、全大写、字距 |

## 术语表

| English | 中文 | 说明 |
|---|---|---|
| Designer net | 设计师价 | 路径 A 设计师付给 Domula 的价格 |
| Commission | 佣金 | 路径 B 交付后结算 |
| Resale certificate | 转售证明 | 加州 resale certificate |
| COM (customer’s own material) | 客供面料（COM） | 首次出现写全 |
| Lead time | 交期 |  |
| Delivery window | 送达时间段 |  |
| Quote | 报价 / 报价单 |  |
| Bill of materials (BOM) | 物料清单 |  |
| Library | 素材库 |  |
| Design workbench | 设计工作台 |  |
| Receiving | 集货 / 代收 | 仓库收第三方货物时写“代收” |
| One delivery | 一次入户 | 与“送装”连用：一次入户送装 |
| Set up | 安装到位 |  |
| Register a client | 登记客户 |  |
| Protection | 保护期 | 12 个月 |
| Deposit | 定金 |  |
| Balance | 尾款 |  |
| Aftercare | 售后 |  |
| Showroom | 展厅 |  |
| Studio team | 我们的设计团队 | 对内称自有设计团队 |
| Homeowner | 房主 |  |
| Designers we work with | 合作设计师 | 不说“我们的设计师” |
| Inspection | 质检 / 验货 | 工厂写质检，仓库写验货 |
| Render | 渲染图 |  |

## 禁用词

| 词或句式 | 原因 | 规则 |
|---|---|---|
| 最、第一、顶级、奢华 | 极限词 | DML-ZH-08 |
| 我们的设计师（指合作设计师） | 设计师是独立的 | DML-CORE-07 |
| 免费设计、免费咨询 | 设计费按项目报价 | DML-PX-11 |
| 立即购买、加入购物车、品牌入驻 | 没有消费者直购和品牌入驻 | DML-CORE-05 |
| 全国配送、全国包邮 | 只在洛杉矶 | DML-CORE-05 |
| 任何金额、折扣、返佣比例 | 金额由报价系统填入 | DML-PX-01 |
| 亲、宝子、家人们、绝绝子 | 网络用语 | DML-ZH-02 |
| 秒回、极速 | 承诺必须可核验 | DML-PX-07 |

## 示例库

| 触点 | ✓ | ✗ | 规则 |
|---|---|---|---|
| 首页首屏 | 好设计，自有归处。 | Domula 送您梦想之家！ | DML-CORE-01 |
| 作品署名 | 设计 Mara Ellis · 洛杉矶银湖区 | Domula 客厅系列 | DML-CORE-03 |
| 设计师页标题 | 您的设计，我们做好、送到。 | 加入全美第一设计平台 | DML-EN-07 |
| 付款路径 | 客户付款，您拿佣金 | 每单返佣 XX% | DML-PX-03 |
| 交期 | 标准定制 8–10 周到家。 | 极速发货！ | DML-PX-02 |
| 报价合计 | 合计 · $ ••• | 合计 · $XX,XXX | DML-PX-01 |
| 房主没有设计师 | 设计费按项目报价。 | 下单送免费设计 | DML-PX-11 |
| 登记客户 | 登记的客户有 12 个月保护期。 | 我们可能直接联系您的客户。 | DML-PX-04 |
| 表单报错 | 请填写邮箱，例如 name@studio.com。 | 邮箱错误！ | DML-EN-06 |
| 破损 | 发现破损：边角压坏 | 货坏了！！！ | DML-PX-08 |