@vizejs/vite-plugin-musea 0.49.0 → 0.57.0

package/dist/index.d.mts

@@ -1,253 +0,0 @@
-import { c as ArtFileInfo, d as CsfOutput, f as CaptureConfig, g as VrtOptions, h as ViewportConfig, l as ArtMetadata, m as ComparisonConfig, n as generateVrtReport, o as VrtResult, p as CiConfig, r as MuseaVrtRunner, s as VrtSummary, t as generateVrtJsonReport, u as ArtVariant } from "./vrt-B4uxOrnN.mjs";
-import { c as AnalysisApiResponse, l as PaletteApiResponse, n as MuseaA11yRunner, o as A11yOptions, s as A11yResult, t as A11ySummary } from "./index-BWuuTDDw.mjs";
-import { AutogenOptions, AutogenOutput, GeneratedVariant, PropDefinition, generateArtFile, writeArtFile } from "./autogen/index.mjs";
-import { Plugin } from "vite";
-
-//#region src/types/plugin.d.ts
-/**
- * Theme color definitions for Musea gallery UI.
- * All properties are optional — unspecified colors inherit from the `base` built-in theme.
- */
-interface MuseaThemeColors {
-  bgPrimary?: string;
-  bgSecondary?: string;
-  bgTertiary?: string;
-  bgElevated?: string;
-  accent?: string;
-  accentHover?: string;
-  accentSubtle?: string;
-  text?: string;
-  textSecondary?: string;
-  textMuted?: string;
-  border?: string;
-  borderSubtle?: string;
-  success?: string;
-  error?: string;
-  info?: string;
-  warning?: string;
-  shadow?: string;
-}
-/**
- * Custom theme definition.
- */
-interface MuseaTheme {
-  /** Unique name for this theme. */
-  name: string;
-  /** Built-in theme to inherit unspecified colors from. @default 'dark' */
-  base?: "dark" | "light";
-  /** Color overrides. */
-  colors: MuseaThemeColors;
-}
-/**
- * Musea plugin options.
- */
-interface MuseaOptions {
-  /**
-   * Glob patterns to include Art files.
-   * @default ['**\/*.art.vue']
-   */
-  include?: string[];
-  /**
-   * Glob patterns to exclude.
-   * @default ['node_modules/**', 'dist/**']
-   */
-  exclude?: string[];
-  /**
-   * Base path for Musea gallery UI.
-   * @default '/__musea__'
-   */
-  basePath?: string;
-  /**
-   * Enable Storybook CSF output.
-   * @default false
-   */
-  storybookCompat?: boolean;
-  /**
-   * Storybook output directory (when storybookCompat is true).
-   * @default '.storybook/stories'
-   */
-  storybookOutDir?: string;
-  /**
-   * Enable inline <art> blocks in regular .vue SFC files.
-   * When enabled, regular .vue files containing <art> blocks will be
-   * included in the gallery. Use <Self> to reference the host component.
-   * @default false
-   */
-  inlineArt?: boolean;
-  /**
-   * VRT (Visual Regression Testing) configuration.
-   */
-  vrt?: VrtOptions;
-  /**
-   * Path to Style Dictionary tokens JSON file or directory.
-   * Supports standard Style Dictionary format.
-   * @example 'src/tokens.json' or 'src/tokens/'
-   */
-  tokensPath?: string;
-  /**
-   * Gallery theme configuration.
-   *
-   * - `'dark'` / `'light'` — use a built-in theme (default: `'dark'`)
-   * - `'system'` — follow the OS color-scheme preference
-   * - `MuseaTheme` — single custom theme (replaces defaults)
-   * - `MuseaTheme[]` — multiple custom themes (first is default, user can switch)
-   */
-  theme?: "dark" | "light" | "system" | MuseaTheme | MuseaTheme[];
-  /**
-   * CSS files to inject into component preview iframes.
-   * Useful for loading global styles (custom properties, resets, fonts, etc.)
-   * that components depend on.
-   *
-   * Paths are resolved relative to the project root.
-   * @example ['app/assets/styles/main.css']
-   */
-  previewCss?: string[];
-  /**
-   * Path to a module that exports a default setup function for preview iframes.
-   * The function receives the Vue `App` instance and can install plugins
-   * (e.g. vue-i18n, vue-router) before the component is mounted.
-   *
-   * Signature: `(app: App) => void | Promise<void>`
-   *
-   * Path is resolved relative to the project root.
-   * @example 'musea.preview.ts'
-   */
-  previewSetup?: string;
-}
-//#endregion
-//#region src/plugin/index.d.ts
-/**
- * Create Musea Vite plugin.
- */
-declare function musea(options?: MuseaOptions): Plugin[];
-//#endregion
-//#region src/tokens/parser.d.ts
-/**
- * Token parsing utilities for Style Dictionary integration.
- *
- * Reads and parses design token files (JSON) and directories,
- * flattening nested structures into categorized token collections.
- */
-/**
- * Design token value.
- */
-interface DesignToken {
-  value: string | number;
-  type?: string;
-  description?: string;
-  attributes?: Record<string, unknown>;
-  $tier?: "primitive" | "semantic";
-  $reference?: string;
-  $resolvedValue?: string | number;
-}
-/**
- * Token category (e.g., colors, spacing, typography).
- */
-interface TokenCategory {
-  name: string;
-  tokens: Record<string, DesignToken>;
-  subcategories?: TokenCategory[];
-}
-/**
- * Style Dictionary output format.
- */
-interface StyleDictionaryOutput {
-  categories: TokenCategory[];
-  metadata: {
-    name: string;
-    version?: string;
-    generatedAt: string;
-  };
-}
-/**
- * Configuration for Style Dictionary integration.
- */
-interface StyleDictionaryConfig {
-  /**
-   * Path to tokens JSON/JS file or directory.
-   */
-  tokensPath: string;
-  /**
-   * Output format for documentation.
-   * @default 'html'
-   */
-  outputFormat?: "html" | "json" | "markdown";
-  /**
-   * Output directory for generated documentation.
-   * @default '.vize/tokens'
-   */
-  outputDir?: string;
-  /**
-   * Custom token transformations.
-   */
-  transforms?: TokenTransform[];
-}
-/**
- * Token transformation function.
- */
-type TokenTransform = (token: DesignToken, path: string[]) => DesignToken;
-/**
- * Parse Style Dictionary tokens file.
- */
-declare function parseTokens(tokensPath: string): Promise<TokenCategory[]>;
-//#endregion
-//#region src/tokens/usage.d.ts
-/**
- * Scan art file sources for token value matches in `<style>` blocks.
- */
-declare function scanTokenUsage(artFiles: Map<string, {
-  path: string;
-  metadata: {
-    title: string;
-    category?: string;
-  };
-}>, tokenMap: Record<string, DesignToken>): TokenUsageMap;
-//#endregion
-//#region src/tokens/resolver.d.ts
-/**
- * Token usage match within a single CSS property.
- */
-interface TokenUsageMatch {
-  line: number;
-  lineContent: string;
-  property: string;
-}
-/**
- * Token usage entry for a single art file.
- */
-interface TokenUsageEntry {
-  artPath: string;
-  artTitle: string;
-  artCategory?: string;
-  matches: TokenUsageMatch[];
-}
-/**
- * Map of token paths to their usage locations across art files.
- */
-type TokenUsageMap = Record<string, TokenUsageEntry[]>;
-/**
- * Flatten nested categories into a flat map keyed by dot-path.
- */
-declare function buildTokenMap(categories: TokenCategory[], prefix?: string[]): Record<string, DesignToken>;
-/**
- * Resolve references in categories, setting $tier, $reference, and $resolvedValue.
- */
-declare function resolveReferences(categories: TokenCategory[], tokenMap: Record<string, DesignToken>): void;
-//#endregion
-//#region src/tokens/generator.d.ts
-/**
- * Generate HTML documentation for tokens.
- */
-declare function generateTokensHtml(categories: TokenCategory[]): string;
-/**
- * Generate Markdown documentation for tokens.
- */
-declare function generateTokensMarkdown(categories: TokenCategory[]): string;
-/**
- * Style Dictionary plugin for Musea.
- * Parses tokens and generates documentation in the specified format.
- */
-declare function processStyleDictionary(config: StyleDictionaryConfig): Promise<StyleDictionaryOutput>;
-//#endregion
-export { type A11yOptions, type A11yResult, type A11ySummary, type AnalysisApiResponse, type ArtFileInfo, type ArtMetadata, type ArtVariant, type AutogenOptions, type AutogenOutput, type CaptureConfig, type CiConfig, type ComparisonConfig, type CsfOutput, type DesignToken, type GeneratedVariant, MuseaA11yRunner, type MuseaOptions, type MuseaTheme, type MuseaThemeColors, MuseaVrtRunner, type PaletteApiResponse, type PropDefinition, type StyleDictionaryConfig, type StyleDictionaryOutput, type TokenCategory, type TokenUsageMap, type ViewportConfig, type VrtOptions, type VrtResult, type VrtSummary, buildTokenMap, musea as default, musea, generateArtFile, generateTokensHtml, generateTokensMarkdown, generateVrtJsonReport, generateVrtReport, parseTokens, processStyleDictionary, resolveReferences, scanTokenUsage, writeArtFile };
-//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/plugin.ts","../src/plugin/index.ts","../src/tokens/parser.ts","../src/tokens/usage.ts","../src/tokens/resolver.ts","../src/tokens/generator.ts"],"mappings":";;;;;;;;;;UAMiB,gBAAA;EACf,SAAA;EACA,WAAA;EACA,UAAA;EACA,UAAA;EACA,MAAA;EACA,WAAA;EACA,YAAA;EACA,IAAA;EACA,aAAA;EACA,SAAA;EACA,MAAA;EACA,YAAA;EACA,OAAA;EACA,KAAA;EACA,IAAA;EACA,OAAA;EACA,MAAA;AAAA;;;;UAMe,UAAA;EANT;EAQN,IAAA;EAFyB;EAIzB,IAAA;EAEwB;EAAxB,MAAA,EAAQ,gBAAA;AAAA;;;;UAMO,YAAA;EAAA;;;;EAKf,OAAA;EAsDmD;;;;EAhDnD,OAAA;EAMA;;;;EAAA,QAAA;EAyBM;;;;EAnBN,eAAA;EA8CA;;;;EAxCA,eAAA;;;AClCF;;;;ED0CE,SAAA;EC1CoB;;;ED+CpB,GAAA,GAAM,UAAA;;;;AEtER;;EF6EE,UAAA;EEzEmB;;;;;;;;EFmFnB,KAAA,iCAAsC,UAAA,GAAa,UAAA;EEhFrC;;AAMhB;;;;;;EFoFE,UAAA;EEjF6B;;;;;;;;;AAM/B;EFuFE,YAAA;AAAA;;;;;;iBCtFc,KAAA,CAAM,OAAA,GAAS,YAAA,GAAoB,MAAA;;;;;;;;;AD9BnD;;;AAAA,UEOiB,WAAA;EACf,KAAA;EACA,IAAA;EACA,WAAA;EACA,UAAA,GAAa,MAAA;EACb,KAAA;EACA,UAAA;EACA,cAAA;AAAA;;;;UAMe,aAAA;EACf,IAAA;EACA,MAAA,EAAQ,MAAA,SAAe,WAAA;EACvB,aAAA,GAAgB,aAAA;AAAA;;;;UAMD,qBAAA;EACf,UAAA,EAAY,aAAA;EACZ,QAAA;IACE,IAAA;IACA,OAAA;IACA,WAAA;EAAA;AAAA;;;AFCJ;UEMiB,qBAAA;;;;EAIf,UAAA;EFiD6D;;;;EE3C7D,YAAA;EFOA;;;;EEDA,SAAA;EF2BA;;;EEtBA,UAAA,GAAa,cAAA;AAAA;;;;KAMH,cAAA,IAAkB,KAAA,EAAO,WAAA,EAAa,IAAA,eAAmB,WAAA;;;ADtCrE;iBC2CsB,WAAA,CAAY,UAAA,WAAqB,OAAA,CAAQ,aAAA;;;;;;iBCvC/C,cAAA,CACd,QAAA,EAAU,GAAA;EAAc,IAAA;EAAc,QAAA;IAAY,KAAA;IAAe,QAAA;EAAA;AAAA,IACjE,QAAA,EAAU,MAAA,SAAe,WAAA,IACxB,aAAA;;;;;;UC1Bc,eAAA;EACf,IAAA;EACA,WAAA;EACA,QAAA;AAAA;;;;UAMe,eAAA;EACf,OAAA;EACA,QAAA;EACA,WAAA;EACA,OAAA,EAAS,eAAA;AAAA;;;;KAMC,aAAA,GAAgB,MAAA,SAAe,eAAA;AJP3C;;;AAAA,iBIegB,aAAA,CACd,UAAA,EAAY,aAAA,IACZ,MAAA,cACC,MAAA,SAAe,WAAA;;;;iBAwBF,iBAAA,CACd,UAAA,EAAY,aAAA,IACZ,QAAA,EAAU,MAAA,SAAe,WAAA;;;;;;iBCzDX,kBAAA,CAAmB,UAAA,EAAY,aAAA;;;;iBAqI/B,sBAAA,CAAuB,UAAA,EAAY,aAAA;;;;;iBAuC7B,sBAAA,CACpB,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,qBAAA"}