dispersa 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -1,10 +1,10 @@
-import { D as DispersaOptions, B as BuildConfig, a as BuildResult, M as ModifierInputs, R as ResolverDocument } from './index-CePv_bgv.cjs';
-export { A as AndroidRendererOptions, c as BuildError, d as BuildOutput, C as CssRendererOptions, E as ErrorCode, F as FormatOptions, I as IosRendererOptions, L as LifecycleHooks, e as MediaQueryFunction, O as OutputConfig, f as OutputTree, P as PermutationData, h as RenderContext, i as RenderMeta, j as RenderOutput, g as Renderer, S as SelectorFunction, T as TailwindRendererOptions, b as ValidationMode, V as ValidationOptions, k as defineRenderer } from './index-CePv_bgv.cjs';
-import { R as ResolvedTokens } from './types-C1GpiJ6q.cjs';
-export { B as BorderValue, C as ColorToken, d as ColorValueObject, D as DesignTokenValue, b as DimensionToken, e as DimensionValue, c as DurationToken, G as GradientValue, a as ResolvedToken, S as ShadowToken, f as ShadowValueObject, T as TokenType, h as TransitionValue, g as TypographyValue, m as isBorderToken, i as isColorToken, j as isDimensionToken, n as isDurationToken, p as isGradientToken, k as isShadowToken, o as isTransitionToken, l as isTypographyToken } from './types-C1GpiJ6q.cjs';
-export { T as Transform } from './types-DM5faYUn.cjs';
-export { F as Filter } from './types-BDY1xBmD.cjs';
-export { J as JsModuleRendererOptions, a as JsonRendererOptions, P as Preprocessor } from './types-DbufGPrb.cjs';
+import { D as DispersaOptions, B as BuildConfig, a as BuildResult, M as ModifierInputs, R as ResolverDocument } from './index-BkvV7Z54.cjs';
+export { A as AndroidRendererOptions, c as BuildError, d as BuildOutput, C as CssRendererOptions, E as ErrorCode, F as FormatOptions, I as IosRendererOptions, L as LifecycleHooks, e as MediaQueryFunction, O as OutputConfig, f as OutputTree, P as PermutationData, h as RenderContext, i as RenderMeta, j as RenderOutput, g as Renderer, S as SelectorFunction, T as TailwindRendererOptions, b as ValidationMode, V as ValidationOptions, k as defineRenderer } from './index-BkvV7Z54.cjs';
+import { R as ResolvedTokens } from './types-Bc0kA7De.cjs';
+export { B as BorderToken, r as BorderValue, k as ColorComponent, j as ColorSpace, C as ColorToken, i as ColorValue, h as ColorValueObject, o as CubicBezierValue, D as DesignTokenValue, d as DimensionToken, l as DimensionValue, e as DurationToken, m as DurationValue, F as FontFamilyValue, n as FontWeightValue, w as GradientStop, G as GradientToken, v as GradientValue, a as ResolvedToken, S as ShadowToken, p as ShadowValueObject, s as StrokeStyleValue, t as StrokeStyleValueObject, T as TokenType, b as TokenValue, c as TokenValueReference, g as TransitionToken, u as TransitionValue, f as TypographyToken, q as TypographyValue, E as isBorderToken, x as isColorToken, y as isDimensionToken, H as isDurationToken, J as isGradientToken, z as isShadowToken, I as isTransitionToken, A as isTypographyToken } from './types-Bc0kA7De.cjs';
+export { T as Transform } from './types-BAv39mum.cjs';
+export { F as Filter } from './types-DWKq-eJj.cjs';
+export { J as JsModuleRendererOptions, a as JsonRendererOptions, P as Preprocessor } from './types-CussyWwe.cjs';
 export { AndroidBuilderConfig, CssBuilderConfig, IosBuilderConfig, JsBuilderConfig, JsonBuilderConfig, TailwindBuilderConfig, android, css, ios, js, json, tailwind } from './builders.cjs';
 export { isOutputTree, outputTree } from './renderers.cjs';
 export { BasePermutationError, CircularReferenceError, ColorParseError, ConfigurationError, DimensionFormatError, DispersaError, FileOperationError, ModifierError, TokenReferenceError, ValidationError } from './errors.cjs';

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { D as DispersaOptions, B as BuildConfig, a as BuildResult, M as ModifierInputs, R as ResolverDocument } from './index-BP52gB00.js';
-export { A as AndroidRendererOptions, c as BuildError, d as BuildOutput, C as CssRendererOptions, E as ErrorCode, F as FormatOptions, I as IosRendererOptions, L as LifecycleHooks, e as MediaQueryFunction, O as OutputConfig, f as OutputTree, P as PermutationData, h as RenderContext, i as RenderMeta, j as RenderOutput, g as Renderer, S as SelectorFunction, T as TailwindRendererOptions, b as ValidationMode, V as ValidationOptions, k as defineRenderer } from './index-BP52gB00.js';
-import { R as ResolvedTokens } from './types-C1GpiJ6q.js';
-export { B as BorderValue, C as ColorToken, d as ColorValueObject, D as DesignTokenValue, b as DimensionToken, e as DimensionValue, c as DurationToken, G as GradientValue, a as ResolvedToken, S as ShadowToken, f as ShadowValueObject, T as TokenType, h as TransitionValue, g as TypographyValue, m as isBorderToken, i as isColorToken, j as isDimensionToken, n as isDurationToken, p as isGradientToken, k as isShadowToken, o as isTransitionToken, l as isTypographyToken } from './types-C1GpiJ6q.js';
-export { T as Transform } from './types-DdPWYkgh.js';
-export { F as Filter } from './types-Cl-1UYGD.js';
-export { J as JsModuleRendererOptions, a as JsonRendererOptions, P as Preprocessor } from './types-DJH6_4U9.js';
+import { D as DispersaOptions, B as BuildConfig, a as BuildResult, M as ModifierInputs, R as ResolverDocument } from './index-DJ_UHSQG.js';
+export { A as AndroidRendererOptions, c as BuildError, d as BuildOutput, C as CssRendererOptions, E as ErrorCode, F as FormatOptions, I as IosRendererOptions, L as LifecycleHooks, e as MediaQueryFunction, O as OutputConfig, f as OutputTree, P as PermutationData, h as RenderContext, i as RenderMeta, j as RenderOutput, g as Renderer, S as SelectorFunction, T as TailwindRendererOptions, b as ValidationMode, V as ValidationOptions, k as defineRenderer } from './index-DJ_UHSQG.js';
+import { R as ResolvedTokens } from './types-Bc0kA7De.js';
+export { B as BorderToken, r as BorderValue, k as ColorComponent, j as ColorSpace, C as ColorToken, i as ColorValue, h as ColorValueObject, o as CubicBezierValue, D as DesignTokenValue, d as DimensionToken, l as DimensionValue, e as DurationToken, m as DurationValue, F as FontFamilyValue, n as FontWeightValue, w as GradientStop, G as GradientToken, v as GradientValue, a as ResolvedToken, S as ShadowToken, p as ShadowValueObject, s as StrokeStyleValue, t as StrokeStyleValueObject, T as TokenType, b as TokenValue, c as TokenValueReference, g as TransitionToken, u as TransitionValue, f as TypographyToken, q as TypographyValue, E as isBorderToken, x as isColorToken, y as isDimensionToken, H as isDurationToken, J as isGradientToken, z as isShadowToken, I as isTransitionToken, A as isTypographyToken } from './types-Bc0kA7De.js';
+export { T as Transform } from './types-CzHa7YkW.js';
+export { F as Filter } from './types-BzNcG-rI.js';
+export { J as JsModuleRendererOptions, a as JsonRendererOptions, P as Preprocessor } from './types-CZb19kiq.js';
 export { AndroidBuilderConfig, CssBuilderConfig, IosBuilderConfig, JsBuilderConfig, JsonBuilderConfig, TailwindBuilderConfig, android, css, ios, js, json, tailwind } from './builders.js';
 export { isOutputTree, outputTree } from './renderers.js';
 export { BasePermutationError, CircularReferenceError, ColorParseError, ConfigurationError, DimensionFormatError, DispersaError, FileOperationError, ModifierError, TokenReferenceError, ValidationError } from './errors.js';

package/dist/index.js

@@ -3393,32 +3393,55 @@ function filterTokensBySource(tokens, expectedSource) {
   }
   return filtered;
 }
-function interpolatePattern(pattern, modifierInputs, modifierName, context) {
-  let result = pattern;
-  if (modifierName !== void 0) {
-    result = result.replace(/\{modifierName\}/g, modifierName);
+function filterTokensFromSets(tokens) {
+  const filtered = {};
+  for (const [name, token] of Object.entries(tokens)) {
+    const hasModifierSource = typeof token._sourceModifier === "string" && token._sourceModifier !== "";
+    if (!hasModifierSource) {
+      filtered[name] = token;
+    }
   }
-  if (context !== void 0) {
-    result = result.replace(/\{context\}/g, context);
+  return filtered;
+}
+function resolveBaseFileName(fileName, defaults) {
+  if (typeof fileName === "function") {
+    return fileName({ ...defaults, _base: "true" });
+  }
+  if (/\{.+?\}/.test(fileName)) {
+    const baseInputs = Object.fromEntries(Object.keys(defaults).map((k) => [k, "base"]));
+    return collapseBaseSegments(interpolatePattern(fileName, baseInputs));
+  }
+  const extMatch = fileName.match(/(\.[^.]+)$/);
+  const extension = extMatch ? extMatch[1] : "";
+  const baseName = extension ? fileName.slice(0, -extension.length) : fileName;
+  return `${baseName}-base${extension}`;
+}
+function collapseBaseSegments(value) {
+  let result = value;
+  let previous = "";
+  while (result !== previous) {
+    previous = result;
+    result = result.replace(/\bbase([/-])base\b/, "base");
   }
+  return result;
+}
+function interpolatePattern(pattern, modifierInputs) {
+  let result = pattern;
   for (const [key, value] of Object.entries(modifierInputs)) {
     result = result.replaceAll(`{${key}}`, value);
   }
   return result;
 }
-function resolveFileName(fileName, modifierInputs, modifierName, context) {
+function resolveFileName(fileName, modifierInputs) {
   if (typeof fileName === "function") {
     return fileName(modifierInputs);
   }
   if (/\{.+?\}/.test(fileName)) {
-    return interpolatePattern(fileName, modifierInputs, modifierName, context);
+    return interpolatePattern(fileName, modifierInputs);
   }
   const extMatch = fileName.match(/(\.[^.]+)$/);
   const extension = extMatch ? extMatch[1] : "";
   const baseName = extension ? fileName.slice(0, -extension.length) : fileName;
-  if (modifierName !== void 0 && context !== void 0) {
-    return `${baseName}-${modifierName}-${context}${extension}`;
-  }
   const modifierSuffix = Object.entries(modifierInputs).sort(([keyA], [keyB]) => keyA.localeCompare(keyB)).map(([key, value]) => `${key}-${value}`).join("-");
   if (modifierSuffix) {
     return `${baseName}-${modifierSuffix}${extension}`;
@@ -7333,6 +7356,33 @@ function collectRemainder(tokens, included) {
   }
   return result;
 }
+function buildSetLayerBlocks(tokens, resolver) {
+  const blocks = [];
+  const included = /* @__PURE__ */ new Set();
+  const addBlock = (key, blockTokens, description) => {
+    if (Object.keys(blockTokens).length === 0) {
+      return;
+    }
+    for (const k of Object.keys(blockTokens)) {
+      included.add(k);
+    }
+    blocks.push({ key, description, tokens: blockTokens });
+  };
+  for (const item of resolver.resolutionOrder) {
+    const ref = item.$ref;
+    if (typeof ref !== "string" || !ref.startsWith("#/sets/")) {
+      continue;
+    }
+    const setName = ref.slice("#/sets/".length);
+    addBlock(
+      `Set: ${setName}`,
+      collectSetTokens(tokens, setName, included),
+      resolver.sets?.[setName]?.description
+    );
+  }
+  addBlock("Unattributed", collectRemainder(tokens, included));
+  return blocks;
+}
 function buildDefaultLayerBlocks(tokens, baseModifierInputs, resolver) {
   const blocks = [];
   const included = /* @__PURE__ */ new Set();
@@ -8053,6 +8103,10 @@ var CssRenderer = class _CssRenderer {
       throw new ConfigurationError("Modifier preset requires modifiers to be defined in resolver");
     }
     const files = {};
+    const baseResult = await this.buildModifierBaseFile(context, options);
+    if (baseResult) {
+      files[baseResult.fileName] = baseResult.content;
+    }
     for (const [modifierName, modifierDef] of Object.entries(context.resolver.modifiers)) {
       for (const contextValue of Object.keys(modifierDef.contexts)) {
         const result = await this.buildModifierContextFile(
@@ -8068,6 +8122,59 @@ var CssRenderer = class _CssRenderer {
     }
     return { kind: "outputTree", files };
   }
+  async buildModifierBaseFile(context, options) {
+    const basePermutation = context.permutations.find(
+      ({ modifierInputs }) => this.isBasePermutation(modifierInputs, context.meta.defaults)
+    );
+    if (!basePermutation) {
+      return void 0;
+    }
+    const setTokens = filterTokensFromSets(basePermutation.tokens);
+    if (Object.keys(setTokens).length === 0) {
+      return void 0;
+    }
+    const setBlocks = buildSetLayerBlocks(setTokens, context.resolver);
+    if (setBlocks.length === 0) {
+      return void 0;
+    }
+    const modifiers = context.resolver.modifiers;
+    const firstModifierName = Object.keys(modifiers)[0] ?? "";
+    const firstModifierContext = context.meta.defaults[firstModifierName] ?? "";
+    const baseModifierInputs = { ...context.meta.defaults };
+    const selector = resolveSelector(
+      options.selector,
+      firstModifierName,
+      firstModifierContext,
+      true,
+      baseModifierInputs
+    );
+    const mediaQuery = resolveMediaQuery(
+      options.mediaQuery,
+      firstModifierName,
+      firstModifierContext,
+      true,
+      baseModifierInputs
+    );
+    const referenceTokens = basePermutation.tokens;
+    const cssBlocks = [];
+    for (const block of setBlocks) {
+      const cleanTokens = stripInternalMetadata(block.tokens);
+      const css2 = await this.formatTokens(cleanTokens, {
+        selector,
+        mediaQuery,
+        minify: options.minify ?? false,
+        preserveReferences: options.preserveReferences ?? false,
+        referenceTokens
+      });
+      const header = block.description ? `/* ${block.key} */
+/* ${block.description} */` : `/* ${block.key} */`;
+      cssBlocks.push(`${header}
+${css2}`);
+    }
+    const content = cssBlocks.join("\n");
+    const fileName = context.output.file ? resolveBaseFileName(context.output.file, context.meta.defaults) : `${context.output.name}-base.css`;
+    return { fileName, content };
+  }
   collectTokensForModifierContext(modifierName, contextValue, permutations) {
     const expectedSource = `${modifierName}-${contextValue}`;
     let tokensFromSource = {};
@@ -8114,7 +8221,7 @@ var CssRenderer = class _CssRenderer {
       preserveReferences: options.preserveReferences ?? false,
       referenceTokens
     });
-    const fileName = context.output.file ? resolveFileName(context.output.file, modifierInputs, modifierName, contextValue) : buildInMemoryOutputKey({
+    const fileName = context.output.file ? resolveFileName(context.output.file, modifierInputs) : buildInMemoryOutputKey({
       outputName: context.output.name,
       extension: "css",
       modifierInputs,