@usefragments/core 1.10.0 → 1.10.2

package/dist/index.js

@@ -1,3 +1,7 @@
+import {
+  CompiledFragmentsFileValidationError,
+  parseCompiledFragmentsFile
+} from "./chunk-RANPUC6C.js";
 import {
   generateContext
 } from "./chunk-X34IA4LR.js";
@@ -185,10 +189,6 @@ import {
   severitySchema,
   sortBySeverity
 } from "./chunk-V4VQB57N.js";
-import {
-  CompiledFragmentsFileValidationError,
-  parseCompiledFragmentsFile
-} from "./chunk-RANPUC6C.js";
 
 // src/constants.ts
 var BRAND = {
@@ -2010,359 +2010,6 @@ function compileBlock(definition, filePath) {
 }
 var compileRecipe = compileBlock;
 
-// src/storyAdapter.ts
-import { createElement } from "react";
-
-// src/storybook-csf.ts
-import {
-  toId as storybookToId,
-  storyNameFromExport as storybookStoryNameFromExport,
-  isExportStory as storybookIsExportStory
-} from "@storybook/csf";
-var toId = (...args) => storybookToId(...args);
-var storyNameFromExport = (...args) => storybookStoryNameFromExport(...args);
-var isExportStory = (...args) => storybookIsExportStory(...args);
-
-// src/storyAdapter.ts
-var globalPreviewConfig = {};
-function setPreviewConfig(config) {
-  globalPreviewConfig = config;
-}
-function getPreviewConfig() {
-  return globalPreviewConfig;
-}
-function storyModuleToFragment(storyModule, filePath) {
-  const meta = storyModule.default;
-  const component = meta.component;
-  if (!component) {
-    return null;
-  }
-  const componentName = extractComponentName(meta, filePath);
-  const category = extractCategory(meta.title);
-  const props = convertArgTypes(meta.argTypes ?? {}, globalPreviewConfig.argTypes);
-  const variants = extractVariants(storyModule, component, meta);
-  const figmaUrl = extractFigmaUrl(meta.parameters);
-  const fragmentMeta = {
-    name: componentName,
-    description: meta.parameters?.docs?.description?.component ?? `${componentName} component`,
-    category,
-    tags: meta.tags?.filter((t) => t !== "autodocs"),
-    status: "stable",
-    figma: figmaUrl
-  };
-  const usage = {
-    when: [`Use ${componentName} for its intended purpose`],
-    whenNot: ["When a more specific component is available"]
-  };
-  return {
-    component,
-    meta: fragmentMeta,
-    usage,
-    props,
-    variants
-  };
-}
-function extractComponentName(meta, filePath) {
-  if (meta.title) {
-    const parts = meta.title.split("/");
-    return parts[parts.length - 1];
-  }
-  if (meta.component?.displayName) {
-    return meta.component.displayName;
-  }
-  if (meta.component?.name && meta.component.name !== "Component") {
-    return meta.component.name;
-  }
-  const match = filePath.match(/([^/\\]+)\.stories\.(tsx?|jsx?)$/);
-  return match?.[1] ?? "Unknown";
-}
-function extractCategory(title) {
-  if (!title) return "general";
-  const parts = title.split("/");
-  if (parts.length >= 3) {
-    return parts[parts.length - 2].toLowerCase();
-  }
-  return "general";
-}
-function extractFigmaUrl(parameters) {
-  if (!parameters) return void 0;
-  const design = parameters.design;
-  if (design?.url && typeof design.url === "string") {
-    return design.url;
-  }
-  if (typeof parameters.figma === "string") {
-    return parameters.figma;
-  }
-  return void 0;
-}
-function convertArgTypes(argTypes, globalArgTypes) {
-  const props = {};
-  const mergedArgTypes = { ...globalArgTypes, ...argTypes };
-  for (const [name, argType] of Object.entries(mergedArgTypes)) {
-    if (argType.table?.disable) continue;
-    if (argType.control === false && argType.action) continue;
-    const { controlType, controlOptions } = extractControlInfo(argType);
-    props[name] = {
-      type: inferPropType(argType),
-      description: argType.description ?? `${name} prop`,
-      ...argType.options && { values: argType.options },
-      ...argType.table?.defaultValue && {
-        default: argType.table.defaultValue.summary
-      },
-      ...argType.defaultValue !== void 0 && {
-        default: argType.defaultValue
-      },
-      ...argType.type?.required && { required: true },
-      ...controlType && { controlType },
-      ...controlOptions && Object.keys(controlOptions).length > 0 && { controlOptions }
-    };
-  }
-  return props;
-}
-function extractControlInfo(argType) {
-  if (argType.control === void 0 || argType.control === false) {
-    return {};
-  }
-  const control = typeof argType.control === "string" ? { type: argType.control } : argType.control;
-  const validControlTypes = [
-    "text",
-    "number",
-    "range",
-    "boolean",
-    "select",
-    "multi-select",
-    "radio",
-    "inline-radio",
-    "check",
-    "inline-check",
-    "object",
-    "file",
-    "color",
-    "date"
-  ];
-  const controlType = validControlTypes.includes(control.type) ? control.type : void 0;
-  const controlOptions = {};
-  if (control.min !== void 0) controlOptions.min = control.min;
-  if (control.max !== void 0) controlOptions.max = control.max;
-  if (control.step !== void 0) controlOptions.step = control.step;
-  if (control.presetColors) controlOptions.presetColors = control.presetColors;
-  return {
-    controlType,
-    controlOptions: Object.keys(controlOptions).length > 0 ? controlOptions : void 0
-  };
-}
-function inferPropType(argType) {
-  if (argType.action) return "function";
-  if (argType.options?.length) return "enum";
-  if (argType.type?.name) {
-    const typeMap = {
-      string: "string",
-      number: "number",
-      boolean: "boolean",
-      object: "object",
-      array: "array",
-      function: "function"
-    };
-    const mapped = typeMap[argType.type.name];
-    if (mapped) return mapped;
-  }
-  const control = typeof argType.control === "string" ? argType.control : argType.control ? argType.control.type : void 0;
-  if (control) {
-    const controlMap = {
-      // Text controls
-      text: "string",
-      // Number controls
-      number: "number",
-      range: "number",
-      // Boolean controls
-      boolean: "boolean",
-      check: "boolean",
-      "inline-check": "boolean",
-      // Enum/selection controls
-      select: "enum",
-      "multi-select": "enum",
-      radio: "enum",
-      "inline-radio": "enum",
-      // Object controls
-      object: "object",
-      file: "object",
-      // Special string controls
-      color: "string",
-      date: "string"
-    };
-    const mapped = controlMap[control];
-    if (mapped) return mapped;
-  }
-  return "string";
-}
-function isStory(value) {
-  if (typeof value === "object" && value !== null) {
-    const obj = value;
-    if ("args" in obj || "render" in obj || "play" in obj) return true;
-  }
-  if (typeof value === "function") {
-    const fn = value;
-    if ("args" in fn) return true;
-  }
-  return false;
-}
-function extractVariants(storyModule, component, meta) {
-  const variants = [];
-  for (const [exportName, exportValue] of Object.entries(storyModule)) {
-    if (exportName === "default") continue;
-    if (!isExportStory(exportName, meta)) continue;
-    if (!isStory(exportValue)) continue;
-    const story = exportValue;
-    const storyName = typeof story === "object" && story.name || typeof story === "object" && story.storyName || typeof story === "function" && story.storyName || storyNameFromExport(exportName);
-    const storyId = toId(meta.title || "Unknown", exportName);
-    let description = `${storyName} variant`;
-    if (typeof story === "object" && story.parameters?.docs?.description?.story) {
-      description = story.parameters.docs.description.story;
-    }
-    const storyPlayFn = typeof story === "object" ? story.play : story.play;
-    const hasPlayFunction = !!storyPlayFn;
-    const wrappedPlay = storyPlayFn ? async (context) => {
-      const args = {
-        ...globalPreviewConfig.args,
-        ...meta.args,
-        ...typeof story === "function" ? story.args : story.args
-      };
-      const fullContext = buildStoryContext(meta, story, args, storyId, storyName);
-      const playContext = {
-        ...fullContext,
-        canvasElement: context.canvasElement,
-        args: context.args,
-        step: context.step
-      };
-      await storyPlayFn(playContext);
-    } : void 0;
-    const storyTags = typeof story === "object" ? story.tags : void 0;
-    const loaders = collectLoaders(meta, story);
-    const variantArgs = {
-      ...globalPreviewConfig.args,
-      ...meta.args,
-      ...typeof story === "function" ? story.args : story.args
-    };
-    const hasArgs = Object.keys(variantArgs).length > 0;
-    variants.push({
-      name: storyName,
-      description,
-      render: createRenderFunction(story, component, meta, storyId, storyName),
-      // Store Storybook-specific metadata
-      ...hasPlayFunction && { hasPlayFunction: true },
-      ...wrappedPlay && { play: wrappedPlay },
-      ...storyId && { storyId },
-      ...storyTags && { tags: storyTags },
-      ...loaders.length > 0 && { loaders },
-      ...hasArgs && { args: variantArgs }
-    });
-  }
-  return variants;
-}
-function collectLoaders(meta, story) {
-  const allLoaders = [
-    ...globalPreviewConfig.loaders ?? [],
-    ...meta.loaders ?? [],
-    ...typeof story === "function" ? story.loaders ?? [] : story.loaders ?? []
-  ];
-  if (allLoaders.length === 0) {
-    return [];
-  }
-  return allLoaders.map((loader) => {
-    return async () => {
-      const minimalContext = {
-        args: {},
-        argTypes: {},
-        globals: {},
-        parameters: {},
-        id: "",
-        kind: meta.title || "Unknown",
-        name: "",
-        story: "",
-        viewMode: "story",
-        loaded: {},
-        abortSignal: new AbortController().signal,
-        componentId: "",
-        title: meta.title || "Unknown"
-      };
-      return loader(minimalContext);
-    };
-  });
-}
-function buildStoryContext(meta, story, args, storyId, storyName, loadedData) {
-  const mergedArgs = {
-    ...globalPreviewConfig.args,
-    ...meta.args,
-    ...typeof story === "object" ? story.args : story.args,
-    ...args
-  };
-  const mergedArgTypes = {
-    ...globalPreviewConfig.argTypes,
-    ...meta.argTypes,
-    ...typeof story === "object" ? story.argTypes : story.argTypes
-  };
-  const mergedParameters = {
-    ...globalPreviewConfig.parameters,
-    ...meta.parameters,
-    ...typeof story === "object" ? story.parameters : story.parameters
-  };
-  return {
-    args: mergedArgs,
-    argTypes: mergedArgTypes ?? {},
-    globals: {},
-    parameters: mergedParameters ?? {},
-    id: storyId,
-    kind: meta.title || "Unknown",
-    name: storyName,
-    story: storyName,
-    viewMode: "story",
-    loaded: loadedData ?? {},
-    abortSignal: new AbortController().signal,
-    componentId: toId(meta.title || "Unknown", ""),
-    title: meta.title || "Unknown"
-  };
-}
-function createRenderFunction(story, component, meta, storyId, storyName) {
-  return (options) => {
-    const args = {
-      ...globalPreviewConfig.args,
-      ...meta.args,
-      ...typeof story === "function" ? story.args : story.args,
-      ...options?.args
-      // Runtime overrides from viewer props panel
-    };
-    const loadedData = options?.loadedData;
-    const context = buildStoryContext(meta, story, args, storyId, storyName, loadedData);
-    let renderFn;
-    if (typeof story === "function") {
-      renderFn = () => story(args);
-    } else if (story.render) {
-      renderFn = () => story.render.length >= 2 ? story.render(args, context) : story.render(args);
-    } else if (meta.render) {
-      renderFn = () => meta.render.length >= 2 ? meta.render(args, context) : meta.render(args);
-    } else {
-      renderFn = () => createElement(component, args);
-    }
-    const allDecorators = [
-      ...globalPreviewConfig.decorators ?? [],
-      ...meta.decorators ?? [],
-      ...typeof story === "function" ? story.decorators ?? [] : story.decorators ?? []
-    ].reverse();
-    if (allDecorators.length > 0) {
-      return applyDecorators(renderFn, allDecorators, context);
-    }
-    return renderFn();
-  };
-}
-function applyDecorators(renderFn, decorators, context) {
-  let storyFn = renderFn;
-  for (const decorator of decorators) {
-    const wrappedFn = storyFn;
-    storyFn = () => decorator(wrappedFn, context);
-  }
-  return storyFn();
-}
-
 // src/storyFilters.ts
 var EXCLUDED_TAGS = /* @__PURE__ */ new Set(["hidden", "internal", "no-fragment"]);
 var SVG_ICON_RE = /^Svg[A-Z]/;
@@ -3052,11 +2699,11 @@ function detectTokenPrefix(names) {
 }
 function parseScssVariables(content) {
   const vars = /* @__PURE__ */ new Map();
-  const scssVarRegex = /^\s*(\$[\w-]+)\s*:\s*(.+?)\s*(?:!default\s*)?;/gm;
+  const scssVarRegex = /^\s*(\$[\w-]+)\s*:\s*([\s\S]*?)\s*(?:!default\s*)?;/gm;
   let match;
   while ((match = scssVarRegex.exec(content)) !== null) {
     const name = match[1];
-    const value = match[2].replace(/\s*\/\/.*$/, "").trim();
+    const value = match[2].replace(/\s*\/\/[^\n]*$/gm, "").replace(/\s+/g, " ").trim();
     if (!vars.has(name)) {
       vars.set(name, value);
     }
@@ -3129,6 +2776,7 @@ function parseScssTokens(content, filePath = "tokens.scss") {
   }
   for (const [name, value] of scssVars) {
     if (seenNames.has(name)) continue;
+    if (value.startsWith("(")) continue;
     seenNames.add(name);
     tokens.push({
       name,
@@ -4555,91 +4203,6 @@ function findBestCategoryCandidate(fragments, category, selectedSet, suggestedSe
   return best;
 }
 
-// src/preview-runtime.tsx
-import { useEffect, useState } from "react";
-import { Fragment, jsx } from "react/jsx-runtime";
-var EMPTY_STATE = {
-  content: null,
-  isLoading: false,
-  error: null,
-  loadedData: void 0
-};
-function toError(error) {
-  return error instanceof Error ? error : new Error(String(error));
-}
-async function executeVariantLoaders(loaders, loadedData) {
-  const hasLoaders = !!loaders && loaders.length > 0;
-  if (!hasLoaders) {
-    return loadedData;
-  }
-  const results = await Promise.all(loaders.map((loader) => loader()));
-  const mergedFromLoaders = results.reduce(
-    (acc, result) => ({ ...acc, ...result }),
-    {}
-  );
-  return loadedData ? { ...mergedFromLoaders, ...loadedData } : mergedFromLoaders;
-}
-async function resolvePreviewRuntimeState(options) {
-  const { variant, loadedData } = options;
-  if (!variant) {
-    return EMPTY_STATE;
-  }
-  try {
-    const mergedLoadedData = await executeVariantLoaders(variant.loaders, loadedData);
-    const content = variant.render({ loadedData: mergedLoadedData });
-    return {
-      content,
-      isLoading: false,
-      error: null,
-      loadedData: mergedLoadedData
-    };
-  } catch (error) {
-    return {
-      content: null,
-      isLoading: false,
-      error: toError(error),
-      loadedData: void 0
-    };
-  }
-}
-function usePreviewVariantRuntime(options) {
-  const { variant, loadedData } = options;
-  const [state, setState] = useState(EMPTY_STATE);
-  useEffect(() => {
-    let cancelled = false;
-    if (!variant) {
-      setState(EMPTY_STATE);
-      return () => {
-        cancelled = true;
-      };
-    }
-    const hasLoaders = !!variant.loaders && variant.loaders.length > 0;
-    setState({
-      content: null,
-      isLoading: hasLoaders,
-      error: null,
-      loadedData: void 0
-    });
-    resolvePreviewRuntimeState({ variant, loadedData }).then((nextState) => {
-      if (!cancelled) {
-        setState(nextState);
-      }
-    });
-    return () => {
-      cancelled = true;
-    };
-  }, [variant, loadedData]);
-  return state;
-}
-function PreviewVariantRuntime({
-  variant,
-  loadedData,
-  children: children2
-}) {
-  const state = usePreviewVariantRuntime({ variant, loadedData });
-  return /* @__PURE__ */ jsx(Fragment, { children: children2(state) });
-}
-
 // src/component-discovery.ts
 function isReactComponent(value) {
   if (!value) return false;
@@ -10400,7 +9963,6 @@ export {
   PRESET_NAMES,
   PROVE_DEFAULT_MAX_PASSES,
   PROVE_MAX_PASSES,
-  PreviewVariantRuntime,
   RAW_HTML_ADVISORY_TAGS,
   RAW_HTML_CANONICAL_TAGS,
   RAW_HTML_INPUT_TYPE_CANONICALS,
@@ -10513,7 +10075,6 @@ export {
   emptyConformResult,
   evaluateGovernanceIntegrity,
   excludeGlobToRegExp,
-  executeVariantLoaders,
   explainUrlForCode,
   factEvidenceSchema,
   factId,
@@ -10554,7 +10115,6 @@ export {
   generateSCSSVariables,
   generateTailwindConfig,
   getComplianceBadge,
-  getPreviewConfig,
   globalGovernanceRecordSchema,
   globalJsxGovernanceRecordSchema,
   globalStyleGovernanceRecordSchema,
@@ -10581,7 +10141,6 @@ export {
   isDenyEligible,
   isEffectiveCanonicalSource,
   isEnforceableHtmlEquivalent,
-  isExportStory,
   isFigmaPropMapping,
   isForceIncluded,
   isPortableRepoPath,
@@ -10727,7 +10286,6 @@ export {
   resolveFigmaMapping,
   resolveOwnedPackageImport,
   resolvePerformanceConfig,
-  resolvePreviewRuntimeState,
   resolveProveVerdict,
   resolveSpacingValue,
   resolveTokenValue,
@@ -10758,20 +10316,15 @@ export {
   scaleGovernanceRecordSchema,
   selectedRegistryComponentNames,
   serializeContractStamp,
-  setPreviewConfig,
   severityLevel,
   severitySchema,
   sha256Hex,
   sortBySeverity,
   sourceToRegistryTargetPath,
-  storyModuleToFragment,
-  storyNameFromExport,
   suppressionDirectiveSchema,
   tierFor,
-  toId,
   tokenIncludesFromConfig,
   topologyBase,
-  usePreviewVariantRuntime,
   validatorResultSchema,
   verifiedContractPreimageFromPin,
   violationSchema,