tailwind-to-style 3.2.2 → 4.0.0

package/dist/tokens/index.cjs

@@ -0,0 +1,359 @@
+/**
+ * tailwind-to-style v4.0.0
+ * Zero-build runtime Tailwind CSS engine
+ * 
+ * @author Bigetion
+ * @license MIT
+ */
+'use strict';
+
+function _arrayLikeToArray(r, a) {
+  (null == a || a > r.length) && (a = r.length);
+  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
+  return n;
+}
+function _arrayWithHoles(r) {
+  if (Array.isArray(r)) return r;
+}
+function _defineProperty(e, r, t) {
+  return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+    value: t,
+    enumerable: true,
+    configurable: true,
+    writable: true
+  }) : e[r] = t, e;
+}
+function _iterableToArrayLimit(r, l) {
+  var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
+  if (null != t) {
+    var e,
+      n,
+      i,
+      u,
+      a = [],
+      f = true,
+      o = false;
+    try {
+      if (i = (t = t.call(r)).next, 0 === l) ; else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0);
+    } catch (r) {
+      o = true, n = r;
+    } finally {
+      try {
+        if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return;
+      } finally {
+        if (o) throw n;
+      }
+    }
+    return a;
+  }
+}
+function _nonIterableRest() {
+  throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function ownKeys(e, r) {
+  var t = Object.keys(e);
+  if (Object.getOwnPropertySymbols) {
+    var o = Object.getOwnPropertySymbols(e);
+    r && (o = o.filter(function (r) {
+      return Object.getOwnPropertyDescriptor(e, r).enumerable;
+    })), t.push.apply(t, o);
+  }
+  return t;
+}
+function _objectSpread2(e) {
+  for (var r = 1; r < arguments.length; r++) {
+    var t = null != arguments[r] ? arguments[r] : {};
+    r % 2 ? ownKeys(Object(t), true).forEach(function (r) {
+      _defineProperty(e, r, t[r]);
+    }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) {
+      Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r));
+    });
+  }
+  return e;
+}
+function _slicedToArray(r, e) {
+  return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest();
+}
+function _toPrimitive(t, r) {
+  if ("object" != typeof t || !t) return t;
+  var e = t[Symbol.toPrimitive];
+  if (void 0 !== e) {
+    var i = e.call(t, r);
+    if ("object" != typeof i) return i;
+    throw new TypeError("@@toPrimitive must return a primitive value.");
+  }
+  return ("string" === r ? String : Number)(t);
+}
+function _toPropertyKey(t) {
+  var i = _toPrimitive(t, "string");
+  return "symbol" == typeof i ? i : i + "";
+}
+function _unsupportedIterableToArray(r, a) {
+  if (r) {
+    if ("string" == typeof r) return _arrayLikeToArray(r, a);
+    var t = {}.toString.call(r).slice(8, -1);
+    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
+  }
+}
+
+/**
+ * tailwind-to-style/tokens — Design Token System
+ *
+ * Provides CSS variable-based theming with a globalThis singleton registry.
+ * Tokens are injected as CSS custom properties on :root.
+ *
+ * @module tailwind-to-style/tokens
+ */
+
+// ============================================================================
+// Singleton Registry (globalThis)
+// ============================================================================
+
+const REGISTRY_KEY = '__TWS_TOKEN_REGISTRY__';
+function getRegistry() {
+  if (!globalThis[REGISTRY_KEY]) {
+    globalThis[REGISTRY_KEY] = {
+      tokens: {},
+      themes: {},
+      activeTheme: null,
+      subscribers: new Set(),
+      styleElement: null
+    };
+  }
+  return globalThis[REGISTRY_KEY];
+}
+
+// ============================================================================
+// Token Registry API
+// ============================================================================
+
+/**
+ * The token registry — get, set, subscribe to token changes.
+ */
+const tokenRegistry = {
+  /**
+   * Get a token value by path (dot notation).
+   * @param {string} path - Token path, e.g. "colors.primary"
+   * @returns {string|undefined} Token value
+   */
+  get(path) {
+    const registry = getRegistry();
+    const keys = path.split('.');
+    let current = registry.tokens;
+    for (const key of keys) {
+      if (current === undefined || current === null) return undefined;
+      current = current[key];
+    }
+    return current;
+  },
+  /**
+   * Set a token value by path. Triggers subscribers and updates CSS.
+   * @param {string} path - Token path, e.g. "colors.primary"
+   * @param {string} value - Token value
+   */
+  set(path, value) {
+    const registry = getRegistry();
+    const keys = path.split('.');
+    let current = registry.tokens;
+    for (let i = 0; i < keys.length - 1; i++) {
+      if (!(keys[i] in current) || typeof current[keys[i]] !== 'object') {
+        current[keys[i]] = {};
+      }
+      current = current[keys[i]];
+    }
+    current[keys[keys.length - 1]] = value;
+    notifySubscribers();
+    injectTokenCSS();
+  },
+  /**
+   * Subscribe to token changes.
+   * @param {Function} callback - Called when tokens change
+   * @returns {Function} Unsubscribe function
+   */
+  subscribe(callback) {
+    const registry = getRegistry();
+    registry.subscribers.add(callback);
+    return () => registry.subscribers.delete(callback);
+  },
+  /**
+   * Get all tokens as a flat CSS custom properties string.
+   * @returns {string} CSS string with custom properties
+   */
+  toCSS() {
+    const registry = getRegistry();
+    const vars = flattenTokens(registry.tokens, '--tws');
+    if (vars.length === 0) return '';
+    return ":root {\n".concat(vars.map(_ref => {
+      let _ref2 = _slicedToArray(_ref, 2),
+        k = _ref2[0],
+        v = _ref2[1];
+      return "  ".concat(k, ": ").concat(v, ";");
+    }).join('\n'), "\n}");
+  },
+  /**
+   * Get all registered tokens as a plain object.
+   * @returns {Object} Token tree
+   */
+  getAll() {
+    return _objectSpread2({}, getRegistry().tokens);
+  },
+  /**
+   * Clear all tokens.
+   */
+  clear() {
+    const registry = getRegistry();
+    registry.tokens = {};
+    registry.activeTheme = null;
+    notifySubscribers();
+    injectTokenCSS();
+  }
+};
+
+// ============================================================================
+// createTheme()
+// ============================================================================
+
+/**
+ * Create and activate a theme by injecting CSS custom properties.
+ *
+ * @param {Object} tokens - Token definition object (nested)
+ * @param {Object} [options] - Options
+ * @param {string} [options.name] - Theme name for reference
+ * @param {string} [options.selector] - CSS selector to scope theme (default: ":root")
+ * @returns {Object} Theme object with name and token values
+ *
+ * @example
+ * createTheme({
+ *   colors: { primary: '#3b82f6', secondary: '#8b5cf6' },
+ *   spacing: { sm: '0.5rem', md: '1rem', lg: '1.5rem' },
+ *   radius: { sm: '0.25rem', md: '0.5rem' },
+ * });
+ * // Injects: --tws-colors-primary: #3b82f6; --tws-colors-secondary: #8b5cf6; ...
+ */
+function createTheme(tokens) {
+  let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  const _options$name = options.name,
+    name = _options$name === void 0 ? 'default' : _options$name,
+    _options$selector = options.selector,
+    selector = _options$selector === void 0 ? ':root' : _options$selector;
+  const registry = getRegistry();
+
+  // Merge tokens into registry
+  deepMerge(registry.tokens, tokens);
+  registry.activeTheme = name;
+  registry.themes[name] = {
+    tokens: _objectSpread2({}, tokens),
+    selector
+  };
+  notifySubscribers();
+  injectTokenCSS(selector);
+  return {
+    name,
+    tokens,
+    selector,
+    /** Get a CSS variable reference for use in styles */
+    var(path) {
+      return "var(--tws-".concat(path.replace(/\./g, '-'), ")");
+    }
+  };
+}
+
+/**
+ * Switch to a previously defined theme.
+ * @param {string} name - Theme name
+ */
+function activateTheme(name) {
+  const registry = getRegistry();
+  const theme = registry.themes[name];
+  if (!theme) {
+    throw new Error("[tailwind-to-style/tokens] Theme \"".concat(name, "\" not found."));
+  }
+  registry.tokens = _objectSpread2({}, theme.tokens);
+  registry.activeTheme = name;
+  notifySubscribers();
+  injectTokenCSS(theme.selector);
+}
+
+/**
+ * Get a CSS variable reference string for a token path.
+ * @param {string} path - Token path (dot notation)
+ * @param {string} [fallback] - Fallback value
+ * @returns {string} CSS var() expression
+ */
+function token(path, fallback) {
+  const varName = "--tws-".concat(path.replace(/\./g, '-'));
+  return fallback ? "var(".concat(varName, ", ").concat(fallback, ")") : "var(".concat(varName, ")");
+}
+
+// ============================================================================
+// Internal Helpers
+// ============================================================================
+
+function flattenTokens(obj, prefix) {
+  const result = [];
+  for (const _ref3 of Object.entries(obj)) {
+    var _ref4 = _slicedToArray(_ref3, 2);
+    const key = _ref4[0];
+    const value = _ref4[1];
+    const varName = "".concat(prefix, "-").concat(key);
+    if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+      result.push(...flattenTokens(value, varName));
+    } else {
+      result.push([varName, value]);
+    }
+  }
+  return result;
+}
+function deepMerge(target, source) {
+  for (const _ref5 of Object.entries(source)) {
+    var _ref6 = _slicedToArray(_ref5, 2);
+    const key = _ref6[0];
+    const value = _ref6[1];
+    if (typeof value === 'object' && value !== null && !Array.isArray(value) && typeof target[key] === 'object' && target[key] !== null) {
+      deepMerge(target[key], value);
+    } else {
+      // Deep clone objects to avoid mutating the source
+      target[key] = typeof value === 'object' && value !== null && !Array.isArray(value) ? deepMerge({}, value) : value;
+    }
+  }
+  return target;
+}
+function notifySubscribers() {
+  const registry = getRegistry();
+  for (const fn of registry.subscribers) {
+    try {
+      fn(registry.tokens);
+    } catch (e) {
+      // Ignore subscriber errors
+    }
+  }
+}
+function injectTokenCSS() {
+  let selector = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : ':root';
+  if (typeof document === 'undefined') return;
+  const registry = getRegistry();
+  const vars = flattenTokens(registry.tokens, '--tws');
+  if (vars.length === 0) {
+    if (registry.styleElement) {
+      registry.styleElement.textContent = '';
+    }
+    return;
+  }
+  const css = "".concat(selector, " {\n").concat(vars.map(_ref7 => {
+    let _ref8 = _slicedToArray(_ref7, 2),
+      k = _ref8[0],
+      v = _ref8[1];
+    return "  ".concat(k, ": ").concat(v, ";");
+  }).join('\n'), "\n}");
+  if (!registry.styleElement) {
+    registry.styleElement = document.createElement('style');
+    registry.styleElement.setAttribute('data-tws-tokens', '');
+    document.head.appendChild(registry.styleElement);
+  }
+  registry.styleElement.textContent = css;
+}
+
+exports.activateTheme = activateTheme;
+exports.createTheme = createTheme;
+exports.token = token;
+exports.tokenRegistry = tokenRegistry;

package/dist/tokens/index.d.ts

@@ -0,0 +1,33 @@
+// Type definitions for tailwind-to-style/tokens
+
+export interface TokenRegistry {
+  get(path: string): string | undefined;
+  set(path: string, value: string): void;
+  subscribe(callback: (tokens: Record<string, any>) => void): () => void;
+  toCSS(): string;
+  getAll(): Record<string, any>;
+  clear(): void;
+}
+
+export interface ThemeResult {
+  name: string;
+  tokens: Record<string, any>;
+  selector: string;
+  var(path: string): string;
+}
+
+export interface CreateThemeOptions {
+  name?: string;
+  selector?: string;
+}
+
+export declare const tokenRegistry: TokenRegistry;
+
+export declare function createTheme(
+  tokens: Record<string, any>,
+  options?: CreateThemeOptions
+): ThemeResult;
+
+export declare function activateTheme(name: string): void;
+
+export declare function token(path: string, fallback?: string): string;