@frontfriend/tailwind 3.0.0 → 3.0.2

package/dist/index.mjs

@@ -1,2 +1,2 @@
-var u=typeof window<"u"&&typeof window.document<"u",F=typeof process<"u"&&process.versions&&process.versions.node,f=function(){return u&&console.warn("[FrontFriend] The Tailwind plugin cannot be used directly in browser environments"),{}};function c(){let t=new Map,e={get(s,i){return i===Symbol.toPrimitive||i==="valueOf"?()=>"":i==="toString"||i===Symbol.toStringTag?()=>"":i==="constructor"?Object:(t.has(i)||t.set(i,c()),t.get(i))},has(s,i){return!(typeof i=="symbol"&&i.toString().includes("nodejs.util.inspect"))},ownKeys(s){return[]},getOwnPropertyDescriptor(s,i){return{enumerable:!0,configurable:!0}}};return new Proxy({},e)}function a(t){return!t||typeof t!="object"?c():t}var r=null,n=null;function o(){if(typeof __FF_CONFIG__<"u")return __FF_CONFIG__;if(typeof process<"u"&&process.env){if(process.env.NEXT_PUBLIC_FF_CONFIG)try{return JSON.parse(process.env.NEXT_PUBLIC_FF_CONFIG)}catch{console.warn("[FrontFriend] Failed to parse NEXT_PUBLIC_FF_CONFIG from environment")}if(process.env.__FF_CONFIG__)try{return JSON.parse(process.env.__FF_CONFIG__)}catch{console.warn("[FrontFriend] Failed to parse __FF_CONFIG__ from environment")}}return u&&window.__FF_CONFIG__?window.__FF_CONFIG__:null}function _(){if(typeof __FF_ICONS__<"u")return __FF_ICONS__;if(typeof process<"u"&&process.env){if(process.env.NEXT_PUBLIC_FF_ICONS)try{return JSON.parse(process.env.NEXT_PUBLIC_FF_ICONS)}catch{console.warn("[FrontFriend] Failed to parse NEXT_PUBLIC_FF_ICONS from environment")}if(process.env.__FF_ICONS__)try{return JSON.parse(process.env.__FF_ICONS__)}catch{console.warn("[FrontFriend] Failed to parse __FF_ICONS__ from environment")}}return u&&window.__FF_ICONS__?window.__FF_ICONS__:null}var l=new Proxy({},{_proxyCache:new Map,get(t,e){return e===Symbol.toPrimitive||e==="valueOf"?()=>"":e==="toString"||e===Symbol.toStringTag?()=>"[object Object]":e==="constructor"?Object:(r||(r=o()),r&&e in r?r[e]:(this._proxyCache.has(e)||this._proxyCache.set(e,c()),this._proxyCache.get(e)))},has(t,e){return r||(r=o()),r?e in r:!0},ownKeys(t){return r||(r=o()),r?Object.keys(r):[]},getOwnPropertyDescriptor(t,e){return r||(r=o()),r&&e in r?Object.getOwnPropertyDescriptor(r,e):{enumerable:!0,configurable:!0}}}),d=new Proxy({},{get(t,e){return e===Symbol.toPrimitive||e==="valueOf"?()=>"":e==="toString"||e===Symbol.toStringTag?()=>"[object Object]":e==="constructor"?Object:(n||(n=_()),n&&e in n?n[e]:null)},has(t,e){return n||(n=_()),n?e in n:!1},ownKeys(t){return n||(n=_()),n?Object.keys(n):[]},getOwnPropertyDescriptor(t,e){if(n||(n=_()),n&&e in n)return Object.getOwnPropertyDescriptor(n,e)}}),O=f;export{l as config,O as default,a as ffdc,d as iconSet};
+var _=(t=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(t,{get:(e,r)=>(typeof require<"u"?require:e)[r]}):t)(function(t){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+t+'" is not supported')});var s=typeof window<"u"&&typeof window.document<"u",i=typeof process<"u"&&process.versions&&process.versions.node,o=null;var u=i?function(...t){if(!o)try{o=_("module").createRequire(import.meta.url)("./index.js")}catch(e){return console.error("[FrontFriend] Failed to load plugin:",e),{}}return typeof o=="function"?o(...t):o}:function(){return s&&console.warn("[FrontFriend] The Tailwind plugin cannot be used directly in browser environments"),{}};function c(){let t=new Map,e={get(r,n){return n===Symbol.toPrimitive||n==="valueOf"?()=>"":n==="toString"||n===Symbol.toStringTag?()=>"":n==="constructor"?Object:(t.has(n)||t.set(n,c()),t.get(n))},has(r,n){return!(typeof n=="symbol"&&n.toString().includes("nodejs.util.inspect"))},ownKeys(r){return[]},getOwnPropertyDescriptor(r,n){return{enumerable:!0,configurable:!0}}};return new Proxy({},e)}function f(t){return!t||typeof t!="object"?c():t}var l=new Proxy({},{_cjsConfig:null,_proxyCache:new Map,get(t,e){if(e===Symbol.toPrimitive||e==="valueOf")return()=>"";if(e==="toString"||e===Symbol.toStringTag)return()=>"[object Object]";if(e==="constructor")return Object;if(i&&!this._cjsConfig&&o&&(this._cjsConfig=o.config),i&&this._cjsConfig&&e in this._cjsConfig)return this._cjsConfig[e];let r=null;if(typeof __FF_CONFIG__<"u")r=__FF_CONFIG__;else if(typeof process<"u"&&process.env){if(process.env.NEXT_PUBLIC_FF_CONFIG)try{r=JSON.parse(process.env.NEXT_PUBLIC_FF_CONFIG)}catch{console.warn("[FrontFriend] Failed to parse NEXT_PUBLIC_FF_CONFIG")}else if(process.env.__FF_CONFIG__)try{r=JSON.parse(process.env.__FF_CONFIG__)}catch{console.warn("[FrontFriend] Failed to parse __FF_CONFIG__")}}else s&&window.__FF_CONFIG__&&(r=window.__FF_CONFIG__);return r&&e in r?r[e]:(this._proxyCache.has(e)||this._proxyCache.set(e,c()),this._proxyCache.get(e))},has(t,e){return!0},ownKeys(t){return[]},getOwnPropertyDescriptor(t,e){return{enumerable:!0,configurable:!0}}}),F=new Proxy({},{_cjsIconSet:null,get(t,e){if(e===Symbol.toPrimitive||e==="valueOf")return()=>"";if(e==="toString"||e===Symbol.toStringTag)return()=>"[object Object]";if(e==="constructor")return Object;if(i&&!this._cjsIconSet&&o&&(this._cjsIconSet=o.iconSet),i&&this._cjsIconSet&&e in this._cjsIconSet)return this._cjsIconSet[e];let r=null;if(typeof __FF_ICONS__<"u")r=__FF_ICONS__;else if(typeof process<"u"&&process.env){if(process.env.NEXT_PUBLIC_FF_ICONS)try{r=JSON.parse(process.env.NEXT_PUBLIC_FF_ICONS)}catch{console.warn("[FrontFriend] Failed to parse NEXT_PUBLIC_FF_ICONS")}else if(process.env.__FF_ICONS__)try{r=JSON.parse(process.env.__FF_ICONS__)}catch{console.warn("[FrontFriend] Failed to parse __FF_ICONS__")}}else s&&window.__FF_ICONS__&&(r=window.__FF_ICONS__);return r&&e in r?r[e]:null},has(t,e){return!1},ownKeys(t){return[]},getOwnPropertyDescriptor(t,e){}}),d=u;export{l as config,d as default,f as ffdc,F as iconSet};
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../index.mjs"],
-  "sourcesContent": ["// ES Module wrapper for frontfriend-tailwind\n// This file provides ES module exports for browser environments\n\n// Determine environment\nconst isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';\nconst isNode = typeof process !== 'undefined' && process.versions && process.versions.node;\n\n// Default plugin stub for browser\nconst plugin = function() {\n  if (isBrowser) {\n    console.warn('[FrontFriend] The Tailwind plugin cannot be used directly in browser environments');\n  }\n  return {};\n};\n\n/**\n * Creates a deep proxy that gracefully handles arbitrary nested property access\n * without throwing errors. This is essential for SSR and build-time scenarios\n * where configuration might not be loaded yet.\n *\n * Features:\n * - Infinite depth access: config.a.b.c.d.e never crashes\n * - Referential equality: config.a === config.a (memoized)\n * - Iteration support: Object.keys(), spread operator, for...in\n * - Type coercion: Works with toString, valueOf, Symbol.toPrimitive\n * - 'in' operator: 'property' in config returns true\n *\n * @returns {Proxy} A proxy object that handles any property access safely\n *\n * @example\n * const config = createDeepProxy();\n * const value = config.sidebar.root.wrapper.base; // Never crashes\n * config.a === config.a; // true (referential equality)\n * 'anything' in config; // true\n * Object.keys(config); // []\n */\nfunction createDeepProxy() {\n  // Cache for memoization - ensures referential equality\n  // This is critical for React dependency arrays and equality checks\n  const cache = new Map();\n\n  const handler = {\n    /**\n     * Handles property access with memoization\n     * Ensures config.a === config.a for referential equality\n     */\n    get(target, prop) {\n      // Handle special cases for type coercion and inspection\n      if (prop === Symbol.toPrimitive || prop === 'valueOf') {\n        return () => '';\n      }\n      if (prop === 'toString' || prop === Symbol.toStringTag) {\n        return () => '';\n      }\n      if (prop === 'constructor') {\n        return Object;\n      }\n\n      // Return cached proxy for same property to maintain referential equality\n      // This prevents issues with React hooks and memoization\n      if (!cache.has(prop)) {\n        cache.set(prop, createDeepProxy());\n      }\n      return cache.get(prop);\n    },\n\n    /**\n     * Handles 'in' operator\n     * Makes 'property' in config return true for any property\n     */\n    has(target, prop) {\n      // Return true for all properties except internal symbols\n      if (typeof prop === 'symbol' && prop.toString().includes('nodejs.util.inspect')) {\n        return false;\n      }\n      return true;\n    },\n\n    /**\n     * Handles Object.keys(), Object.getOwnPropertyNames(), for...in\n     * Returns empty array since proxy represents missing/unknown config\n     */\n    ownKeys(target) {\n      return [];\n    },\n\n    /**\n     * Handles Object.getOwnPropertyDescriptor()\n     * Required for proper iteration support with ownKeys\n     */\n    getOwnPropertyDescriptor(target, prop) {\n      return {\n        enumerable: true,\n        configurable: true,\n      };\n    },\n  };\n\n  return new Proxy({}, handler);\n}\n\n/**\n * FrontFriend Design Config (ffdc) - Safe config wrapper with SSR support\n *\n * Wraps configuration objects to prevent crashes during SSR or when config\n * is not yet loaded. Returns actual config if valid, or a deep proxy fallback.\n *\n * This is the recommended way to access config in components to ensure\n * they work during both build-time (SSR) and runtime.\n *\n * @param {Object|null|undefined} config - The configuration object to wrap\n * @returns {Object|Proxy} The config object or a safe deep proxy\n *\n * @example\n * import { config, ffdc } from '@frontfriend/tailwind';\n *\n * // Safe access during SSR - never crashes\n * const sidebarConfig = ffdc(config || {}).sidebar;\n * const className = sidebarConfig.root.wrapper.base; // Always safe\n *\n * @example\n * // In a React component\n * function Sidebar() {\n *   const cfg = ffdc(config).sidebar;\n *   return <div className={cfg.root.base}>...</div>;\n * }\n */\nexport function ffdc(config) {\n  // During SSR or initial load, config might not be available yet\n  // Return a deep proxy that handles any property access without crashing\n  if (!config || typeof config !== 'object') {\n    return createDeepProxy();\n  }\n\n  return config;\n}\n\n// In browser environments, config and iconSet must be provided by the build system\n// (e.g., Vite plugin, webpack plugin, etc.) or loaded from a global variable\nlet _config = null;\nlet _iconSet = null;\n\n// Function to get config - tries multiple sources\nfunction getConfig() {\n  // Try global variable first (webpack DefinePlugin)\n  if (typeof __FF_CONFIG__ !== 'undefined') {\n    return __FF_CONFIG__;\n  }\n  // Try Next.js environment variable (Turbopack compatibility)\n  if (typeof process !== 'undefined' && process.env) {\n    // Try NEXT_PUBLIC_ prefixed version first (Next.js requirement)\n    if (process.env.NEXT_PUBLIC_FF_CONFIG) {\n      try {\n        return JSON.parse(process.env.NEXT_PUBLIC_FF_CONFIG);\n      } catch (e) {\n        console.warn('[FrontFriend] Failed to parse NEXT_PUBLIC_FF_CONFIG from environment');\n      }\n    }\n    // Fallback to __ prefixed version for non-Next.js environments\n    if (process.env.__FF_CONFIG__) {\n      try {\n        return JSON.parse(process.env.__FF_CONFIG__);\n      } catch (e) {\n        console.warn('[FrontFriend] Failed to parse __FF_CONFIG__ from environment');\n      }\n    }\n  }\n  // Try window global\n  if (isBrowser && window.__FF_CONFIG__) {\n    return window.__FF_CONFIG__;\n  }\n  return null;\n}\n\n// Function to get icons - tries multiple sources\nfunction getIcons() {\n  // Try global variable first (webpack DefinePlugin)\n  if (typeof __FF_ICONS__ !== 'undefined') {\n    return __FF_ICONS__;\n  }\n  // Try Next.js environment variable (Turbopack compatibility)\n  if (typeof process !== 'undefined' && process.env) {\n    // Try NEXT_PUBLIC_ prefixed version first (Next.js requirement)\n    if (process.env.NEXT_PUBLIC_FF_ICONS) {\n      try {\n        return JSON.parse(process.env.NEXT_PUBLIC_FF_ICONS);\n      } catch (e) {\n        console.warn('[FrontFriend] Failed to parse NEXT_PUBLIC_FF_ICONS from environment');\n      }\n    }\n    // Fallback to __ prefixed version for non-Next.js environments\n    if (process.env.__FF_ICONS__) {\n      try {\n        return JSON.parse(process.env.__FF_ICONS__);\n      } catch (e) {\n        console.warn('[FrontFriend] Failed to parse __FF_ICONS__ from environment');\n      }\n    }\n  }\n  // Try window global\n  if (isBrowser && window.__FF_ICONS__) {\n    return window.__FF_ICONS__;\n  }\n  return null;\n}\n\n/**\n * Main config export with lazy loading and memoization\n *\n * This proxy:\n * - Lazily loads config from multiple sources (globals, env vars, window)\n * - Returns actual config values when available\n * - Falls back to deep proxy for missing properties\n * - Maintains referential equality for the same property access\n * - Supports 'in' operator and iteration\n *\n * @example\n * import { config } from '@frontfriend/tailwind';\n * const sidebarConfig = config.sidebar; // Loads config lazily\n * config.sidebar === config.sidebar; // true (memoized)\n */\nexport const config = new Proxy({}, {\n  // Cache for memoized deep proxies\n  _proxyCache: new Map(),\n\n  get(target, prop) {\n    // Handle special cases for console.log, JSON.stringify, etc.\n    if (prop === Symbol.toPrimitive || prop === 'valueOf') {\n      return () => '';\n    }\n    if (prop === 'toString' || prop === Symbol.toStringTag) {\n      return () => '[object Object]';\n    }\n    if (prop === 'constructor') {\n      return Object;\n    }\n\n    // Try to get config if not already loaded\n    if (!_config) {\n      _config = getConfig();\n    }\n\n    // Return actual config value if it exists\n    if (_config && prop in _config) {\n      return _config[prop];\n    }\n\n    // Return memoized deep proxy for missing properties\n    // This ensures config.missing === config.missing (referential equality)\n    if (!this._proxyCache.has(prop)) {\n      this._proxyCache.set(prop, createDeepProxy());\n    }\n    return this._proxyCache.get(prop);\n  },\n\n  /**\n   * Handles 'in' operator\n   * Returns true if property exists in loaded config, or true for any property\n   * to prevent crashes during property checks\n   */\n  has(target, prop) {\n    // Try to load config first\n    if (!_config) {\n      _config = getConfig();\n    }\n\n    // If config is loaded, check if property exists\n    if (_config) {\n      return prop in _config;\n    }\n\n    // If config not loaded, return true to allow safe access\n    return true;\n  },\n\n  /**\n   * Handles Object.keys(), Object.getOwnPropertyNames()\n   * Returns actual config keys if loaded, empty array otherwise\n   */\n  ownKeys(target) {\n    if (!_config) {\n      _config = getConfig();\n    }\n\n    return _config ? Object.keys(_config) : [];\n  },\n\n  /**\n   * Handles Object.getOwnPropertyDescriptor()\n   * Required for proper iteration support\n   */\n  getOwnPropertyDescriptor(target, prop) {\n    if (!_config) {\n      _config = getConfig();\n    }\n\n    if (_config && prop in _config) {\n      return Object.getOwnPropertyDescriptor(_config, prop);\n    }\n\n    return {\n      enumerable: true,\n      configurable: true,\n    };\n  },\n});\n\n/**\n * Icon set export with lazy loading\n *\n * This proxy:\n * - Lazily loads icons from multiple sources (globals, env vars, window)\n * - Returns actual icon values when available\n * - Returns null for missing icons (allowing graceful fallbacks)\n * - Supports 'in' operator to check icon availability\n *\n * @example\n * import { iconSet } from '@frontfriend/tailwind';\n * const closeIcon = iconSet.sidebar?.close; // Safely access with optional chaining\n * if ('close' in iconSet.sidebar) { ... } // Check if icon exists\n */\nexport const iconSet = new Proxy({}, {\n  get(target, prop) {\n    // Handle special cases for type coercion\n    if (prop === Symbol.toPrimitive || prop === 'valueOf') {\n      return () => '';\n    }\n    if (prop === 'toString' || prop === Symbol.toStringTag) {\n      return () => '[object Object]';\n    }\n    if (prop === 'constructor') {\n      return Object;\n    }\n\n    // Try to get icons if not already loaded\n    if (!_iconSet) {\n      _iconSet = getIcons();\n    }\n\n    // Return actual icon value if it exists\n    if (_iconSet && prop in _iconSet) {\n      return _iconSet[prop];\n    }\n\n    // Return null for missing icons (allows graceful fallbacks)\n    return null;\n  },\n\n  /**\n   * Handles 'in' operator for icon existence checks\n   */\n  has(target, prop) {\n    if (!_iconSet) {\n      _iconSet = getIcons();\n    }\n\n    return _iconSet ? prop in _iconSet : false;\n  },\n\n  /**\n   * Handles Object.keys() for iconSet\n   */\n  ownKeys(target) {\n    if (!_iconSet) {\n      _iconSet = getIcons();\n    }\n\n    return _iconSet ? Object.keys(_iconSet) : [];\n  },\n\n  /**\n   * Handles Object.getOwnPropertyDescriptor() for iconSet\n   */\n  getOwnPropertyDescriptor(target, prop) {\n    if (!_iconSet) {\n      _iconSet = getIcons();\n    }\n\n    if (_iconSet && prop in _iconSet) {\n      return Object.getOwnPropertyDescriptor(_iconSet, prop);\n    }\n\n    return undefined;\n  },\n});\n\n// Default export\nexport default plugin;"],
-  "mappings": "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",
-  "names": ["isBrowser", "isNode", "plugin", "createDeepProxy", "cache", "handler", "target", "prop", "ffdc", "config", "_config", "_iconSet", "getConfig", "getIcons", "iconSet", "frontfriend_tailwind_default"]
+  "sourcesContent": ["// ES Module wrapper for frontfriend-tailwind\n// This file provides ES module exports for both Node.js and browser environments\n\n// Determine environment\nconst isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';\nconst isNode = typeof process !== 'undefined' && process.versions && process.versions.node;\n\n// Lazy-loaded CJS module reference\nlet cjsModule = null;\nlet cjsModulePromise = null;\n\n// Lazy loader for CJS module (only loads when needed)\nasync function loadCjsModule() {\n  if (cjsModule) return cjsModule;\n  if (cjsModulePromise) return cjsModulePromise;\n\n  cjsModulePromise = (async () => {\n    try {\n      const { createRequire } = await import('module');\n      const require = createRequire(import.meta.url);\n      cjsModule = require('./index.js');\n      return cjsModule;\n    } catch (error) {\n      console.error('[FrontFriend] Failed to load CommonJS module:', error);\n      throw error;\n    }\n  })();\n\n  return cjsModulePromise;\n}\n\n// Create plugin function that loads CJS module on demand\nconst plugin = isNode\n  ? function(...args) {\n      // Synchronous require - this works because Node.js supports it\n      if (!cjsModule) {\n        try {\n          // Use dynamic require - only available in Node.js\n          const module = require('module');\n          const req = module.createRequire(import.meta.url);\n          cjsModule = req('./index.js');\n        } catch (error) {\n          console.error('[FrontFriend] Failed to load plugin:', error);\n          return {};\n        }\n      }\n      return typeof cjsModule === 'function' ? cjsModule(...args) : cjsModule;\n    }\n  : function() {\n      // Browser: Use stub function\n      if (isBrowser) {\n        console.warn('[FrontFriend] The Tailwind plugin cannot be used directly in browser environments');\n      }\n      return {};\n    };\n\n/**\n * Creates a deep proxy that gracefully handles arbitrary nested property access\n * without throwing errors. This is essential for SSR and build-time scenarios\n * where configuration might not be loaded yet.\n *\n * Features:\n * - Infinite depth access: config.a.b.c.d.e never crashes\n * - Referential equality: config.a === config.a (memoized)\n * - Iteration support: Object.keys(), spread operator, for...in\n * - Type coercion: Works with toString, valueOf, Symbol.toPrimitive\n * - 'in' operator: 'property' in config returns true\n *\n * @returns {Proxy} A proxy object that handles any property access safely\n *\n * @example\n * const config = createDeepProxy();\n * const value = config.sidebar.root.wrapper.base; // Never crashes\n * config.a === config.a; // true (referential equality)\n * 'anything' in config; // true\n * Object.keys(config); // []\n */\nfunction createDeepProxy() {\n  // Cache for memoization - ensures referential equality\n  // This is critical for React dependency arrays and equality checks\n  const cache = new Map();\n\n  const handler = {\n    /**\n     * Handles property access with memoization\n     * Ensures config.a === config.a for referential equality\n     */\n    get(target, prop) {\n      // Handle special cases for type coercion and inspection\n      if (prop === Symbol.toPrimitive || prop === 'valueOf') {\n        return () => '';\n      }\n      if (prop === 'toString' || prop === Symbol.toStringTag) {\n        return () => '';\n      }\n      if (prop === 'constructor') {\n        return Object;\n      }\n\n      // Return cached proxy for same property to maintain referential equality\n      // This prevents issues with React hooks and memoization\n      if (!cache.has(prop)) {\n        cache.set(prop, createDeepProxy());\n      }\n      return cache.get(prop);\n    },\n\n    /**\n     * Handles 'in' operator\n     * Makes 'property' in config return true for any property\n     */\n    has(target, prop) {\n      // Return true for all properties except internal symbols\n      if (typeof prop === 'symbol' && prop.toString().includes('nodejs.util.inspect')) {\n        return false;\n      }\n      return true;\n    },\n\n    /**\n     * Handles Object.keys(), Object.getOwnPropertyNames(), for...in\n     * Returns empty array since proxy represents missing/unknown config\n     */\n    ownKeys(target) {\n      return [];\n    },\n\n    /**\n     * Handles Object.getOwnPropertyDescriptor()\n     * Required for proper iteration support with ownKeys\n     */\n    getOwnPropertyDescriptor(target, prop) {\n      return {\n        enumerable: true,\n        configurable: true,\n      };\n    },\n  };\n\n  return new Proxy({}, handler);\n}\n\n/**\n * FrontFriend Design Config (ffdc) - Safe config wrapper with SSR support\n *\n * Wraps configuration objects to prevent crashes during SSR or when config\n * is not yet loaded. Returns actual config if valid, or a deep proxy fallback.\n *\n * This is the recommended way to access config in components to ensure\n * they work during both build-time (SSR) and runtime.\n *\n * @param {Object|null|undefined} config - The configuration object to wrap\n * @returns {Object|Proxy} The config object or a safe deep proxy\n *\n * @example\n * import { config, ffdc } from '@frontfriend/tailwind';\n *\n * // Safe access during SSR - never crashes\n * const sidebarConfig = ffdc(config || {}).sidebar;\n * const className = sidebarConfig.root.wrapper.base; // Always safe\n *\n * @example\n * // In a React component\n * function Sidebar() {\n *   const cfg = ffdc(config).sidebar;\n *   return <div className={cfg.root.base}>...</div>;\n * }\n */\nexport function ffdc(config) {\n  // During SSR or initial load, config might not be available yet\n  // Return a deep proxy that handles any property access without crashing\n  if (!config || typeof config !== 'object') {\n    return createDeepProxy();\n  }\n\n  return config;\n}\n\n// Export config and iconSet with lazy getters\n// In Node.js, load CJS module on first access\n// In browser, use proxies with global variable fallbacks\nexport const config = new Proxy({}, {\n      // Cache for the loaded CJS module config\n      _cjsConfig: null,\n      // Cache for memoized deep proxies\n      _proxyCache: new Map(),\n\n      get(target, prop) {\n        // Handle special cases for console.log, JSON.stringify, etc.\n        if (prop === Symbol.toPrimitive || prop === 'valueOf') {\n          return () => '';\n        }\n        if (prop === 'toString' || prop === Symbol.toStringTag) {\n          return () => '[object Object]';\n        }\n        if (prop === 'constructor') {\n          return Object;\n        }\n\n        // In Node.js, try to get config from CJS module first\n        if (isNode && !this._cjsConfig && cjsModule) {\n          this._cjsConfig = cjsModule.config;\n        }\n\n        if (isNode && this._cjsConfig && prop in this._cjsConfig) {\n          return this._cjsConfig[prop];\n        }\n\n        // Try to get config from globals\n        let _config = null;\n        if (typeof __FF_CONFIG__ !== 'undefined') {\n          _config = __FF_CONFIG__;\n        } else if (typeof process !== 'undefined' && process.env) {\n          if (process.env.NEXT_PUBLIC_FF_CONFIG) {\n            try {\n              _config = JSON.parse(process.env.NEXT_PUBLIC_FF_CONFIG);\n            } catch (e) {\n              console.warn('[FrontFriend] Failed to parse NEXT_PUBLIC_FF_CONFIG');\n            }\n          } else if (process.env.__FF_CONFIG__) {\n            try {\n              _config = JSON.parse(process.env.__FF_CONFIG__);\n            } catch (e) {\n              console.warn('[FrontFriend] Failed to parse __FF_CONFIG__');\n            }\n          }\n        } else if (isBrowser && window.__FF_CONFIG__) {\n          _config = window.__FF_CONFIG__;\n        }\n\n        // Return actual config value if it exists\n        if (_config && prop in _config) {\n          return _config[prop];\n        }\n\n        // Return memoized deep proxy for missing properties\n        if (!this._proxyCache.has(prop)) {\n          this._proxyCache.set(prop, createDeepProxy());\n        }\n        return this._proxyCache.get(prop);\n      },\n\n      has(target, prop) {\n        return true;\n      },\n\n      ownKeys(target) {\n        return [];\n      },\n\n      getOwnPropertyDescriptor(target, prop) {\n        return {\n          enumerable: true,\n          configurable: true,\n        };\n      },\n    });\n\nexport const iconSet = new Proxy({}, {\n      // Cache for the loaded CJS module iconSet\n      _cjsIconSet: null,\n\n      get(target, prop) {\n        if (prop === Symbol.toPrimitive || prop === 'valueOf') {\n          return () => '';\n        }\n        if (prop === 'toString' || prop === Symbol.toStringTag) {\n          return () => '[object Object]';\n        }\n        if (prop === 'constructor') {\n          return Object;\n        }\n\n        // In Node.js, try to get iconSet from CJS module first\n        if (isNode && !this._cjsIconSet && cjsModule) {\n          this._cjsIconSet = cjsModule.iconSet;\n        }\n\n        if (isNode && this._cjsIconSet && prop in this._cjsIconSet) {\n          return this._cjsIconSet[prop];\n        }\n\n        // Try to get icons from globals\n        let _iconSet = null;\n        if (typeof __FF_ICONS__ !== 'undefined') {\n          _iconSet = __FF_ICONS__;\n        } else if (typeof process !== 'undefined' && process.env) {\n          if (process.env.NEXT_PUBLIC_FF_ICONS) {\n            try {\n              _iconSet = JSON.parse(process.env.NEXT_PUBLIC_FF_ICONS);\n            } catch (e) {\n              console.warn('[FrontFriend] Failed to parse NEXT_PUBLIC_FF_ICONS');\n            }\n          } else if (process.env.__FF_ICONS__) {\n            try {\n              _iconSet = JSON.parse(process.env.__FF_ICONS__);\n            } catch (e) {\n              console.warn('[FrontFriend] Failed to parse __FF_ICONS__');\n            }\n          }\n        } else if (isBrowser && window.__FF_ICONS__) {\n          _iconSet = window.__FF_ICONS__;\n        }\n\n        if (_iconSet && prop in _iconSet) {\n          return _iconSet[prop];\n        }\n\n        return null;\n      },\n\n      has(target, prop) {\n        return false;\n      },\n\n      ownKeys(target) {\n        return [];\n      },\n\n      getOwnPropertyDescriptor(target, prop) {\n        return undefined;\n      },\n    });\n\n// Default export is the plugin\nexport default plugin;\n"],
+  "mappings": "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",
+  "names": ["isBrowser", "isNode", "cjsModule", "plugin", "isNode", "args", "cjsModule", "error", "isBrowser", "createDeepProxy", "cache", "handler", "target", "prop", "ffdc", "config", "_config", "iconSet", "_iconSet", "frontfriend_tailwind_default"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontfriend/tailwind",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "Design token management for Tailwind CSS",
   "main": "./dist/index.js",
   "types": "./dist/types/index.d.ts",

package/scripts/build.js

@@ -330,12 +330,14 @@ async function build() {
     sourcemap: true,
     format: 'esm',
     platform: 'node',
-    target: 'node14',
+    target: 'node16', // Node 16+ for top-level await support
     outfile: path.join(distDir, 'index.mjs'),
     external: [
       'tailwindcss',
       './lib/core/cache-manager.js',
       './ffdc.js',
+      './index.js',
+      'module',
       'fs',
       'path'
     ],