@nebutra/tokens 0.1.2 → 0.1.3

package/dist/brand-package/index.d.ts

@@ -0,0 +1,123 @@
+import { C as CompileResult, d as BrandPackage, m as ButtonDefaultStyle, E as ElevationStyle, D as Density, n as BrandPackageInput, o as BrandSemanticColors, a as BrandColorRoles, b as BrandElevationTokens, p as BrandModePalette } from '../use-brand-C8d4DPqE.js';
+export { A as ApplyBrandOptions, B as BRAND_STORAGE_KEY, q as BRAND_STYLE_ELEMENT_ID, s as BadgeDefaultStyle, t as BrandExtensions, c as BrandFontFace, v as BrandFontSource, w as BrandIframePreviewOptions, x as BrandModes, e as BrandRadii, f as BrandRecipe, y as BrandRecipeInput, z as BrandTypography, F as CssColor, H as HslChannels, U as UseBrandIframePreviewResult, G as UseBrandOptions, I as UseBrandResult, g as applyBrandCss, h as applyBrandPackage, i as applyBrandToIframe, j as clearBrand, k as getActiveBrandId, r as restorePersistedBrand, u as useBrand, l as useBrandIframePreview } from '../use-brand-C8d4DPqE.js';
+import 'react';
+
+/**
+ * Shared helpers for Refero → Brand Package compilation.
+ * Preset builders live in compile-refero.ts; keep color/font extraction here.
+ */
+type Json = Record<string, unknown>;
+
+/**
+ * Compile Refero DTCG tokens.json (+ optional DESIGN.md) into a Brand Package.
+ *
+ * Structure:
+ *   compile-helpers.ts  — detectPreset, color/font leaf helpers
+ *   presets/*           — named fixture builders (linear…notion) + generic
+ *   compile-refero.ts   — orchestration only
+ *
+ * Named fixtures are stress-test carriers (not mood presets). Prefer extending
+ * the generic path + DESIGN.md inference over adding one-off hacks.
+ */
+
+/**
+ * Compile a Refero-style DTCG tokens.json (+ optional DESIGN.md text) into a Brand Package.
+ * Known fixtures get opinionated recipes; generic brands get solid CTAs.
+ */
+declare function compileReferoTokens(input: {
+    tokens: Json;
+    id?: string;
+    name?: string;
+    designMd?: string;
+}): CompileResult;
+
+/**
+ * Emit carrier CSS from a normalized Brand Package.
+ * Components bind: --primary (= action), --brand-mark, --elevation-*, --radius-*.
+ */
+
+type EmitBrandCssMode = 
+/** Single-skin import / Create Center inject — also binds :root (global swap) */
+"global"
+/** Multi-language catalog — only activates under html[data-brand] */
+ | "scoped";
+interface EmitBrandCssOptions {
+    /**
+     * `global` (default): `:root` + `html[data-brand]` — one import recolors the app.
+     * Single-mode dark packs also include `.dark`.
+     * Dual-mode packs (`modes.light` + `modes.dark`) emit separate light/dark color blocks.
+     * `scoped`: only `html[data-brand]` (+ `html.dark[data-brand]` when dual).
+     */
+    mode?: EmitBrandCssMode;
+}
+/** Global single-skin selector list — single-mode packs only. */
+declare function emitGlobalSkinSelector(brandId: string, darkDefault: boolean): string;
+/** Light mode selector (dual-mode). */
+declare function emitLightModeSelector(brandId: string, mode: EmitBrandCssMode): string;
+/** Dark mode selector (dual-mode) — never paints light colors under .dark. */
+declare function emitDarkModeSelector(brandId: string, mode: EmitBrandCssMode): string;
+/**
+ * Emit a single opt-in skin CSS file from a Brand Package.
+ */
+declare function emitBrandCss(brand: BrandPackage, options?: EmitBrandCssOptions): string;
+
+/** Convert #rgb / #rrggbb to HSL channel triple "H S% L%" for shadcn-style vars. */
+declare function hexToHslChannels(hex: string): string;
+/**
+ * Normalize any common color input to HSL channel triple "H S% L%".
+ * Accepts: #hex, "H S% L%", hsl()/hsla(), rgb()/rgba().
+ */
+declare function colorToHslChannels(color: string): string;
+/** Prefer {@link colorToHslChannels}; hex-only name kept for call sites. */
+declare function tryHexToHsl(hex: string | undefined, fallback: string): string;
+declare function tryColorToHsl(color: string | undefined, fallback: string): string;
+
+interface InferredRecipeHints {
+    buttonDefault?: ButtonDefaultStyle;
+    elevationPreset?: ElevationStyle;
+    density?: Density;
+    /** Free radii slots from DESIGN.md tables / free-text */
+    radii?: {
+        button?: string;
+        card?: string;
+    };
+    notes: string[];
+}
+/**
+ * Infer control recipe from DESIGN.md / agent prompt text.
+ * Used for generic brands and to refine known fixtures.
+ */
+declare function inferRecipeFromDesignMd(designMd: string): InferredRecipeHints;
+
+/**
+ * Normalize Brand Packages into the carrier contract.
+ * Accepts legacy recipe fields and missing roles; always outputs full roles + free elev/radii.
+ */
+
+/** Expand elevation preset → free CSS tokens. */
+declare function elevationPresetToTokens(preset: ElevationStyle | undefined, cardShadow?: string): BrandElevationTokens;
+declare function rolesFromSemantic(s: BrandSemanticColors, brandMark?: {
+    brand?: string;
+    brandForeground?: string;
+}): BrandColorRoles;
+/** roles → shadcn semantic: primary ALWAYS tracks action (CTA), never brand mark. */
+declare function semanticFromRoles(r: BrandColorRoles): BrandSemanticColors;
+/** Canonicalize one mode palette → full roles + semantic. */
+declare function normalizeModePalette(palette: BrandModePalette, categoryBrand?: string): {
+    roles: BrandColorRoles;
+    semantic: BrandSemanticColors;
+};
+/** Ensure package has roles + free radii/elev; strip legacy recipe aliases from output. */
+declare function normalizeBrandPackage(brand: BrandPackage | BrandPackageInput): BrandPackage;
+/** True when package has full dual light+dark palettes. */
+declare function isDualModeBrand(brand: BrandPackage): boolean;
+
+interface ValidationResult {
+    ok: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/** Validate carrier contract before Create Center publish. */
+declare function validateBrandPackage(brand: unknown): ValidationResult;
+
+export { BrandColorRoles, BrandElevationTokens, BrandModePalette, BrandPackage, BrandPackageInput, BrandSemanticColors, ButtonDefaultStyle, CompileResult, Density, ElevationStyle, type EmitBrandCssMode, type EmitBrandCssOptions, type InferredRecipeHints, type ValidationResult, colorToHslChannels, compileReferoTokens, elevationPresetToTokens, emitBrandCss, emitDarkModeSelector, emitGlobalSkinSelector, emitLightModeSelector, hexToHslChannels, inferRecipeFromDesignMd, isDualModeBrand, normalizeBrandPackage, normalizeModePalette, rolesFromSemantic, semanticFromRoles, tryColorToHsl, tryHexToHsl, validateBrandPackage };

package/dist/brand-package/index.js

@@ -0,0 +1,61 @@
+import {
+  compileReferoTokens,
+  inferRecipeFromDesignMd,
+  validateBrandPackage
+} from "../chunk-RGUJQOLH.js";
+import {
+  BRAND_STORAGE_KEY,
+  BRAND_STYLE_ELEMENT_ID,
+  applyBrandCss,
+  applyBrandPackage,
+  applyBrandToIframe,
+  clearBrand,
+  colorToHslChannels,
+  elevationPresetToTokens,
+  emitBrandCss,
+  emitDarkModeSelector,
+  emitGlobalSkinSelector,
+  emitLightModeSelector,
+  getActiveBrandId,
+  hexToHslChannels,
+  isDualModeBrand,
+  normalizeBrandPackage,
+  normalizeModePalette,
+  restorePersistedBrand,
+  rolesFromSemantic,
+  semanticFromRoles,
+  tryColorToHsl,
+  tryHexToHsl,
+  useBrand,
+  useBrandIframePreview
+} from "../chunk-ALJTP5HL.js";
+export {
+  BRAND_STORAGE_KEY,
+  BRAND_STYLE_ELEMENT_ID,
+  applyBrandCss,
+  applyBrandPackage,
+  applyBrandToIframe,
+  clearBrand,
+  colorToHslChannels,
+  compileReferoTokens,
+  elevationPresetToTokens,
+  emitBrandCss,
+  emitDarkModeSelector,
+  emitGlobalSkinSelector,
+  emitLightModeSelector,
+  getActiveBrandId,
+  hexToHslChannels,
+  inferRecipeFromDesignMd,
+  isDualModeBrand,
+  normalizeBrandPackage,
+  normalizeModePalette,
+  restorePersistedBrand,
+  rolesFromSemantic,
+  semanticFromRoles,
+  tryColorToHsl,
+  tryHexToHsl,
+  useBrand,
+  useBrandIframePreview,
+  validateBrandPackage
+};
+//# sourceMappingURL=index.js.map

package/dist/brand-package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/brand-package/use-brand.d.ts

@@ -0,0 +1,2 @@
+import 'react';
+export { w as BrandIframePreviewOptions, U as UseBrandIframePreviewResult, G as UseBrandOptions, I as UseBrandResult, i as applyBrandToIframe, u as useBrand, l as useBrandIframePreview } from '../use-brand-C8d4DPqE.js';

package/dist/brand-package/use-brand.js

@@ -0,0 +1,12 @@
+"use client";
+import {
+  applyBrandToIframe,
+  useBrand,
+  useBrandIframePreview
+} from "../chunk-ALJTP5HL.js";
+export {
+  applyBrandToIframe,
+  useBrand,
+  useBrandIframePreview
+};
+//# sourceMappingURL=use-brand.js.map

package/dist/brand-package/use-brand.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}