@tenphi/tasty 0.0.0-snapshot.c8bdaeb → 0.0.0-snapshot.cae4fee

package/dist/static/index.d.ts

@@ -1,5 +1,91 @@
-import { Styles } from "../styles/types.js";
-import { mergeStyles } from "../utils/merge-styles.js";
-import { StaticStyle, createStaticStyle, isStaticStyle } from "./types.js";
-import { tastyStatic } from "./tastyStatic.js";
-export { type StaticStyle, type Styles, createStaticStyle, isStaticStyle, mergeStyles, tastyStatic };
+import { b as Styles } from "../index-tcHuMPFt.js";
+import { t as mergeStyles } from "../merge-styles-BMWcH6MF.js";
+
+//#region src/static/types.d.ts
+/**
+ * Static style definition returned by tastyStatic().
+ *
+ * Supports both explicit className access and implicit string coercion via toString().
+ *
+ * @example
+ * ```typescript
+ * const button = tastyStatic({ fill: '#blue' });
+ *
+ * // Both work in JSX:
+ * <div className={button} />           // Uses toString()
+ * <div className={button.className} /> // Explicit
+ *
+ * // Extension:
+ * const primary = tastyStatic(button, { fill: '#purple' });
+ * ```
+ */
+interface StaticStyle {
+  /**
+   * Generated className(s) for use in JSX.
+   * May contain multiple space-separated class names due to chunking.
+   */
+  className: string;
+  /**
+   * The original (or merged) styles object.
+   * Available for extension via tastyStatic(base, overrides).
+   */
+  styles: Styles;
+  /**
+   * Returns className for implicit string coercion.
+   * Enables `<div className={button} />` syntax.
+   */
+  toString(): string;
+}
+/**
+ * Create a StaticStyle object.
+ * Used internally by the Babel plugin to generate output.
+ */
+declare function createStaticStyle(className: string, styles: Styles): StaticStyle;
+/**
+ * Type guard to check if a value is a StaticStyle object.
+ */
+declare function isStaticStyle(value: unknown): value is StaticStyle;
+//#endregion
+//#region src/static/tastyStatic.d.ts
+/**
+ * Generate styles and return a StaticStyle object.
+ * The object has `className`, `styles`, and `toString()`.
+ *
+ * @example
+ * ```typescript
+ * const button = tastyStatic({
+ *   fill: '#blue',
+ *   padding: '2x',
+ * });
+ * // After build: { className: 'ts3f2a1b', styles: {...}, toString() }
+ *
+ * <div className={button} />  // Works via toString()
+ * ```
+ */
+declare function tastyStatic(styles: Styles): StaticStyle;
+/**
+ * Extend an existing StaticStyle with additional styles.
+ * Uses mergeStyles() internally for proper nested selector handling.
+ *
+ * @example
+ * ```typescript
+ * const button = tastyStatic({ fill: '#blue' });
+ * const primary = tastyStatic(button, { fill: '#purple' });
+ * // After build: { className: 'ts8c4d2e', styles: {...merged...}, toString() }
+ * ```
+ */
+declare function tastyStatic(base: StaticStyle, styles: Styles): StaticStyle;
+/**
+ * Generate styles for a specific CSS selector.
+ * The call is completely removed after build transformation.
+ *
+ * @example
+ * ```typescript
+ * tastyStatic('.heading', { preset: 'h1', color: '#primary' });
+ * // After build: (removed)
+ * ```
+ */
+declare function tastyStatic(selector: string, styles: Styles): void;
+//#endregion
+export { type StaticStyle, type Styles, createStaticStyle, isStaticStyle, mergeStyles, tastyStatic };
+//# sourceMappingURL=index.d.ts.map

package/dist/static/index.js

@@ -1,5 +1,50 @@
-import { mergeStyles } from "../utils/merge-styles.js";
-import { createStaticStyle, isStaticStyle } from "./types.js";
-import { tastyStatic } from "./tastyStatic.js";
+import { t as mergeStyles } from "../merge-styles-Cd2vBl9b.js";
+//#region src/static/types.ts
+/**
+* Create a StaticStyle object.
+* Used internally by the Babel plugin to generate output.
+*/
+function createStaticStyle(className, styles) {
+	return {
+		className,
+		styles,
+		toString() {
+			return this.className;
+		}
+	};
+}
+/**
+* Type guard to check if a value is a StaticStyle object.
+*/
+function isStaticStyle(value) {
+	return typeof value === "object" && value !== null && "className" in value && "styles" in value && "toString" in value && typeof value.className === "string" && typeof value.styles === "object";
+}
+//#endregion
+//#region src/static/tastyStatic.ts
+/**
+* Build-time only function for zero-runtime static site generation.
+*
+* This function is transformed by the Babel plugin:
+* - `tastyStatic(styles)` → StaticStyle object with className
+* - `tastyStatic(base, styles)` → StaticStyle object with merged styles
+* - `tastyStatic(selector, styles)` → removed entirely
+*
+* At runtime (during development/build), this function returns a placeholder.
+* In production, all calls are replaced/removed by the build plugin.
+*/
+function tastyStatic(stylesOrBaseOrSelector, styles) {
+	if (typeof stylesOrBaseOrSelector === "string") {
+		console.warn(`[tasty] tastyStatic('${stylesOrBaseOrSelector}', styles) was called at runtime. This indicates the Babel plugin is not configured. Add @tenphi/tasty/babel-plugin to your Babel config.`);
+		return;
+	}
+	if (isStaticStyle(stylesOrBaseOrSelector)) {
+		console.warn("[tasty] tastyStatic(base, styles) was called at runtime. This indicates the Babel plugin is not configured. Add @tenphi/tasty/babel-plugin to your Babel config.");
+		return createStaticStyle("__TASTY_STATIC_NOT_TRANSFORMED__", mergeStyles(stylesOrBaseOrSelector.styles, styles || {}));
+	}
+	console.warn("[tasty] tastyStatic(styles) was called at runtime. This indicates the Babel plugin is not configured. Add @tenphi/tasty/babel-plugin to your Babel config.");
+	return createStaticStyle("__TASTY_STATIC_NOT_TRANSFORMED__", stylesOrBaseOrSelector);
+}
+//#endregion
+export { createStaticStyle, isStaticStyle, mergeStyles, tastyStatic };
 
-export { createStaticStyle, isStaticStyle, mergeStyles, tastyStatic };
+//# sourceMappingURL=index.js.map

package/dist/static/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/static/types.ts","../../src/static/tastyStatic.ts"],"sourcesContent":["import type { Styles } from '../styles/types';\n\n/**\n * Static style definition returned by tastyStatic().\n *\n * Supports both explicit className access and implicit string coercion via toString().\n *\n * @example\n * ```typescript\n * const button = tastyStatic({ fill: '#blue' });\n *\n * // Both work in JSX:\n * <div className={button} />           // Uses toString()\n * <div className={button.className} /> // Explicit\n *\n * // Extension:\n * const primary = tastyStatic(button, { fill: '#purple' });\n * ```\n */\nexport interface StaticStyle {\n  /**\n   * Generated className(s) for use in JSX.\n   * May contain multiple space-separated class names due to chunking.\n   */\n  className: string;\n\n  /**\n   * The original (or merged) styles object.\n   * Available for extension via tastyStatic(base, overrides).\n   */\n  styles: Styles;\n\n  /**\n   * Returns className for implicit string coercion.\n   * Enables `<div className={button} />` syntax.\n   */\n  toString(): string;\n}\n\n/**\n * Create a StaticStyle object.\n * Used internally by the Babel plugin to generate output.\n */\nexport function createStaticStyle(\n  className: string,\n  styles: Styles,\n): StaticStyle {\n  return {\n    className,\n    styles,\n    toString() {\n      return this.className;\n    },\n  };\n}\n\n/**\n * Type guard to check if a value is a StaticStyle object.\n */\nexport function isStaticStyle(value: unknown): value is StaticStyle {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'className' in value &&\n    'styles' in value &&\n    'toString' in value &&\n    typeof (value as StaticStyle).className === 'string' &&\n    typeof (value as StaticStyle).styles === 'object'\n  );\n}\n","import type { Styles } from '../styles/types';\nimport { mergeStyles } from '../utils/merge-styles';\n\nimport type { StaticStyle } from './types';\nimport { createStaticStyle, isStaticStyle } from './types';\n\n/**\n * Generate styles and return a StaticStyle object.\n * The object has `className`, `styles`, and `toString()`.\n *\n * @example\n * ```typescript\n * const button = tastyStatic({\n *   fill: '#blue',\n *   padding: '2x',\n * });\n * // After build: { className: 'ts3f2a1b', styles: {...}, toString() }\n *\n * <div className={button} />  // Works via toString()\n * ```\n */\nexport function tastyStatic(styles: Styles): StaticStyle;\n\n/**\n * Extend an existing StaticStyle with additional styles.\n * Uses mergeStyles() internally for proper nested selector handling.\n *\n * @example\n * ```typescript\n * const button = tastyStatic({ fill: '#blue' });\n * const primary = tastyStatic(button, { fill: '#purple' });\n * // After build: { className: 'ts8c4d2e', styles: {...merged...}, toString() }\n * ```\n */\nexport function tastyStatic(base: StaticStyle, styles: Styles): StaticStyle;\n\n/**\n * Generate styles for a specific CSS selector.\n * The call is completely removed after build transformation.\n *\n * @example\n * ```typescript\n * tastyStatic('.heading', { preset: 'h1', color: '#primary' });\n * // After build: (removed)\n * ```\n */\nexport function tastyStatic(selector: string, styles: Styles): void;\n\n/**\n * Build-time only function for zero-runtime static site generation.\n *\n * This function is transformed by the Babel plugin:\n * - `tastyStatic(styles)` → StaticStyle object with className\n * - `tastyStatic(base, styles)` → StaticStyle object with merged styles\n * - `tastyStatic(selector, styles)` → removed entirely\n *\n * At runtime (during development/build), this function returns a placeholder.\n * In production, all calls are replaced/removed by the build plugin.\n */\nexport function tastyStatic(\n  stylesOrBaseOrSelector: Styles | StaticStyle | string,\n  styles?: Styles,\n): StaticStyle | void {\n  // This code only executes if the Babel plugin hasn't processed the file yet.\n  // In a properly configured build, this function is never called at runtime.\n\n  if (typeof stylesOrBaseOrSelector === 'string') {\n    // Selector mode: tastyStatic(selector, styles)\n    // The plugin will remove this call entirely\n    if (process.env.NODE_ENV !== 'production') {\n      console.warn(\n        `[tasty] tastyStatic('${stylesOrBaseOrSelector}', styles) was called at runtime. ` +\n          'This indicates the Babel plugin is not configured. ' +\n          'Add @tenphi/tasty/babel-plugin to your Babel config.',\n      );\n    }\n    return; // void\n  }\n\n  if (isStaticStyle(stylesOrBaseOrSelector)) {\n    // Extension mode: tastyStatic(base, styles)\n    if (process.env.NODE_ENV !== 'production') {\n      console.warn(\n        '[tasty] tastyStatic(base, styles) was called at runtime. ' +\n          'This indicates the Babel plugin is not configured. ' +\n          'Add @tenphi/tasty/babel-plugin to your Babel config.',\n      );\n    }\n    // Merge styles for dev mode preview (won't have real classNames)\n    const mergedStyles = mergeStyles(\n      stylesOrBaseOrSelector.styles,\n      styles || {},\n    );\n    return createStaticStyle('__TASTY_STATIC_NOT_TRANSFORMED__', mergedStyles);\n  }\n\n  // Styles mode: tastyStatic(styles)\n  if (process.env.NODE_ENV !== 'production') {\n    console.warn(\n      '[tasty] tastyStatic(styles) was called at runtime. ' +\n        'This indicates the Babel plugin is not configured. ' +\n        'Add @tenphi/tasty/babel-plugin to your Babel config.',\n    );\n  }\n\n  // Return placeholder - styles won't be applied without the plugin\n  return createStaticStyle(\n    '__TASTY_STATIC_NOT_TRANSFORMED__',\n    stylesOrBaseOrSelector,\n  );\n}\n"],"mappings":";;;;;;AA2CA,SAAgB,kBACd,WACA,QACa;CACb,OAAO;EACL;EACA;EACA,WAAW;GACT,OAAO,KAAK;;EAEf;;;;;AAMH,SAAgB,cAAc,OAAsC;CAClE,OACE,OAAO,UAAU,YACjB,UAAU,QACV,eAAe,SACf,YAAY,SACZ,cAAc,SACd,OAAQ,MAAsB,cAAc,YAC5C,OAAQ,MAAsB,WAAW;;;;;;;;;;;;;;;ACR7C,SAAgB,YACd,wBACA,QACoB;CAIpB,IAAI,OAAO,2BAA2B,UAAU;EAI5C,QAAQ,KACN,wBAAwB,uBAAuB,2IAGhD;EAEH;;CAGF,IAAI,cAAc,uBAAuB,EAAE;EAGvC,QAAQ,KACN,mKAGD;EAOH,OAAO,kBAAkB,oCAJJ,YACnB,uBAAuB,QACvB,UAAU,EAAE,CAE2D,CAAC;;CAK1E,QAAQ,KACN,6JAGD;CAIH,OAAO,kBACL,oCACA,uBACD"}

package/dist/static/inject.d.ts

@@ -0,0 +1,5 @@
+//#region src/static/inject.d.ts
+declare function injectCSS(id: string, css: string): void;
+//#endregion
+export { injectCSS };
+//# sourceMappingURL=inject.d.ts.map

package/dist/static/inject.js

@@ -0,0 +1,17 @@
+//#region src/static/inject.ts
+const _ids = /* @__PURE__ */ new Set();
+function injectCSS(id, css) {
+	if (_ids.has(id) || typeof document === "undefined") return;
+	_ids.add(id);
+	let el = document.head.querySelector("style[data-tasty-static]");
+	if (!el) {
+		el = document.createElement("style");
+		el.setAttribute("data-tasty-static", "");
+		document.head.appendChild(el);
+	}
+	el.appendChild(document.createTextNode(css + "\n"));
+}
+//#endregion
+export { injectCSS };
+
+//# sourceMappingURL=inject.js.map

package/dist/static/inject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.js","names":[],"sources":["../../src/static/inject.ts"],"sourcesContent":["const _ids = new Set<string>();\n\nexport function injectCSS(id: string, css: string): void {\n  if (_ids.has(id) || typeof document === 'undefined') return;\n  _ids.add(id);\n  let el = document.head.querySelector(\n    'style[data-tasty-static]',\n  ) as HTMLStyleElement | null;\n  if (!el) {\n    el = document.createElement('style');\n    el.setAttribute('data-tasty-static', '');\n    document.head.appendChild(el);\n  }\n  el.appendChild(document.createTextNode(css + '\\n'));\n}\n"],"mappings":";AAAA,MAAM,uBAAO,IAAI,KAAa;AAE9B,SAAgB,UAAU,IAAY,KAAmB;CACvD,IAAI,KAAK,IAAI,GAAG,IAAI,OAAO,aAAa,aAAa;CACrD,KAAK,IAAI,GAAG;CACZ,IAAI,KAAK,SAAS,KAAK,cACrB,2BACD;CACD,IAAI,CAAC,IAAI;EACP,KAAK,SAAS,cAAc,QAAQ;EACpC,GAAG,aAAa,qBAAqB,GAAG;EACxC,SAAS,KAAK,YAAY,GAAG;;CAE/B,GAAG,YAAY,SAAS,eAAe,MAAM,KAAK,CAAC"}

package/dist/zero/babel.d.ts

@@ -1,108 +1,81 @@
-import { KeyframesSteps } from "../injector/types.js";
-import { StyleDetails, UnitHandler } from "../parser/types.js";
-import { StyleHandlerDefinition } from "../utils/styles.js";
-import { RecipeStyles } from "../styles/types.js";
-import { TastyPlugin } from "../plugins/types.js";
-import * as _babel_core0 from "@babel/core";
+import { t as TastyConfig } from "../config-BoZDUHW5.js";
+import * as _$_babel_core0 from "@babel/core";
 import { PluginPass } from "@babel/core";
 
 //#region src/zero/babel.d.ts
 /**
  * Build-time configuration for zero-runtime mode.
- * Subset of TastyConfig that applies at build time.
+ * Subset of TastyConfig excluding runtime-only DOM options
+ * (`nonce`, `maxRulesPerSheet`, `forceTextInjection`, `gc`)
+ * and overriding `devMode` default to `false`.
  */
-interface TastyZeroConfig {
-  /**
-   * Global predefined states for advanced state mapping.
-   * Example: { '@mobile': '@media(w < 768px)', '@dark': '@root(theme=dark)' }
-   */
-  states?: Record<string, string>;
+type TastyZeroConfig = Omit<TastyConfig, 'nonce' | 'maxRulesPerSheet' | 'forceTextInjection' | 'gc' | 'devMode'> & {
   /**
    * Enable development mode features: source comments in generated CSS.
-   * Default: false
+   * @default false
    */
   devMode?: boolean;
+};
+interface TastyZeroBabelOptions {
+  /** Output path for generated CSS (default: 'tasty.css') */
+  output?: string;
   /**
-   * Parser LRU cache size (default: 1000).
-   * Larger values improve performance for builds with many unique style values.
-   */
-  parserCacheSize?: number;
-  /**
-   * Custom units for the style parser (merged with built-in units).
-   * Units transform numeric values like `2x` → `calc(2 * var(--gap))`.
-   * @example { em: 'em', vw: 'vw', custom: (n) => `${n * 10}px` }
-   */
-  units?: Record<string, string | UnitHandler>;
-  /**
-   * Custom functions for the style parser (merged with existing).
-   * Functions process parsed style groups and return CSS values.
-   * @example { myFunc: (groups) => groups.map(g => g.output).join(' ') }
+   * Tasty configuration for build-time processing.
+   * Can be a static object or a factory function that returns fresh config.
+   * A factory is called on each plugin invocation, enabling hot reload
+   * of config values that depend on external files (e.g. theme tokens).
    */
-  funcs?: Record<string, (groups: StyleDetails[]) => string>;
+  config?: TastyZeroConfig | (() => TastyZeroConfig);
   /**
-   * Plugins that extend tasty with custom functions, units, states, handlers, or tokens.
-   * Plugins are processed in order, with later plugins overriding earlier ones.
-   * @example
-   * ```ts
-   * import { okhslPlugin } from '@tenphi/tasty';
+   * Absolute path to a TypeScript/JavaScript module that default-exports
+   * a `TastyZeroConfig` object. The module is loaded via jiti on each
+   * plugin invocation, enabling hot reload when the file changes.
    *
-   * // babel.config.js
-   * module.exports = {
-   *   plugins: [
-   *     ['@tenphi/tasty/babel-plugin', {
-   *       config: { plugins: [okhslPlugin()] }
-   *     }]
-   *   ]
-   * };
-   * ```
-   */
-  plugins?: TastyPlugin[];
-  /**
-   * Global keyframes definitions for static extraction.
-   * Keys are animation names, values are keyframes step definitions.
-   * @example { fadeIn: { from: { opacity: 0 }, to: { opacity: 1 } } }
+   * This option is JSON-serializable and is the primary way Turbopack
+   * passes config to the Babel plugin (since Turbopack loader options
+   * must be plain primitives/objects/arrays).
+   *
+   * When both `config` and `configFile` are set, `config` takes precedence.
+   *
+   * @example '/absolute/path/to/tasty-zero.config.ts'
    */
-  keyframes?: Record<string, KeyframesSteps>;
+  configFile?: string;
   /**
-   * Custom style handlers that transform style properties into CSS declarations.
-   * Handlers replace built-in handlers for the same style name.
-   * @example
-   * ```ts
-   * handlers: {
-   *   fill: ({ fill }) => fill ? { 'background-color': fill } : undefined,
-   *   elevation: ({ elevation }) => ({
-   *     'box-shadow': `0 ${elevation}px ${elevation * 2}px rgba(0,0,0,0.1)`,
-   *   }),
-   * }
-   * ```
+   * Absolute file paths whose content affects the generated CSS.
+   * When any of these files change, babel-loader invalidates its cache
+   * and re-runs the plugin with fresh config values.
+   *
+   * Typically includes theme files that define Glaze palettes or token values.
+   * Paths must be absolute (resolved by the Next.js wrapper).
    */
-  handlers?: Record<string, StyleHandlerDefinition>;
+  configDeps?: string[];
   /**
-   * Predefined tokens that are replaced during style parsing.
-   * Use `$name` for custom properties and `#name` for color tokens.
-   * @example { $spacing: '2x', '#accent': '#purple' }
+   * Automatically replace `@tenphi/tasty/static` imports with an import
+   * of the generated CSS file. This eliminates the need for users to
+   * manually import the CSS in their app entry point.
+   *
+   * @default true
    */
-  tokens?: Record<`$${string}` | `#${string}`, string | number>;
+  injectImport?: boolean;
   /**
-   * Predefined style recipes -- named style bundles that can be applied via `recipe` style property.
-   * Recipe values are flat tasty styles (no sub-element keys).
-   * @example
-   * ```ts
-   * recipes: {
-   *   card: { padding: '4x', fill: '#surface', radius: '1r', border: true },
-   *   elevated: { shadow: '2x 2x 4x #shadow' },
-   * }
-   * ```
+   * Output mode for extracted CSS.
+   *
+   * - `'file'` (default): CSS is written to a single output file and
+   *   the `@tenphi/tasty/static` import is rewritten to import that file.
+   * - `'inject'`: CSS is embedded inline in the JS output and injected
+   *   at runtime via a tiny injector from `@tenphi/tasty/static/inject`.
+   *   No CSS file is written. Each `tastyStatic` call becomes
+   *   self-contained. Best for reusable components and extensions.
+   *
+   * When `mode` is `'inject'`, `output` and `injectImport` are ignored.
+   *
+   * @default 'file'
    */
-  recipes?: Record<string, RecipeStyles>;
-}
-interface TastyZeroBabelOptions {
-  /** Output path for generated CSS (default: 'tasty.css') */
-  output?: string;
-  /** Tasty configuration for build-time processing */
-  config?: TastyZeroConfig;
+  mode?: 'file' | 'inject';
 }
-declare const _default: (api: object, options: TastyZeroBabelOptions | null | undefined, dirname: string) => _babel_core0.PluginObj<PluginPass>;
+/** Clear the shared CSSWriter cache. Exposed for testing. */
+declare function clearWriterCache(): void;
+declare const _default: (api: object, options: TastyZeroBabelOptions | null | undefined, dirname: string) => _$_babel_core0.PluginObj<PluginPass>;
 //#endregion
-export { TastyZeroBabelOptions, TastyZeroConfig, _default as default };
+export { TastyZeroBabelOptions, TastyZeroConfig, clearWriterCache, _default as default };
 //# sourceMappingURL=babel.d.ts.map