@nebutra/theme 0.2.2 → 3.0.0

package/src/languages.json

@@ -9,6 +9,8 @@
       "name": "Nebutra Factory",
       "kind": "design-language",
       "description": "Default product chrome from @nebutra/tokens (no skin). Clear data-brand to restore.",
+      "tagline": "the token source, unskinned",
+      "shortName": "Factory",
       "proves": ["factory HSL SSOT", "recipe defaults", "action≡brand-mark until skin"],
       "darkDefault": true,
       "brandPath": null,
@@ -24,11 +26,41 @@
         "dataBrand": true
       }
     },
+    {
+      "id": "cosmos",
+      "name": "Cosmos",
+      "kind": "design-language",
+      "description": "Linen gallery canvas with a monochrome chrome: the filled Ink button and the brand mark are the same colour, there is no accent role at all. One 16px radius everywhere, zero elevation, serif display at weight 350.",
+      "tagline": "images sit; chrome recedes",
+      "shortName": "Cosmos",
+      "proves": [
+        "monochrome chrome (action ≡ brand-mark, no accent role)",
+        "single-radius system (16px everywhere; 9999px only for the floating nav)",
+        "elevation=none by contract (flat surfaces, contrast-only depth)",
+        "serif display below weight 400 (headingWeight 350)",
+        "light-first dual mode (dark inverts the gallery)"
+      ],
+      "darkDefault": false,
+      "brandPath": "brands/cosmos/brand.json",
+      "skinPath": "skins/cosmos.css",
+      "install": {
+        "command": "nebutra theme use cosmos",
+        "cssImport": "@nebutra/tokens/skins/cosmos.css"
+      },
+      "compatibility": {
+        "tailwind": "4",
+        "cssVariables": true,
+        "brandPackage": true,
+        "dataBrand": true
+      }
+    },
     {
       "id": "gsap",
       "name": "GSAP",
       "kind": "design-language",
       "description": "Dark cream-on-void; shockingly-green is accent — CTA is gradient-stroke/outline, not solid green fill.",
+      "tagline": "saturated, fast easing",
+      "shortName": "GSAP",
       "proves": [
         "outline / gradient-stroke recipe",
         "category extensions",
@@ -53,6 +85,8 @@
       "name": "Linear",
       "kind": "design-language",
       "description": "Dual-mode: dark void default + light paper; solid acid-lime CTA, compact density.",
+      "tagline": "tight radii, low-contrast chrome",
+      "shortName": "Linear",
       "proves": ["chromatic solid action", "dark product chrome", "dual-mode light/dark palettes"],
       "darkDefault": true,
       "brandPath": "brands/linear/brand.json",
@@ -73,6 +107,8 @@
       "name": "Notion",
       "kind": "design-language",
       "description": "Warm paper notebook; Notion Blue sole filled CTA ≠ Ink brand-mark; 8px buttons / 12px cards; elev=none + hairline; accent hues decorative only.",
+      "tagline": "paper surfaces, muted ink",
+      "shortName": "Notion",
       "proves": [
         "action ≠ brand-mark (blue vs ink)",
         "canvas≠card (paper-warmth vs pure-white)",
@@ -99,6 +135,8 @@
       "name": "Raycast",
       "kind": "design-language",
       "description": "Neutral Mist/Iron filled CTA; Coral is brand-mark only. Key elevation stack.",
+      "tagline": "dark glass and a coloured halo",
+      "shortName": "Raycast",
       "proves": ["action ≠ brand-mark", "elevation=key free CSS"],
       "darkDefault": true,
       "brandPath": "brands/raycast/brand.json",
@@ -119,6 +157,8 @@
       "name": "Stripe",
       "kind": "design-language",
       "description": "Indigo-ink ledger on frost glass; Indigo action ≠ Midnight brand-mark; 4px controls; elevation=none (tint + frost rules).",
+      "tagline": "soft elevation, generous type",
+      "shortName": "Stripe",
       "proves": [
         "action ≠ brand-mark (chromatic indigo vs midnight)",
         "elevation=none tint-ladder depth",
@@ -144,6 +184,8 @@
       "name": "Vanta",
       "kind": "design-language",
       "description": "Editorial violet on parchment; Vivid Violet action ≠ Indigo Ink brand-mark; full pills; elevation=none (carbon hairlines).",
+      "tagline": "high-trust enterprise blues",
+      "shortName": "Vanta",
       "proves": [
         "action ≠ brand-mark (chromatic)",
         "elevation=none border-only",
@@ -169,6 +211,8 @@
       "name": "Vercel",
       "kind": "design-language",
       "description": "Monochrome dual-mode: light paper + Obsidian CTA; dark carbon + white CTA; hairline elevation (no chromatic CTA).",
+      "tagline": "monochrome, hard edges, lit top edge",
+      "shortName": "Vercel",
       "proves": ["light monochrome action", "elevation=hairline", "dual-mode light/dark palettes"],
       "darkDefault": false,
       "brandPath": "brands/vercel/brand.json",

package/styles/sources.css

@@ -0,0 +1,16 @@
+/**
+ * Tailwind v4 source registration for @nebutra/theme.
+ *
+ * The language switcher styles itself with utility class strings, and under
+ * Tailwind v4 those utilities exist in an app's bundle only if the app's CSS
+ * pipeline scans this package. The package owns its own scan path — an app
+ * never hardcodes a monorepo-relative @source, because that path is wrong the
+ * moment the package is resolved through node_modules.
+ *
+ * Usage, after @import "tailwindcss":
+ *   @import "@nebutra/theme/styles/sources.css";
+ *   @import "@nebutra/theme/skins.css";
+ *   @import "@nebutra/theme/morph.css";
+ */
+
+@source "../src/**/*.{ts,tsx}";

package/dist/chunk-YJGDBU5Y.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/languages.json","../src/languages.ts"],"sourcesContent":["{\n  \"$schema\": \"https://nebutra.com/schemas/design-language-registry.json\",\n  \"version\": \"2026.07\",\n  \"defaultLanguage\": \"factory\",\n  \"description\": \"Design-language catalog for global product chrome swap (Create Center / SaaS theme). Not color moods — full Brand Packages (roles + recipe + elev + zones).\",\n  \"languages\": [\n    {\n      \"id\": \"factory\",\n      \"name\": \"Nebutra Factory\",\n      \"kind\": \"design-language\",\n      \"description\": \"Default product chrome from @nebutra/tokens (no skin). Clear data-brand to restore.\",\n      \"proves\": [\"factory HSL SSOT\", \"recipe defaults\", \"action≡brand-mark until skin\"],\n      \"darkDefault\": true,\n      \"brandPath\": null,\n      \"skinPath\": null,\n      \"install\": {\n        \"command\": \"nebutra theme use factory\",\n        \"cssImport\": null\n      },\n      \"compatibility\": {\n        \"tailwind\": \"4\",\n        \"cssVariables\": true,\n        \"brandPackage\": true,\n        \"dataBrand\": true\n      }\n    },\n    {\n      \"id\": \"gsap\",\n      \"name\": \"GSAP\",\n      \"kind\": \"design-language\",\n      \"description\": \"Dark cream-on-void; shockingly-green is accent — CTA is gradient-stroke/outline, not solid green fill.\",\n      \"proves\": [\n        \"outline / gradient-stroke recipe\",\n        \"category extensions\",\n        \"marketing display zone\"\n      ],\n      \"darkDefault\": true,\n      \"brandPath\": \"brands/gsap/brand.json\",\n      \"skinPath\": \"skins/gsap.css\",\n      \"install\": {\n        \"command\": \"nebutra theme use gsap\",\n        \"cssImport\": \"@nebutra/tokens/skins/gsap.css\"\n      },\n      \"compatibility\": {\n        \"tailwind\": \"4\",\n        \"cssVariables\": true,\n        \"brandPackage\": true,\n        \"dataBrand\": true\n      }\n    },\n    {\n      \"id\": \"linear\",\n      \"name\": \"Linear\",\n      \"kind\": \"design-language\",\n      \"description\": \"Dual-mode: dark void default + light paper; solid acid-lime CTA, compact density.\",\n      \"proves\": [\"chromatic solid action\", \"dark product chrome\", \"dual-mode light/dark palettes\"],\n      \"darkDefault\": true,\n      \"brandPath\": \"brands/linear/brand.json\",\n      \"skinPath\": \"skins/linear.css\",\n      \"install\": {\n        \"command\": \"nebutra theme use linear\",\n        \"cssImport\": \"@nebutra/tokens/skins/linear.css\"\n      },\n      \"compatibility\": {\n        \"tailwind\": \"4\",\n        \"cssVariables\": true,\n        \"brandPackage\": true,\n        \"dataBrand\": true\n      }\n    },\n    {\n      \"id\": \"notion\",\n      \"name\": \"Notion\",\n      \"kind\": \"design-language\",\n      \"description\": \"Warm paper notebook; Notion Blue sole filled CTA ≠ Ink brand-mark; 8px buttons / 12px cards; elev=none + hairline; accent hues decorative only.\",\n      \"proves\": [\n        \"action ≠ brand-mark (blue vs ink)\",\n        \"canvas≠card (paper-warmth vs pure-white)\",\n        \"elevation=none content cards + raised nav shadow slot\",\n        \"table radius priority (8/12 over tertiary 4px)\",\n        \"decorative accents never product CTA\"\n      ],\n      \"darkDefault\": false,\n      \"brandPath\": \"brands/notion/brand.json\",\n      \"skinPath\": \"skins/notion.css\",\n      \"install\": {\n        \"command\": \"nebutra theme use notion\",\n        \"cssImport\": \"@nebutra/tokens/skins/notion.css\"\n      },\n      \"compatibility\": {\n        \"tailwind\": \"4\",\n        \"cssVariables\": true,\n        \"brandPackage\": true,\n        \"dataBrand\": true\n      }\n    },\n    {\n      \"id\": \"raycast\",\n      \"name\": \"Raycast\",\n      \"kind\": \"design-language\",\n      \"description\": \"Neutral Mist/Iron filled CTA; Coral is brand-mark only. Key elevation stack.\",\n      \"proves\": [\"action ≠ brand-mark\", \"elevation=key free CSS\"],\n      \"darkDefault\": true,\n      \"brandPath\": \"brands/raycast/brand.json\",\n      \"skinPath\": \"skins/raycast.css\",\n      \"install\": {\n        \"command\": \"nebutra theme use raycast\",\n        \"cssImport\": \"@nebutra/tokens/skins/raycast.css\"\n      },\n      \"compatibility\": {\n        \"tailwind\": \"4\",\n        \"cssVariables\": true,\n        \"brandPackage\": true,\n        \"dataBrand\": true\n      }\n    },\n    {\n      \"id\": \"stripe\",\n      \"name\": \"Stripe\",\n      \"kind\": \"design-language\",\n      \"description\": \"Indigo-ink ledger on frost glass; Indigo action ≠ Midnight brand-mark; 4px controls; elevation=none (tint + frost rules).\",\n      \"proves\": [\n        \"action ≠ brand-mark (chromatic indigo vs midnight)\",\n        \"elevation=none tint-ladder depth\",\n        \"4px squared controls (not pill)\",\n        \"whisper heading weight 300\"\n      ],\n      \"darkDefault\": false,\n      \"brandPath\": \"brands/stripe/brand.json\",\n      \"skinPath\": \"skins/stripe.css\",\n      \"install\": {\n        \"command\": \"nebutra theme use stripe\",\n        \"cssImport\": \"@nebutra/tokens/skins/stripe.css\"\n      },\n      \"compatibility\": {\n        \"tailwind\": \"4\",\n        \"cssVariables\": true,\n        \"brandPackage\": true,\n        \"dataBrand\": true\n      }\n    },\n    {\n      \"id\": \"vanta\",\n      \"name\": \"Vanta\",\n      \"kind\": \"design-language\",\n      \"description\": \"Editorial violet on parchment; Vivid Violet action ≠ Indigo Ink brand-mark; full pills; elevation=none (carbon hairlines).\",\n      \"proves\": [\n        \"action ≠ brand-mark (chromatic)\",\n        \"elevation=none border-only\",\n        \"999px pill controls\",\n        \"serif display + sans UI zones\"\n      ],\n      \"darkDefault\": false,\n      \"brandPath\": \"brands/vanta/brand.json\",\n      \"skinPath\": \"skins/vanta.css\",\n      \"install\": {\n        \"command\": \"nebutra theme use vanta\",\n        \"cssImport\": \"@nebutra/tokens/skins/vanta.css\"\n      },\n      \"compatibility\": {\n        \"tailwind\": \"4\",\n        \"cssVariables\": true,\n        \"brandPackage\": true,\n        \"dataBrand\": true\n      }\n    },\n    {\n      \"id\": \"vercel\",\n      \"name\": \"Vercel\",\n      \"kind\": \"design-language\",\n      \"description\": \"Monochrome dual-mode: light paper + Obsidian CTA; dark carbon + white CTA; hairline elevation (no chromatic CTA).\",\n      \"proves\": [\"light monochrome action\", \"elevation=hairline\", \"dual-mode light/dark palettes\"],\n      \"darkDefault\": false,\n      \"brandPath\": \"brands/vercel/brand.json\",\n      \"skinPath\": \"skins/vercel.css\",\n      \"install\": {\n        \"command\": \"nebutra theme use vercel\",\n        \"cssImport\": \"@nebutra/tokens/skins/vercel.css\"\n      },\n      \"compatibility\": {\n        \"tailwind\": \"4\",\n        \"cssVariables\": true,\n        \"brandPackage\": true,\n        \"dataBrand\": true\n      }\n    }\n  ]\n}\n","/**\n * Design-language catalog — the real product surface of @nebutra/theme.\n *\n * A \"language\" is a full Brand Package (roles + recipe + elev), proven by\n * external DS stress tests (Linear / GSAP / Raycast / Vercel / Vanta / Stripe / Notion).\n * Swapping `html[data-brand]` (or applyLanguage) recolors product chrome without\n * call-site edits.\n *\n * Multi-mood oklch catalog was removed. Use LANGUAGE_REGISTRY / isLanguageId only.\n */\n\n/** Generated by scripts/sync-languages.mjs from brands + languages.meta.json */\nimport languagesJson from \"./languages.json\" with { type: \"json\" };\n\nexport interface DesignLanguageInstall {\n  command: string;\n  /** Single-skin import for demos; null for factory */\n  cssImport: string | null;\n}\n\nexport interface DesignLanguageCompatibility {\n  tailwind: \"4\";\n  cssVariables: boolean;\n  brandPackage: boolean;\n  dataBrand: boolean;\n}\n\nexport interface DesignLanguageEntry {\n  id: string;\n  name: string;\n  kind: \"design-language\";\n  description: string;\n  /** Contract proofs this fixture exercises */\n  proves: string[];\n  darkDefault: boolean;\n  /** Relative to @nebutra/tokens package root; null = factory (no override) */\n  brandPath: string | null;\n  skinPath: string | null;\n  install: DesignLanguageInstall;\n  compatibility: DesignLanguageCompatibility;\n}\n\nexport interface DesignLanguageRegistry {\n  $schema: string;\n  version: string;\n  defaultLanguage: string;\n  description: string;\n  languages: DesignLanguageEntry[];\n}\n\nexport const LANGUAGE_REGISTRY = languagesJson as DesignLanguageRegistry;\nexport const LANGUAGE_IDS = LANGUAGE_REGISTRY.languages.map((l) => l.id);\nexport const DEFAULT_LANGUAGE = LANGUAGE_REGISTRY.defaultLanguage;\n/** Alias — “theme” in product speak = design language */\nexport const BUILT_IN_LANGUAGE_IDS = LANGUAGE_IDS;\n\nexport type LanguageId = string;\n\nexport function isLanguageId(id: string): boolean {\n  return LANGUAGE_IDS.includes(id);\n}\n\nexport function getLanguageById(id: string): DesignLanguageEntry | undefined {\n  return LANGUAGE_REGISTRY.languages.find((l) => l.id === id);\n}\n\n/** Fixture languages that ship a Brand Package (excludes factory). */\nexport function listSkinLanguages(): DesignLanguageEntry[] {\n  return LANGUAGE_REGISTRY.languages.filter((l) => l.brandPath != null);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-ZSOVG5W4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/built-in-packages.generated.ts","../src/apply-language.ts"],"sourcesContent":["/**\n * AUTO-GENERATED by scripts/sync-languages.mjs — DO NOT EDIT.\n * Built-in Brand Packages for applyLanguage(id) without manual JSON import.\n * Source: packages/design/tokens/brands/<id>/brand.json\n */\n\nimport { type BrandPackage, normalizeBrandPackage } from \"@nebutra/tokens/brand-package\";\nimport gsap from \"@nebutra/tokens/brands/gsap/brand.json\" with { type: \"json\" };\nimport linear from \"@nebutra/tokens/brands/linear/brand.json\" with { type: \"json\" };\nimport notion from \"@nebutra/tokens/brands/notion/brand.json\" with { type: \"json\" };\nimport raycast from \"@nebutra/tokens/brands/raycast/brand.json\" with { type: \"json\" };\nimport stripe from \"@nebutra/tokens/brands/stripe/brand.json\" with { type: \"json\" };\nimport vanta from \"@nebutra/tokens/brands/vanta/brand.json\" with { type: \"json\" };\nimport vercel from \"@nebutra/tokens/brands/vercel/brand.json\" with { type: \"json\" };\n\nconst RAW_BUILT_IN: Record<string, BrandPackage> = {\n  gsap: gsap as BrandPackage,\n  linear: linear as BrandPackage,\n  notion: notion as BrandPackage,\n  raycast: raycast as BrandPackage,\n  stripe: stripe as BrandPackage,\n  vanta: vanta as BrandPackage,\n  vercel: vercel as BrandPackage,\n};\n\n/** Normalized package for a shipped design-language id, or undefined. */\nexport function getBuiltInBrandPackage(id: string): BrandPackage | undefined {\n  const raw = RAW_BUILT_IN[id];\n  if (!raw) return undefined;\n  return normalizeBrandPackage({ ...raw, id });\n}\n\nexport function listBuiltInBrandIds(): string[] {\n  return Object.keys(RAW_BUILT_IN);\n}\n\nexport function hasBuiltInBrandPackage(id: string): boolean {\n  return id in RAW_BUILT_IN;\n}\n","/**\n * Runtime design-language switch — Create Center / SaaS global theme swap.\n *\n * Light/dark remains class=\"dark\" on @nebutra/tokens ThemeProvider.\n * Design language is html[data-brand] + Brand Package CSS inject.\n *\n * Built-in languages load Brand Packages automatically; pass `package` only for\n * custom / compile-time packages (Create Center preview).\n */\n\nimport {\n  type ApplyBrandOptions,\n  applyBrandPackage,\n  type BrandPackage,\n  clearBrand,\n  getActiveBrandId,\n  normalizeBrandPackage,\n  validateBrandPackage,\n} from \"@nebutra/tokens/brand-package\";\nimport { getBuiltInBrandPackage } from \"./built-in-packages\";\nimport { type DesignLanguageEntry, getLanguageById } from \"./languages\";\n\nexport type { ApplyBrandOptions };\n\nexport interface ApplyLanguageOptions extends ApplyBrandOptions {\n  /**\n   * Preloaded Brand Package (Create Center compile result or override).\n   * When omitted, built-in languages resolve from brands/<id>/brand.json.\n   */\n  package?: BrandPackage;\n}\n\n/**\n * Apply a design language by id.\n * - `factory` / unknown without package → clearBrand (tokens SSOT)\n * - built-in id without package → load shipped Brand Package\n * - with `package` → applyBrandPackage (full carrier swap)\n */\nexport function applyLanguage(\n  languageId: string,\n  options: ApplyLanguageOptions = {},\n): DesignLanguageEntry | null {\n  const entry = getLanguageById(languageId);\n\n  if (!entry || entry.id === \"factory\" || entry.brandPath == null) {\n    if (options.package) {\n      const v = validateBrandPackage(options.package);\n      if (!v.ok) {\n        throw new Error(`Invalid Brand Package: ${v.errors.join(\"; \")}`);\n      }\n      applyBrandPackage(normalizeBrandPackage(options.package), options);\n      return entry ?? null;\n    }\n    clearBrand(options);\n    return entry ?? getLanguageById(\"factory\") ?? null;\n  }\n\n  const pkg = options.package ?? getBuiltInBrandPackage(languageId);\n  if (!pkg) {\n    throw new Error(\n      `Language \"${languageId}\" has no built-in Brand Package and no options.package. ` +\n        `Load @nebutra/tokens/${entry.brandPath} or compileReferoTokens(), then ` +\n        `applyLanguage(\"${languageId}\", { package }). ` +\n        `Or import the single skin CSS: ${entry.install.cssImport ?? \"(none)\"}.`,\n    );\n  }\n\n  const v = validateBrandPackage(pkg);\n  if (!v.ok) {\n    throw new Error(`Invalid Brand Package for ${languageId}: ${v.errors.join(\"; \")}`);\n  }\n  const normalized = normalizeBrandPackage({\n    ...pkg,\n    id: languageId,\n  });\n  applyBrandPackage(normalized, options);\n  return entry;\n}\n\n/** Restore factory product chrome (clear data-brand + injected skin). */\nexport function clearLanguage(options: ApplyBrandOptions = {}): void {\n  clearBrand(options);\n}\n\nexport function getActiveLanguageId(doc?: Document): string {\n  return getActiveBrandId(doc) ?? \"factory\";\n}\n"],"mappings":";;;;;AAMA,SAA4B,6BAA6B;AACzD,OAAO,UAAU;AACjB,OAAO,YAAY;AACnB,OAAO,YAAY;AACnB,OAAO,aAAa;AACpB,OAAO,YAAY;AACnB,OAAO,WAAW;AAClB,OAAO,YAAY;AAEnB,IAAM,eAA6C;AAAA,EACjD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,SAAS,uBAAuB,IAAsC;AAC3E,QAAM,MAAM,aAAa,EAAE;AAC3B,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,sBAAsB,EAAE,GAAG,KAAK,GAAG,CAAC;AAC7C;AAEO,SAAS,sBAAgC;AAC9C,SAAO,OAAO,KAAK,YAAY;AACjC;AAEO,SAAS,uBAAuB,IAAqB;AAC1D,SAAO,MAAM;AACf;;;AC5BA;AAAA,EAEE;AAAA,EAEA;AAAA,EACA;AAAA,EACA,yBAAAA;AAAA,EACA;AAAA,OACK;AAoBA,SAAS,cACd,YACA,UAAgC,CAAC,GACL;AAC5B,QAAM,QAAQ,gBAAgB,UAAU;AAExC,MAAI,CAAC,SAAS,MAAM,OAAO,aAAa,MAAM,aAAa,MAAM;AAC/D,QAAI,QAAQ,SAAS;AACnB,YAAMC,KAAI,qBAAqB,QAAQ,OAAO;AAC9C,UAAI,CAACA,GAAE,IAAI;AACT,cAAM,IAAI,MAAM,0BAA0BA,GAAE,OAAO,KAAK,IAAI,CAAC,EAAE;AAAA,MACjE;AACA,wBAAkBC,uBAAsB,QAAQ,OAAO,GAAG,OAAO;AACjE,aAAO,SAAS;AAAA,IAClB;AACA,eAAW,OAAO;AAClB,WAAO,SAAS,gBAAgB,SAAS,KAAK;AAAA,EAChD;AAEA,QAAM,MAAM,QAAQ,WAAW,uBAAuB,UAAU;AAChE,MAAI,CAAC,KAAK;AACR,UAAM,IAAI;AAAA,MACR,aAAa,UAAU,gFACG,MAAM,SAAS,kDACrB,UAAU,mDACM,MAAM,QAAQ,aAAa,QAAQ;AAAA,IACzE;AAAA,EACF;AAEA,QAAM,IAAI,qBAAqB,GAAG;AAClC,MAAI,CAAC,EAAE,IAAI;AACT,UAAM,IAAI,MAAM,6BAA6B,UAAU,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,EAAE;AAAA,EACnF;AACA,QAAM,aAAaA,uBAAsB;AAAA,IACvC,GAAG;AAAA,IACH,IAAI;AAAA,EACN,CAAC;AACD,oBAAkB,YAAY,OAAO;AACrC,SAAO;AACT;AAGO,SAAS,cAAc,UAA6B,CAAC,GAAS;AACnE,aAAW,OAAO;AACpB;AAEO,SAAS,oBAAoB,KAAwB;AAC1D,SAAO,iBAAiB,GAAG,KAAK;AAClC;","names":["normalizeBrandPackage","v","normalizeBrandPackage"]}