@ttoss/fsl-theme 1.1.13 → 1.1.15

package/dist/helpers-CaswNJMy.mjs

@@ -0,0 +1,211 @@
+/** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
+//#region src/roots/helpers.ts
+/** Check if a value is a token reference like `{core.colors.brand.500}` */
+const isTokenRef = value => {
+  return typeof value === "string" && value.length > 2 && value.startsWith("{") && value.endsWith("}");
+};
+/** Extract the inner path from a token reference: `{core.colors.brand.500}` → `core.colors.brand.500` */
+const extractRefPath = ref => {
+  return ref.slice(1, -1);
+};
+/**
+* Allowed characters for a theme identifier: alphanumeric, hyphens, underscores.
+* Shared between toCssVars (CSS selector injection guard) and ssrScript (SSR inline script).
+* A single definition prevents the two validation paths from silently diverging.
+*/
+const SAFE_ID_RE = /^[a-zA-Z0-9_-]+$/;
+/**
+* Matches every `{token.path}` reference embedded in a string value.
+* Shared between helpers.ts (toFlatTokens) and toCssVars.ts (inlineRefsToVars)
+* so a single definition governs the `{…}` syntax in both resolution paths.
+*/
+const COMPOUND_REF_RE = /\{([^}]+)\}/g;
+const isPlainObject = value => {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+};
+/**
+* Recursively merges `overrides` into `base`.
+* - Plain objects are merged recursively.
+* - All other values (primitives, arrays) are replaced.
+*/
+const deepMerge = (base, overrides) => {
+  if (!isPlainObject(base) || !isPlainObject(overrides)) return overrides ?? base;
+  const result = {
+    ...base
+  };
+  for (const key of Object.keys(overrides)) {
+    const baseVal = result[key];
+    const overVal = overrides[key];
+    if (overVal === void 0) continue;
+    if (isPlainObject(baseVal) && isPlainObject(overVal)) result[key] = deepMerge(baseVal, overVal);else result[key] = overVal;
+  }
+  return result;
+};
+/**
+* Flatten a nested object into a flat record with dot-separated keys.
+*
+* `{ brand: { 500: '#0469E3' } }` → `{ 'brand.500': '#0469E3' }`
+*/
+const flattenObject = (obj, prefix = "") => {
+  const result = {};
+  for (const [key, value] of Object.entries(obj)) {
+    const fullKey = prefix ? `${prefix}.${key}` : key;
+    if (isPlainObject(value)) Object.assign(result, flattenObject(value, fullKey));else if (typeof value === "string" || typeof value === "number") result[fullKey] = value;
+  }
+  return result;
+};
+/**
+* Flatten a `ThemeTokens` into separate `{ core, semantic }` flat records
+* with dot-separated keys. Centralizes the unsafe casts needed to traverse
+* the opaque token trees.
+*
+* Used by both `toFlatTokens` (resolution) and `buildCssVars` (CSS emission)
+* so the casts live in exactly one place.
+*/
+const flattenTheme = theme => {
+  return {
+    core: flattenObject(theme.core, "core"),
+    semantic: flattenObject(theme.semantic, "semantic")
+  };
+};
+/**
+* Compute the Levenshtein edit distance between two strings.
+* Used exclusively by `validateRefs` to power "did you mean?" suggestions.
+*/
+const levenshtein = (a, b) => {
+  const m = a.length;
+  const n = b.length;
+  const dp = Array.from({
+    length: m + 1
+  }, () => {
+    return Array.from({
+      length: n + 1
+    }, () => {
+      return 0;
+    });
+  });
+  for (let i = 0; i <= m; i++) dp[i][0] = i;
+  for (let j = 0; j <= n; j++) dp[0][j] = j;
+  for (let i = 1; i <= m; i++) for (let j = 1; j <= n; j++) dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+  return dp[m][n];
+};
+/**
+* Validate that every `{ref}` in the merged theme points to an existing path.
+* Emits `console.warn` for each broken reference with a "did you mean?" suggestion.
+*
+* **DEV-only** — callers gate this behind `process.env.NODE_ENV !== 'production'`
+* so bundlers tree-shake the entire call in production builds.
+*/
+const validateRefs = theme => {
+  const {
+    core,
+    semantic
+  } = flattenTheme(theme);
+  const all = {
+    ...core,
+    ...semantic
+  };
+  const allKeys = Object.keys(all);
+  const findSuggestion = (refPath, candidates) => {
+    if (candidates.length === 0) return "";
+    let bestDist = Infinity;
+    let bestKey = "";
+    for (const candidate of candidates) {
+      const dist = levenshtein(refPath, candidate);
+      if (dist < bestDist) {
+        bestDist = dist;
+        bestKey = candidate;
+      }
+    }
+    if (bestDist <= Math.ceil(refPath.length * .4)) return `\n   Did you mean '{${bestKey}}'?`;
+    return "";
+  };
+  for (const [ownerKey, value] of Object.entries(all)) {
+    if (typeof value !== "string" || !value.includes("{")) continue;
+    let match;
+    const re = new RegExp(COMPOUND_REF_RE.source, COMPOUND_REF_RE.flags);
+    while ((match = re.exec(value)) !== null) {
+      const refPath = match[1];
+      if (all[refPath] !== void 0) continue;
+      const prefix = refPath.split(".")[0];
+      const suggestion = findSuggestion(refPath, allKeys.filter(k => {
+        return k.startsWith(prefix + ".");
+      }));
+      console.warn(`[fsl-theme] Invalid token reference '{${refPath}}' at path '${ownerKey}'.${suggestion}`);
+    }
+  }
+};
+/**
+* Flatten a `ThemeTokens` into a `Record<string, string | number>` with
+* every `{ref}` recursively resolved to its final raw value where possible.
+*
+* By default, unresolvable references (missing target or circular dependency)
+* are preserved as-is in the output. Pass `{ strict: true }` to instead throw
+* on any unresolved reference — useful in tests and build steps that must
+* fail loudly on palette drift.
+*
+* This is the universal primitive — every root is derived from this.
+*/
+const toFlatTokens = (theme, options = {}) => {
+  const {
+    strict = false
+  } = options;
+  const {
+    core: coreFlat,
+    semantic: semanticFlat
+  } = flattenTheme(theme);
+  const all = {
+    ...coreFlat,
+    ...semanticFlat
+  };
+  const unresolved = [];
+  const reportUnresolved = (key, path, reason) => {
+    if (strict) unresolved.push(`${key} → {${path}} (${reason})`);
+  };
+  /** Resolve a single pure `{path}` reference to its raw value. */
+  const resolveRef = (value, seen, ownerKey) => {
+    if (typeof value !== "string" || !isTokenRef(value)) return value;
+    const path = extractRefPath(value);
+    if (seen.has(path)) {
+      reportUnresolved(ownerKey, path, "circular reference");
+      return value;
+    }
+    const target = all[path];
+    if (target === void 0) {
+      reportUnresolved(ownerKey, path, "missing target");
+      return value;
+    }
+    seen.add(path);
+    return resolveRef(target, seen, ownerKey);
+  };
+  /**
+  * Resolve all embedded `{path}` refs in a raw string expression.
+  *
+  * Handles both pure refs (`{core.space.4}`) and compound expressions
+  * (`clamp({core.space.4}, {core.space.6}, {core.space.12})`).
+  */
+  const resolveInline = (value, seen, ownerKey) => {
+    return value.replace(COMPOUND_REF_RE, (_match, path) => {
+      const target = all[path];
+      if (target === void 0) {
+        reportUnresolved(ownerKey, path, "missing target");
+        return `{${path}}`;
+      }
+      if (seen.has(path)) {
+        reportUnresolved(ownerKey, path, "circular reference");
+        return `{${path}}`;
+      }
+      const resolved = resolveRef(target, new Set(seen).add(path), ownerKey);
+      return String(resolved);
+    });
+  };
+  const resolved = {};
+  for (const [key, value] of Object.entries(all)) if (typeof value === "string") {
+    if (isTokenRef(value)) resolved[key] = resolveRef(value, /* @__PURE__ */new Set(), key);else if (value.includes("{")) resolved[key] = resolveInline(value, /* @__PURE__ */new Set(), key);else resolved[key] = value;
+  } else resolved[key] = value;
+  if (strict && unresolved.length > 0) throw new Error(`toFlatTokens: ${unresolved.length} unresolved reference(s):\n  ${unresolved.join("\n  ")}`);
+  return resolved;
+};
+
+//#endregion
+export { flattenTheme as a, validateRefs as c, flattenObject as i, SAFE_ID_RE as n, isPlainObject as o, deepMerge as r, toFlatTokens as s, COMPOUND_REF_RE as t };

package/dist/{index.d.ts → index-CsIjfw86.d.cts}

@@ -1,14 +1,6 @@
-import { T as ThemeTokens, M as ModeOverride, a as ThemeBundle, D as DeepPartial } from './Types-6tR0_2Ss.js';
-export { S as SemanticTokens } from './Types-6tR0_2Ss.js';
-export { ThemeHeadProps, ThemeStylesProps } from './react.js';
-export { ThemeMode } from './runtime-entry.js';
-export { bruttal } from './themes/bruttal.js';
-export { corporate } from './themes/corporate.js';
-export { oca } from './themes/oca.js';
-export { ventures } from './themes/ventures.js';
-import 'react/jsx-runtime';
-import 'react';
 
+import { a as DeepPartial, i as ThemeTokens, r as ThemeBundle, t as ModeOverride } from "./Types-BiBa17RL.cjs";
+//#region src/baseTheme.d.ts
 /**
  * **Foundation** — Neutral baseline theme.
  *
@@ -17,7 +9,8 @@ import 'react';
  */
 declare const baseTheme: ThemeTokens;
 declare const darkAlternate: ModeOverride;
-
+//#endregion
+//#region src/createTheme.d.ts
 /**
  * Creates a theme bundle with an optional alternate color mode.
  *
@@ -60,27 +53,42 @@ declare const darkAlternate: ModeOverride;
  * const myTheme = createTheme({ alternate: null });
  * ```
  */
-declare const createTheme: ({ extends: parentBundle, baseMode, base, overrides, alternate, }?: {
-    /**
-     * Parent bundle to inherit from. `base`, `baseMode`, and `alternate` all
-     * default to the parent's values — including dark-mode inheritance.
-     *
-     * `extends` is a reserved word in JS — destructured as `parentBundle`
-     * in the implementation.
-     */
-    extends?: ThemeBundle;
-    /** Which mode the base represents. Defaults to `extends.baseMode` or `'light'`. */
-    baseMode?: "light" | "dark";
-    /** Base theme to extend. Defaults to `extends.base` or `baseTheme`. */
-    base?: ThemeTokens;
-    /** Brand overrides applied to the base theme. */
-    overrides?: DeepPartial<ThemeTokens>;
-    /**
-     * Semantic remapping overrides for the opposite mode.
-     * Defaults to `darkAlternate` when not provided (and no `extends`).
-     * Pass `null` to opt out of any alternate (single-mode theme).
-     */
-    alternate?: ModeOverride | null;
+declare const createTheme: ({
+  extends: parentBundle,
+  baseMode,
+  base,
+  overrides,
+  alternate
+}?: {
+  /**
+   * Parent bundle to inherit from. `base`, `baseMode`, and `alternate` all
+   * default to the parent's values — including dark-mode inheritance.
+   *
+   * `extends` is a reserved word in JS — destructured as `parentBundle`
+   * in the implementation.
+   */
+  extends?: ThemeBundle; /** Which mode the base represents. Defaults to `extends.baseMode` or `'light'`. */
+  baseMode?: "light" | "dark"; /** Base theme to extend. Defaults to `extends.base` or `baseTheme`. */
+  base?: ThemeTokens; /** Brand overrides applied to the base theme. */
+  overrides?: DeepPartial<ThemeTokens>;
+  /**
+   * Semantic remapping overrides for the opposite mode.
+   * Defaults to `darkAlternate` when not provided (and no `extends`).
+   * Pass `null` to opt out of any alternate (single-mode theme).
+   */
+  alternate?: ModeOverride | null;
 }) => ThemeBundle;
-
-export { DeepPartial, ModeOverride, ThemeBundle, ThemeTokens, baseTheme, createTheme, darkAlternate };
+//#endregion
+//#region src/themes/bruttal.d.ts
+declare const bruttal: ThemeBundle;
+//#endregion
+//#region src/themes/corporate.d.ts
+declare const corporate: ThemeBundle;
+//#endregion
+//#region src/themes/oca.d.ts
+declare const oca: ThemeBundle;
+//#endregion
+//#region src/themes/ventures.d.ts
+declare const ventures: ThemeBundle;
+//#endregion
+export { createTheme as a, bruttal as i, oca as n, baseTheme as o, corporate as r, darkAlternate as s, ventures as t };

package/dist/index-nJrjI0BA.d.mts

@@ -0,0 +1,94 @@
+
+import { a as DeepPartial, i as ThemeTokens, r as ThemeBundle, t as ModeOverride } from "./Types-BiBa17RL.mjs";
+//#region src/baseTheme.d.ts
+/**
+ * **Foundation** — Neutral baseline theme.
+ *
+ * System fonts, gray palette, and balanced proportions. Serves as the
+ * canonical base that all other themes extend via `createTheme`.
+ */
+declare const baseTheme: ThemeTokens;
+declare const darkAlternate: ModeOverride;
+//#endregion
+//#region src/createTheme.d.ts
+/**
+ * Creates a theme bundle with an optional alternate color mode.
+ *
+ * The `extends` param is the idiomatic way to build on a built-in theme:
+ * it inherits the base tokens **and** the dark-mode alternate automatically.
+ *
+ * @param params.extends - Parent bundle to inherit from. `base`, `baseMode`, and
+ *   `alternate` default to the parent's values when this is provided.
+ * @param params.baseMode - Which mode the base represents. Defaults to `'light'`.
+ * @param params.base - Base theme to extend. Defaults to `extends.base` or `baseTheme`.
+ * @param params.overrides - Brand overrides applied to the base theme.
+ * @param params.alternate - Semantic remapping overrides for the opposite color mode.
+ *   Defaults to `darkAlternate` (built-in dark mode) when neither `alternate` nor
+ *   `extends` is provided. Inherits from `extends.alternate` when `extends` is given.
+ *   Pass `null` to explicitly opt out of any alternate (single-mode theme).
+ *   Core tokens are immutable — only semantic references change between modes.
+ *
+ * @example
+ * ```ts
+ * // Path A — default foundation (light base + dark alternate included)
+ * const myTheme = createTheme();
+ * <ThemeProvider theme={myTheme} />
+ *
+ * // Path B — custom brand overrides (dark mode still included)
+ * const myTheme = createTheme({
+ *   overrides: { core: { colors: { brand: { 500: '#FF0000' } } } },
+ * });
+ *
+ * // Path C — custom semantic dark alternate
+ * const myTheme = createTheme({
+ *   overrides: { core: { colors: { brand: { 500: '#FF0000' } } } },
+ *   alternate: {
+ *     semantic: {
+ *       colors: { informational: { primary: { background: { default: '{core.colors.neutral.900}' } } } },
+ *     },
+ *   },
+ * });
+ *
+ * // Path D — single-mode theme (no dark alternate)
+ * const myTheme = createTheme({ alternate: null });
+ * ```
+ */
+declare const createTheme: ({
+  extends: parentBundle,
+  baseMode,
+  base,
+  overrides,
+  alternate
+}?: {
+  /**
+   * Parent bundle to inherit from. `base`, `baseMode`, and `alternate` all
+   * default to the parent's values — including dark-mode inheritance.
+   *
+   * `extends` is a reserved word in JS — destructured as `parentBundle`
+   * in the implementation.
+   */
+  extends?: ThemeBundle; /** Which mode the base represents. Defaults to `extends.baseMode` or `'light'`. */
+  baseMode?: "light" | "dark"; /** Base theme to extend. Defaults to `extends.base` or `baseTheme`. */
+  base?: ThemeTokens; /** Brand overrides applied to the base theme. */
+  overrides?: DeepPartial<ThemeTokens>;
+  /**
+   * Semantic remapping overrides for the opposite mode.
+   * Defaults to `darkAlternate` when not provided (and no `extends`).
+   * Pass `null` to opt out of any alternate (single-mode theme).
+   */
+  alternate?: ModeOverride | null;
+}) => ThemeBundle;
+//#endregion
+//#region src/themes/bruttal.d.ts
+declare const bruttal: ThemeBundle;
+//#endregion
+//#region src/themes/corporate.d.ts
+declare const corporate: ThemeBundle;
+//#endregion
+//#region src/themes/oca.d.ts
+declare const oca: ThemeBundle;
+//#endregion
+//#region src/themes/ventures.d.ts
+declare const ventures: ThemeBundle;
+//#endregion
+export { createTheme as a, bruttal as i, oca as n, baseTheme as o, corporate as r, darkAlternate as s, ventures as t };

package/dist/index.cjs

@@ -0,0 +1,16 @@
+/** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
+Object.defineProperty(exports, Symbol.toStringTag, {
+  value: 'Module'
+});
+const require_createTheme = require('./createTheme-Cv6RP9D6.cjs');
+const require_themes_bruttal = require('./themes/bruttal.cjs');
+const require_themes_corporate = require('./themes/corporate.cjs');
+const require_themes_oca = require('./themes/oca.cjs');
+const require_themes_ventures = require('./themes/ventures.cjs');
+exports.baseTheme = require_createTheme.baseTheme;
+exports.bruttal = require_themes_bruttal.bruttal;
+exports.corporate = require_themes_corporate.corporate;
+exports.createTheme = require_createTheme.createTheme;
+exports.darkAlternate = require_createTheme.darkAlternate;
+exports.oca = require_themes_oca.oca;
+exports.ventures = require_themes_ventures.ventures;

package/dist/index.d.cts

@@ -0,0 +1,6 @@
+
+import { a as DeepPartial, i as ThemeTokens, n as SemanticTokens, r as ThemeBundle, t as ModeOverride } from "./Types-BiBa17RL.cjs";
+import { a as createTheme, i as bruttal, n as oca, o as baseTheme, r as corporate, s as darkAlternate, t as ventures } from "./index-CsIjfw86.cjs";
+import { o as ThemeMode } from "./ssrScript-BVysxDws.cjs";
+import { c as ThemeStylesProps, n as ThemeHeadProps } from "./react-CGa6FlNL.cjs";
+export { type DeepPartial, type ModeOverride, type SemanticTokens, type ThemeBundle, type ThemeHeadProps, type ThemeMode, type ThemeStylesProps, type ThemeTokens, baseTheme, bruttal, corporate, createTheme, darkAlternate, oca, ventures };

package/dist/index.d.mts

@@ -0,0 +1,6 @@
+
+import { a as DeepPartial, i as ThemeTokens, n as SemanticTokens, r as ThemeBundle, t as ModeOverride } from "./Types-BiBa17RL.mjs";
+import { a as createTheme, i as bruttal, n as oca, o as baseTheme, r as corporate, s as darkAlternate, t as ventures } from "./index-nJrjI0BA.mjs";
+import { o as ThemeMode } from "./ssrScript-BVysxDws.mjs";
+import { c as ThemeStylesProps, n as ThemeHeadProps } from "./react-DnKxR2gK.mjs";
+export { type DeepPartial, type ModeOverride, type SemanticTokens, type ThemeBundle, type ThemeHeadProps, type ThemeMode, type ThemeStylesProps, type ThemeTokens, baseTheme, bruttal, corporate, createTheme, darkAlternate, oca, ventures };

package/dist/index.mjs

@@ -0,0 +1,7 @@
+/** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
+import { i as darkAlternate, n as createTheme, r as baseTheme } from "./createTheme-BLNYztZU.mjs";
+import { bruttal } from "./themes/bruttal.mjs";
+import { corporate } from "./themes/corporate.mjs";
+import { oca } from "./themes/oca.mjs";
+import { ventures } from "./themes/ventures.mjs";
+export { baseTheme, bruttal, corporate, createTheme, darkAlternate, oca, ventures };