@odla-ai/brand 0.7.1 → 0.8.0

package/README.md

@@ -51,7 +51,7 @@ The package is a **schema + rules + an agent skill + a color engine + a token co
 - **The upload surface is intentionally narrow.** Raster PNG/JPEG/GIF/WebP and
   PDF inputs are supported. SVG active content and binary font files are not;
   typography remains an exact, reviewable family/style proposal.
-- **Tokens compile to the @odla-ai/ui contract.** `compileBrandTokens` maps swatch roles onto `--ui-*` names — always emitting every required token plus the accent-composing derived set, so a scoped preview island never keeps stale root composites — and `renderTokensCss` emits theme-structured CSS (light, dark, invert). Dark is derived algorithmically and contrast re-tuned per token.
+- **Tokens compile to the @odla-ai/ui contract.** `compileBrandTokens` maps swatch roles onto `--ui-*` names — always emitting every required token plus the accent-composing derived set, so a scoped preview island never keeps stale root composites — and `renderTokensCss` emits theme-structured CSS (light, dark, invert). Dark is derived algorithmically and contrast re-tuned per token. A reviewed typography proposal may also carry bounded `tokenOverrides`; those `--ui-*` component and layout values are validated, stored with the approved section, and compiled into both published token maps.
 - **Zero runtime dependencies.** The db client is injected structurally (a real `@odla-ai/db` `AdminDb` satisfies `BrandDb`); `@odla-ai/ai` is a types-only optional peer.
 
 - **Claude Designs are a first-class input.** A design exported from

package/dist/{index-r36KQK5n.d.cts → index-r6SGidYT.d.cts}

@@ -66,13 +66,18 @@ interface PaletteSection {
     name: string;
     swatches: Swatch[];
 }
-/** `typography`-kind section content. `scale` is a modular type-scale ratio. */
+/**
+ * `typography`-kind section content. `scale` is a modular type-scale ratio.
+ * `tokenOverrides` carries bounded `--ui-*` component/layout values through
+ * the same reviewed activation that publishes the font choices.
+ */
 interface TypographySection {
     fontDisplay?: string;
     fontBody?: string;
     fontMono?: string;
     scale?: number;
     notes?: string;
+    tokenOverrides?: Record<string, string>;
 }
 /** `voice`-kind section content: tone plus writing principles/examples. */
 interface VoiceSection {

package/dist/{index-r36KQK5n.d.ts → index-r6SGidYT.d.ts}

@@ -66,13 +66,18 @@ interface PaletteSection {
     name: string;
     swatches: Swatch[];
 }
-/** `typography`-kind section content. `scale` is a modular type-scale ratio. */
+/**
+ * `typography`-kind section content. `scale` is a modular type-scale ratio.
+ * `tokenOverrides` carries bounded `--ui-*` component/layout values through
+ * the same reviewed activation that publishes the font choices.
+ */
 interface TypographySection {
     fontDisplay?: string;
     fontBody?: string;
     fontMono?: string;
     scale?: number;
     notes?: string;
+    tokenOverrides?: Record<string, string>;
 }
 /** `voice`-kind section content: tone plus writing principles/examples. */
 interface VoiceSection {

package/dist/index.cjs

@@ -31,6 +31,7 @@ __export(src_exports, {
   BRAND_EMITTED_TOKENS: () => BRAND_EMITTED_TOKENS,
   BRAND_INSTRUCTIONS: () => BRAND_INSTRUCTIONS,
   BRAND_NS: () => BRAND_NS,
+  BRAND_PROMOTION_ADAPTER: () => BRAND_PROMOTION_ADAPTER,
   BRAND_REQUIRED_TOKENS: () => BRAND_REQUIRED_TOKENS,
   BRAND_RULES: () => BRAND_RULES,
   BRAND_SCHEMA: () => BRAND_SCHEMA,
@@ -119,6 +120,7 @@ __export(src_exports, {
   digestDesignBundle: () => digestDesignBundle,
   digestDesignHtml: () => digestDesignHtml,
   dispatchBrandTurn: () => dispatchBrandTurn,
+  exportBrandPromotion: () => exportBrandPromotion,
   extractColors: () => extractColors,
   extractDesignTokens: () => extractDesignTokens,
   extractFonts: () => extractFonts,
@@ -598,6 +600,7 @@ var DESIGN_CONTENT_TYPES = /* @__PURE__ */ new Set(["text/html"]);
 var HEX_RGB = /^#[0-9a-f]{3}$/;
 var HEX_RRGGBB = /^#[0-9a-f]{6}$/;
 var HEX_ALPHA = /^#[0-9a-f]{4}$|^#[0-9a-f]{8}$/;
+var UI_TOKEN_NAME = /^--ui-[a-z0-9-]+$/;
 var isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 function assertHex(value, label = "color") {
   if (typeof value !== "string")
@@ -664,6 +667,21 @@ function assertTypographySection(c) {
     out.scale = c.scale;
   }
   if (c.notes !== void 0) out.notes = capString(c.notes, "content.notes", 2e3);
+  if (c.tokenOverrides !== void 0) {
+    if (!isRecord(c.tokenOverrides))
+      throw new BrandInputError("content.tokenOverrides must be an object");
+    const entries = Object.entries(c.tokenOverrides);
+    if (entries.length > 64)
+      throw new BrandInputError("content.tokenOverrides must have at most 64 entries");
+    out.tokenOverrides = Object.fromEntries(entries.map(([name, raw]) => {
+      if (!UI_TOKEN_NAME.test(name))
+        throw new BrandInputError(`content.tokenOverrides.${name} must be a --ui-* token name`);
+      const value = capString(raw, `content.tokenOverrides.${name}`, 500);
+      if (/[;{}]/.test(value) || /url\s*\(/i.test(value))
+        throw new BrandInputError(`content.tokenOverrides.${name} contains an unsafe CSS value`);
+      return [name, value];
+    }));
+  }
   return out;
 }
 function assertVoiceSection(c) {
@@ -827,14 +845,14 @@ var SNAPSHOT_REQUIRED = [
 ];
 function validSnapshotShape(value) {
   if (!record3(value) || !exactKeys(value, SNAPSHOT_REQUIRED)) return false;
-  const provenance = value.provenance;
-  return boundedString(value.id) && boundedString(value.bookId) && typeof value.kind === "string" && PROPOSAL_KINDS.includes(value.kind) && value.status === "open" && record3(value.payload) && boundedString(value.rationale, 2e3) && record3(provenance) && exactKeys(provenance, [
+  const provenance2 = value.provenance;
+  return boundedString(value.id) && boundedString(value.bookId) && typeof value.kind === "string" && PROPOSAL_KINDS.includes(value.kind) && value.status === "open" && record3(value.payload) && boundedString(value.rationale, 2e3) && record3(provenance2) && exactKeys(provenance2, [
     "sourceAssetId",
     "sourceAsset",
     "messageId",
     "turnId",
     "taintLabels"
-  ]) && (provenance.sourceAssetId === null || boundedString(provenance.sourceAssetId)) && (provenance.sourceAsset === null || record3(provenance.sourceAsset) && exactKeys(provenance.sourceAsset, [
+  ]) && (provenance2.sourceAssetId === null || boundedString(provenance2.sourceAssetId)) && (provenance2.sourceAsset === null || record3(provenance2.sourceAsset) && exactKeys(provenance2.sourceAsset, [
     "assetId",
     "contentDigest",
     "objectEtag",
@@ -843,7 +861,7 @@ function validSnapshotShape(value) {
     "contentType",
     "analysisRevision",
     "analysisDigest"
-  ]) && boundedString(provenance.sourceAsset.assetId) && typeof provenance.sourceAsset.contentDigest === "string" && DIGEST.test(provenance.sourceAsset.contentDigest) && boundedString(provenance.sourceAsset.objectEtag) && Number.isSafeInteger(provenance.sourceAsset.objectSize) && provenance.sourceAsset.objectSize > 0 && typeof provenance.sourceAsset.pathDigest === "string" && DIGEST.test(provenance.sourceAsset.pathDigest) && (provenance.sourceAsset.contentType === null || boundedString(provenance.sourceAsset.contentType, 160)) && (provenance.sourceAsset.analysisRevision === null || Number.isSafeInteger(provenance.sourceAsset.analysisRevision) && provenance.sourceAsset.analysisRevision >= 0) && (provenance.sourceAsset.analysisDigest === null || typeof provenance.sourceAsset.analysisDigest === "string" && DIGEST.test(provenance.sourceAsset.analysisDigest))) && (provenance.sourceAssetId === null && provenance.sourceAsset === null || provenance.sourceAssetId !== null && provenance.sourceAsset !== null && provenance.sourceAsset.assetId === provenance.sourceAssetId) && (provenance.messageId === null || boundedString(provenance.messageId)) && (provenance.turnId === null || boundedString(provenance.turnId)) && Array.isArray(provenance.taintLabels) && provenance.taintLabels.length <= 16 && provenance.taintLabels.every((label) => boundedString(label, 120)) && new Set(provenance.taintLabels).size === provenance.taintLabels.length && typeof value.reviewDigest === "string" && DIGEST.test(value.reviewDigest) && Array.isArray(value.audience) && value.audience.length > 0 && value.audience.length <= 100 && value.audience.every((id) => boundedString(id)) && new Set(value.audience).size === value.audience.length && boundedString(value.createdBy) && boundedString(value.createdAuthorityRef) && safeTime(value.createdAt);
+  ]) && boundedString(provenance2.sourceAsset.assetId) && typeof provenance2.sourceAsset.contentDigest === "string" && DIGEST.test(provenance2.sourceAsset.contentDigest) && boundedString(provenance2.sourceAsset.objectEtag) && Number.isSafeInteger(provenance2.sourceAsset.objectSize) && provenance2.sourceAsset.objectSize > 0 && typeof provenance2.sourceAsset.pathDigest === "string" && DIGEST.test(provenance2.sourceAsset.pathDigest) && (provenance2.sourceAsset.contentType === null || boundedString(provenance2.sourceAsset.contentType, 160)) && (provenance2.sourceAsset.analysisRevision === null || Number.isSafeInteger(provenance2.sourceAsset.analysisRevision) && provenance2.sourceAsset.analysisRevision >= 0) && (provenance2.sourceAsset.analysisDigest === null || typeof provenance2.sourceAsset.analysisDigest === "string" && DIGEST.test(provenance2.sourceAsset.analysisDigest))) && (provenance2.sourceAssetId === null && provenance2.sourceAsset === null || provenance2.sourceAssetId !== null && provenance2.sourceAsset !== null && provenance2.sourceAsset.assetId === provenance2.sourceAssetId) && (provenance2.messageId === null || boundedString(provenance2.messageId)) && (provenance2.turnId === null || boundedString(provenance2.turnId)) && Array.isArray(provenance2.taintLabels) && provenance2.taintLabels.length <= 16 && provenance2.taintLabels.every((label) => boundedString(label, 120)) && new Set(provenance2.taintLabels).size === provenance2.taintLabels.length && typeof value.reviewDigest === "string" && DIGEST.test(value.reviewDigest) && Array.isArray(value.audience) && value.audience.length > 0 && value.audience.length <= 100 && value.audience.every((id) => boundedString(id)) && new Set(value.audience).size === value.audience.length && boundedString(value.createdBy) && boundedString(value.createdAuthorityRef) && safeTime(value.createdAt);
 }
 var CONSUMPTION_REQUIRED = [
   "id",
@@ -4143,7 +4161,10 @@ var proposalGuardEquals = (snapshot) => ({ ...snapshot });
 
 // src/routes/proposal-effects.ts
 async function tokenSnapshot(swatches, typography, input, paletteId, paletteReceiptId, paletteActionDigest, typographyReceiptId, typographyActionDigest) {
-  const compiled = compileBrandTokens({ swatches, ...typography ? { typography } : {} });
+  const compiled = compileBrandTokens({
+    swatches,
+    ...typography ? { typography, overrides: typography.tokenOverrides } : {}
+  });
   const sources = {
     paletteId,
     paletteReceiptId,
@@ -5436,4 +5457,111 @@ function createBrandIntegration(options = {}) {
     probes: [{ path: `${basePath}/books`, expectedStatus: 401 }]
   };
 }
+
+// src/promotion.ts
+var import_promotion = require("@odla-ai/promotion");
+var BRAND_PROMOTION_ADAPTER = "@odla-ai/brand/v1";
+var provenance = (sourceIds, receiptDigests = []) => ({
+  adapter: BRAND_PROMOTION_ADAPTER,
+  sourceIds: [...sourceIds].sort(),
+  receiptDigests: [...receiptDigests].sort()
+});
+var exclusions = (book) => [
+  {
+    kind: "brand.runtime",
+    id: book.slug,
+    reason: "environment_local",
+    paths: [`${BRAND_NS.book}.ownerId`, `${BRAND_NS.book}.memberIds`, `${BRAND_NS.book}.channelId`, `${BRAND_NS.book}.*At`],
+    detail: "Ownership, roster, channel, and timestamps remain local to the target environment."
+  },
+  {
+    kind: "brand.drafts",
+    id: book.slug,
+    reason: "draft_state",
+    paths: [`${BRAND_NS.proposal}.*`, `${BRAND_NS.section}[status=draft]`],
+    detail: "Open proposals and unapproved sections are review state, not published brand content."
+  },
+  {
+    kind: "brand.assets",
+    id: book.slug,
+    reason: "provider_identity",
+    paths: [`${BRAND_NS.asset}.storageObjectId`, `${BRAND_NS.asset}.path`, `${BRAND_NS.asset}.*AuthorityRef`],
+    detail: "Stored files and provider object identities require a separate asset-transfer contract."
+  },
+  {
+    kind: "brand.authority",
+    id: book.slug,
+    reason: "authority_history",
+    paths: [`${BRAND_NS.approvalReceipt}.*`, `${BRAND_NS.palette}.audience`],
+    detail: "Authority rows stay immutable in their source environment; artifacts retain only receipt digests and ids."
+  }
+];
+function exportBrandPromotion(input) {
+  const { book } = input;
+  if (book.status !== "active") throw new TypeError(`brand book ${book.slug} is not active`);
+  const revision = `brand:${book.slug}:${book.activationRevision}`;
+  const artifacts = [];
+  if (book.tokens) {
+    const {
+      compiledAt: _compiledAt,
+      paletteReceiptId,
+      paletteActionDigest,
+      typographyReceiptId,
+      typographyActionDigest,
+      sourceDigest,
+      ...stableTokens
+    } = book.tokens;
+    artifacts.push({
+      kind: "brand.tokens",
+      id: book.slug,
+      sourceRevision: revision,
+      provenance: provenance(
+        [book.id, book.tokens.paletteId, paletteReceiptId, typographyReceiptId].filter((value) => Boolean(value)),
+        [sourceDigest, paletteActionDigest, typographyActionDigest].filter((value) => Boolean(value))
+      ),
+      content: (0, import_promotion.canonicalPromotionValue)({ bookSlug: book.slug, tokens: stableTokens })
+    });
+  }
+  for (const section of input.sections.filter((row) => row.bookId === book.id && row.status === "approved")) {
+    if (!section.approvalReceiptId || !section.approvalActionDigest) {
+      throw new TypeError(`approved brand section ${section.key} lacks approval provenance`);
+    }
+    artifacts.push({
+      kind: "brand.section",
+      id: `${book.slug}/${section.kind}`,
+      sourceRevision: revision,
+      provenance: provenance([book.id, section.id, section.approvalReceiptId], [section.approvalActionDigest]),
+      content: (0, import_promotion.canonicalPromotionValue)({ bookSlug: book.slug, kind: section.kind, content: section.content })
+    });
+  }
+  const activePalette2 = input.palettes.find((row) => row.bookId === book.id && row.id === book.activePaletteId && row.status === "active");
+  if (book.activePaletteId && !activePalette2) throw new TypeError(`active palette ${book.activePaletteId} is unavailable`);
+  if (activePalette2) {
+    artifacts.push({
+      kind: "brand.palette",
+      id: `${book.slug}/${activePalette2.id}`,
+      sourceRevision: revision,
+      provenance: provenance([book.id, activePalette2.id, activePalette2.proposalId, activePalette2.approvalReceiptId], [activePalette2.approvalActionDigest]),
+      content: (0, import_promotion.canonicalPromotionValue)({
+        bookSlug: book.slug,
+        name: activePalette2.name,
+        swatches: activePalette2.swatches,
+        source: activePalette2.source,
+        ...activePalette2.seedHex ? { seedHex: activePalette2.seedHex } : {},
+        ...activePalette2.rationale ? { rationale: activePalette2.rationale } : {}
+      })
+    });
+  }
+  return {
+    adapter: BRAND_PROMOTION_ADAPTER,
+    artifacts,
+    exclusions: exclusions(book),
+    preconditions: [{
+      code: "brand.schema",
+      path: "services.brand.schemaVersion",
+      expected: 1,
+      detail: "The target must expose the Brand v1 approved-content schema."
+    }]
+  };
+}
 //# sourceMappingURL=index.cjs.map