@razorwind/sandpack 0.0.2

package/dist/index.d.cts

@@ -0,0 +1,328 @@
+import { flattenTokens, formatTokenValue, resolveTokenSets, toCssVar } from "@razorwind/core/utils";
+import { GeneratorFunctionResult } from "@power-plant/core";
+import { Component, ComponentUsage, Components, Schema, Tokens } from "@razorwind/core/schema";
+import { TokenType } from "@power-plant/dtcg-schema";
+//#region src/types.d.ts
+/**
+ * A flattened design token ready for Sandpack theme mapping.
+ */
+interface FlatToken {
+  /** Dot-separated token path (e.g. `color.primary`). */
+  path: string;
+  /** DTCG `$type`, when known. */
+  type?: TokenType | string;
+  /** Raw `$value` from the token document. */
+  value: unknown;
+  /** CSS-friendly string form of {@link value}. */
+  cssValue: string;
+  /** Optional DTCG `$description`. */
+  description?: string;
+  /** Theme / set id when tokens are a `Record<string, Tokens>`. */
+  theme?: string;
+}
+/**
+ * Syntax style token for Sandpack themes.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ */
+interface SandpackSyntaxStyle {
+  color?: string;
+  fontStyle?: "normal" | "italic";
+  fontWeight?: "normal" | "bold" | "100" | "200" | "300" | "400" | "500" | "600" | "700" | "800" | "900";
+  textDecoration?: "none" | "underline" | "line-through" | "underline line-through";
+}
+/**
+ * Sandpack UI color tokens (`theme.colors`).
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ */
+interface SandpackThemeColors {
+  surface1?: string;
+  surface2?: string;
+  surface3?: string;
+  disabled?: string;
+  base?: string;
+  clickable?: string;
+  hover?: string;
+  accent?: string;
+  error?: string;
+  errorSurface?: string;
+  warning?: string;
+  warningSurface?: string;
+}
+/**
+ * Sandpack syntax highlight tokens (`theme.syntax`).
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ */
+interface SandpackThemeSyntax {
+  plain?: string | SandpackSyntaxStyle;
+  comment?: string | SandpackSyntaxStyle;
+  keyword?: string | SandpackSyntaxStyle;
+  definition?: string | SandpackSyntaxStyle;
+  punctuation?: string | SandpackSyntaxStyle;
+  property?: string | SandpackSyntaxStyle;
+  tag?: string | SandpackSyntaxStyle;
+  static?: string | SandpackSyntaxStyle;
+  string?: string | SandpackSyntaxStyle;
+}
+/**
+ * Sandpack typography tokens (`theme.font`).
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ */
+interface SandpackThemeFont {
+  body?: string;
+  mono?: string;
+  size?: string;
+  lineHeight?: string;
+}
+/**
+ * Sandpack custom theme document.
+ *
+ * Pass the emitted JSON (minus Razorwind `name` / `displayName`) to
+ * `<Sandpack theme={...} />`. Partial objects override the default light theme.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ */
+interface SandpackTheme {
+  /** Stable theme id — used for the theme file name. */
+  name: string;
+  /** Human-readable label for INSTALL.md. Defaults to {@link name}. */
+  displayName?: string;
+  colors?: SandpackThemeColors;
+  syntax?: SandpackThemeSyntax;
+  font?: SandpackThemeFont;
+}
+/**
+ * Map extracted design tokens to one or more Sandpack theme documents.
+ *
+ * Return a single theme, an array, or a record keyed by theme id.
+ */
+type GenerateSandpackTheme = (tokens: Tokens | Record<string, Tokens>) => SandpackTheme | SandpackTheme[] | Record<string, SandpackTheme>;
+/**
+ * A single Sandpack file entry for the `files` prop.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+interface SandpackFile {
+  code: string;
+  hidden?: boolean;
+  active?: boolean;
+  readOnly?: boolean;
+}
+/**
+ * Sandpack `files` prop — path keys map to source strings or file objects.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+type SandpackFiles = Record<string, string | SandpackFile>;
+/**
+ * A component usage demo ready for `<Sandpack files={...} />`.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+interface SandpackUsage {
+  /** Stable demo id — used for the usage file name. */
+  name: string;
+  /** Human-readable label for INSTALL.md. Defaults to {@link name}. */
+  displayName?: string;
+  /** Component id this demo belongs to. */
+  component?: string;
+  title?: string;
+  description?: string;
+  /**
+   * Sandpack template preset.
+   *
+   * @defaultValue `"react"`
+   */
+  template?: string;
+  /** Sandpack `files` prop payload. */
+  files: SandpackFiles;
+  /**
+   * Theme id matching a generated theme `name`, or an inline theme payload
+   * (without Razorwind `name` / `displayName`).
+   */
+  theme?: string | Omit<SandpackTheme, "name" | "displayName">;
+  /** Extra npm dependencies for `customSetup.dependencies`. */
+  dependencies?: Record<string, string>;
+  /** Optional sandbox entry path (`customSetup.entry`). */
+  entry?: string;
+}
+/**
+ * Map extracted components (and tokens) to Sandpack usage demos.
+ *
+ * Return a single demo, an array, or a record keyed by demo id.
+ * When omitted, demos are built from `schema.components[].usage`.
+ */
+type GenerateSandpackFiles = (components: Components, tokens: Tokens | Record<string, Tokens>) => SandpackUsage | SandpackUsage[] | Record<string, SandpackUsage>;
+/**
+ * Options for the Razorwind Sandpack theme / usage generator.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+interface SandpackPluginOptions {
+  /**
+   * Directory (relative to the execution cwd) for generated theme and usage
+   * files.
+   *
+   * @defaultValue `"sandpack"`
+   */
+  outputPath?: string;
+  /**
+   * Map extracted tokens to Sandpack theme document(s).
+   *
+   * Required — without a mapping there is nothing to emit for themes.
+   */
+  mapTheme: GenerateSandpackTheme;
+  /**
+   * Map extracted components to Sandpack usage demos (`files` prop payloads).
+   *
+   * When omitted and {@link includeUsage} is not `false`, demos are derived
+   * from `schema.components[].usage`.
+   */
+  mapFiles?: GenerateSandpackFiles;
+  /**
+   * Emit component usage demos under `usage/`.
+   *
+   * @defaultValue `true`
+   */
+  includeUsage?: boolean;
+  /**
+   * Default Sandpack template for auto-built usage demos.
+   *
+   * @defaultValue `"react"`
+   */
+  template?: string;
+  /**
+   * Override body for generated `INSTALL.md`. When omitted, Sandpack install
+   * steps are written (import theme / files into `<Sandpack />`).
+   */
+  installGuide?: string;
+  /**
+   * Restrict flattened helper tokens to these DTCG `$type` values.
+   * Does not filter what {@link mapTheme} receives.
+   */
+  includeTypes?: TokenType[];
+}
+//#endregion
+//#region src/install.d.ts
+/**
+ * Build Sandpack INSTALL.md for generated theme and usage files.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+declare function renderInstallMd(options: {
+  themes: Array<{
+    name: string;
+    displayName: string;
+    fileName: string;
+  }>;
+  usages: Array<{
+    name: string;
+    displayName: string;
+    fileName: string;
+    component?: string;
+  }>;
+}): string;
+//#endregion
+//#region src/generate.d.ts
+/**
+ * Normalize {@link SandpackPluginOptions.mapTheme} results into a theme list.
+ */
+declare function normalizeThemes(result: SandpackTheme | SandpackTheme[] | Record<string, SandpackTheme>): SandpackTheme[];
+/**
+ * Normalize {@link SandpackPluginOptions.mapFiles} results into a usage list.
+ */
+declare function normalizeUsages(result: SandpackUsage | SandpackUsage[] | Record<string, SandpackUsage>): SandpackUsage[];
+/**
+ * Serialize a Sandpack theme document for `themes/*.json`.
+ *
+ * Emits only Sandpack `theme` prop fields (`colors`, `syntax`, `font`).
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ */
+declare function renderThemeJson(theme: SandpackTheme): string;
+/**
+ * Serialize a Sandpack usage demo for `usage/*.json`.
+ *
+ * Shape is ready to feed `<Sandpack files={...} template={...} />`.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+declare function renderUsageJson(usage: SandpackUsage): string;
+/**
+ * Generate Sandpack theme JSON and component usage demos from a Razorwind
+ * schema.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+declare function generateSandpackTheme(spec: Schema, options: SandpackPluginOptions): GeneratorFunctionResult<Schema, SandpackPluginOptions>;
+//#endregion
+//#region src/usage.d.ts
+/**
+ * Build Sandpack `files` for a single component usage example.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+declare function usageToSandpackFiles(usage: ComponentUsage, component: Component): SandpackFiles | undefined;
+/**
+ * Derive Sandpack usage demos from extracted `schema.components[].usage`.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+declare function buildUsageFromComponents(components: Components, options?: {
+  template?: string;
+}): SandpackUsage[];
+//#endregion
+//#region src/index.d.ts
+/**
+ * Razorwind plugin that turns design tokens into Sandpack themes and component
+ * usage demos (`files` prop payloads).
+ *
+ * Provide {@link SandpackPluginOptions.mapTheme} to map extracted tokens to one
+ * or more theme documents. Component `usage` examples are emitted as Sandpack
+ * `files` JSON under `usage/` (override with {@link SandpackPluginOptions.mapFiles}).
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "@razorwind/core";
+ * import sandpack, { flattenTokens } from "@razorwind/sandpack";
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     sandpack({
+ *       mapTheme: tokens => {
+ *         const flat = flattenTokens(tokens);
+ *         const color = (path: string) =>
+ *           flat.find(t => t.path === path)?.cssValue ?? "#000000";
+ *
+ *         return {
+ *           name: "my-theme",
+ *           colors: {
+ *             surface1: color("color.bg"),
+ *             base: color("color.fg"),
+ *             accent: color("color.accent")
+ *           },
+ *           syntax: {
+ *             plain: color("color.fg"),
+ *             comment: color("color.muted"),
+ *             string: color("color.accent")
+ *           }
+ *         };
+ *       }
+ *     })
+ *   ]
+ * });
+ * ```
+ */
+declare const _default: (options?: SandpackPluginOptions | undefined) => import("@razorwind/core/plugin").Plugin;
+//#endregion
+export { type FlatToken, type GenerateSandpackFiles, type GenerateSandpackTheme, type SandpackFile, type SandpackFiles, type SandpackPluginOptions, type SandpackSyntaxStyle, type SandpackTheme, type SandpackThemeColors, type SandpackThemeFont, type SandpackThemeSyntax, type SandpackUsage, buildUsageFromComponents, _default as default, flattenTokens, formatTokenValue, generateSandpackTheme, normalizeThemes, normalizeUsages, renderInstallMd, renderThemeJson, renderUsageJson, resolveTokenSets, toCssVar, usageToSandpackFiles };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/install.ts","../src/generate.ts","../src/usage.ts","../src/index.ts"],"mappings":";;;;;;;;UAwBiB;;EAEf;;EAEA,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;;;;;;UAQe;EACf;EACA;EACA;EAYA;;;;;;;UAYe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;UAQe;EACf,iBAAiB;EACjB,mBAAmB;EACnB,mBAAmB;EACnB,sBAAsB;EACtB,uBAAuB;EACvB,oBAAoB;EACpB,eAAe;EACf,kBAAkB;EAClB,kBAAkB;;;;;;;UAQH;EACf;EACA;EACA;EACA;;;;;;;;;;UAWe;;EAEf;;EAEA;EACA,SAAS;EACT,SAAS;EACT,OAAO;;;;;;;KAQG,yBACV,QAAQ,SAAS,eAAe,YAC7B,gBAAgB,kBAAkB,eAAe;;;;;;UAOrC;EACf;EACA;EACA;EACA;;;;;;;KAQU,gBAAgB,wBAAwB;;;;;;UAOnC;;EAEf;;EAEA;;EAEA;EACA;EACA;;;;;;EAMA;;EAEA,OAAO;;;;;EAKP,iBAAiB,KAAK;;EAEtB,eAAe;;EAEf;;;;;;;;KASU,yBACV,YAAY,YACZ,QAAQ,SAAS,eAAe,YAC7B,gBAAgB,kBAAkB,eAAe;;;;;;;UAQrC;;;;;;;EAOf;;;;;;EAOA,UAAU;;;;;;;EAQV,WAAW;;;;;;EAOX;;;;;;EAOA;;;;;EAMA;;;;;EAMA,eAAe;;;;;;;;;;iBCxOD,gBAAgB;EAC9B,QAAQ;IAAQ;IAAc;IAAqB;;EACnD,QAAQ;IACN;IACA;IACA;IACA;;;;;;;;iBC8DY,gBACd,QAAQ,gBAAgB,kBAAkB,eAAe,iBACxD;;;;iBAsCa,gBACd,QAAQ,gBAAgB,kBAAkB,eAAe,iBACxD;;;;;;;;iBAgFa,gBAAgB,OAAO;;;;;;;;iBAuBvB,gBAAgB,OAAO;;;;;;;;iBAyCvB,sBACd,MAAM,QACN,SAAS,wBACR,wBAAwB,QAAQ;;;;;;;;iBCjMnB,qBACd,OAAO,gBACP,WAAW,YACV;;;;;;iBA+Ca,yBACd,YAAY,YACZ;EAAW;IACV"}

package/dist/index.d.mts

@@ -0,0 +1,328 @@
+import { flattenTokens, formatTokenValue, resolveTokenSets, toCssVar } from "@razorwind/core/utils";
+import { GeneratorFunctionResult } from "@power-plant/core";
+import { Component, ComponentUsage, Components, Schema, Tokens } from "@razorwind/core/schema";
+import { TokenType } from "@power-plant/dtcg-schema";
+//#region src/types.d.ts
+/**
+ * A flattened design token ready for Sandpack theme mapping.
+ */
+interface FlatToken {
+  /** Dot-separated token path (e.g. `color.primary`). */
+  path: string;
+  /** DTCG `$type`, when known. */
+  type?: TokenType | string;
+  /** Raw `$value` from the token document. */
+  value: unknown;
+  /** CSS-friendly string form of {@link value}. */
+  cssValue: string;
+  /** Optional DTCG `$description`. */
+  description?: string;
+  /** Theme / set id when tokens are a `Record<string, Tokens>`. */
+  theme?: string;
+}
+/**
+ * Syntax style token for Sandpack themes.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ */
+interface SandpackSyntaxStyle {
+  color?: string;
+  fontStyle?: "normal" | "italic";
+  fontWeight?: "normal" | "bold" | "100" | "200" | "300" | "400" | "500" | "600" | "700" | "800" | "900";
+  textDecoration?: "none" | "underline" | "line-through" | "underline line-through";
+}
+/**
+ * Sandpack UI color tokens (`theme.colors`).
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ */
+interface SandpackThemeColors {
+  surface1?: string;
+  surface2?: string;
+  surface3?: string;
+  disabled?: string;
+  base?: string;
+  clickable?: string;
+  hover?: string;
+  accent?: string;
+  error?: string;
+  errorSurface?: string;
+  warning?: string;
+  warningSurface?: string;
+}
+/**
+ * Sandpack syntax highlight tokens (`theme.syntax`).
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ */
+interface SandpackThemeSyntax {
+  plain?: string | SandpackSyntaxStyle;
+  comment?: string | SandpackSyntaxStyle;
+  keyword?: string | SandpackSyntaxStyle;
+  definition?: string | SandpackSyntaxStyle;
+  punctuation?: string | SandpackSyntaxStyle;
+  property?: string | SandpackSyntaxStyle;
+  tag?: string | SandpackSyntaxStyle;
+  static?: string | SandpackSyntaxStyle;
+  string?: string | SandpackSyntaxStyle;
+}
+/**
+ * Sandpack typography tokens (`theme.font`).
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ */
+interface SandpackThemeFont {
+  body?: string;
+  mono?: string;
+  size?: string;
+  lineHeight?: string;
+}
+/**
+ * Sandpack custom theme document.
+ *
+ * Pass the emitted JSON (minus Razorwind `name` / `displayName`) to
+ * `<Sandpack theme={...} />`. Partial objects override the default light theme.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ */
+interface SandpackTheme {
+  /** Stable theme id — used for the theme file name. */
+  name: string;
+  /** Human-readable label for INSTALL.md. Defaults to {@link name}. */
+  displayName?: string;
+  colors?: SandpackThemeColors;
+  syntax?: SandpackThemeSyntax;
+  font?: SandpackThemeFont;
+}
+/**
+ * Map extracted design tokens to one or more Sandpack theme documents.
+ *
+ * Return a single theme, an array, or a record keyed by theme id.
+ */
+type GenerateSandpackTheme = (tokens: Tokens | Record<string, Tokens>) => SandpackTheme | SandpackTheme[] | Record<string, SandpackTheme>;
+/**
+ * A single Sandpack file entry for the `files` prop.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+interface SandpackFile {
+  code: string;
+  hidden?: boolean;
+  active?: boolean;
+  readOnly?: boolean;
+}
+/**
+ * Sandpack `files` prop — path keys map to source strings or file objects.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+type SandpackFiles = Record<string, string | SandpackFile>;
+/**
+ * A component usage demo ready for `<Sandpack files={...} />`.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+interface SandpackUsage {
+  /** Stable demo id — used for the usage file name. */
+  name: string;
+  /** Human-readable label for INSTALL.md. Defaults to {@link name}. */
+  displayName?: string;
+  /** Component id this demo belongs to. */
+  component?: string;
+  title?: string;
+  description?: string;
+  /**
+   * Sandpack template preset.
+   *
+   * @defaultValue `"react"`
+   */
+  template?: string;
+  /** Sandpack `files` prop payload. */
+  files: SandpackFiles;
+  /**
+   * Theme id matching a generated theme `name`, or an inline theme payload
+   * (without Razorwind `name` / `displayName`).
+   */
+  theme?: string | Omit<SandpackTheme, "name" | "displayName">;
+  /** Extra npm dependencies for `customSetup.dependencies`. */
+  dependencies?: Record<string, string>;
+  /** Optional sandbox entry path (`customSetup.entry`). */
+  entry?: string;
+}
+/**
+ * Map extracted components (and tokens) to Sandpack usage demos.
+ *
+ * Return a single demo, an array, or a record keyed by demo id.
+ * When omitted, demos are built from `schema.components[].usage`.
+ */
+type GenerateSandpackFiles = (components: Components, tokens: Tokens | Record<string, Tokens>) => SandpackUsage | SandpackUsage[] | Record<string, SandpackUsage>;
+/**
+ * Options for the Razorwind Sandpack theme / usage generator.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+interface SandpackPluginOptions {
+  /**
+   * Directory (relative to the execution cwd) for generated theme and usage
+   * files.
+   *
+   * @defaultValue `"sandpack"`
+   */
+  outputPath?: string;
+  /**
+   * Map extracted tokens to Sandpack theme document(s).
+   *
+   * Required — without a mapping there is nothing to emit for themes.
+   */
+  mapTheme: GenerateSandpackTheme;
+  /**
+   * Map extracted components to Sandpack usage demos (`files` prop payloads).
+   *
+   * When omitted and {@link includeUsage} is not `false`, demos are derived
+   * from `schema.components[].usage`.
+   */
+  mapFiles?: GenerateSandpackFiles;
+  /**
+   * Emit component usage demos under `usage/`.
+   *
+   * @defaultValue `true`
+   */
+  includeUsage?: boolean;
+  /**
+   * Default Sandpack template for auto-built usage demos.
+   *
+   * @defaultValue `"react"`
+   */
+  template?: string;
+  /**
+   * Override body for generated `INSTALL.md`. When omitted, Sandpack install
+   * steps are written (import theme / files into `<Sandpack />`).
+   */
+  installGuide?: string;
+  /**
+   * Restrict flattened helper tokens to these DTCG `$type` values.
+   * Does not filter what {@link mapTheme} receives.
+   */
+  includeTypes?: TokenType[];
+}
+//#endregion
+//#region src/install.d.ts
+/**
+ * Build Sandpack INSTALL.md for generated theme and usage files.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+declare function renderInstallMd(options: {
+  themes: Array<{
+    name: string;
+    displayName: string;
+    fileName: string;
+  }>;
+  usages: Array<{
+    name: string;
+    displayName: string;
+    fileName: string;
+    component?: string;
+  }>;
+}): string;
+//#endregion
+//#region src/generate.d.ts
+/**
+ * Normalize {@link SandpackPluginOptions.mapTheme} results into a theme list.
+ */
+declare function normalizeThemes(result: SandpackTheme | SandpackTheme[] | Record<string, SandpackTheme>): SandpackTheme[];
+/**
+ * Normalize {@link SandpackPluginOptions.mapFiles} results into a usage list.
+ */
+declare function normalizeUsages(result: SandpackUsage | SandpackUsage[] | Record<string, SandpackUsage>): SandpackUsage[];
+/**
+ * Serialize a Sandpack theme document for `themes/*.json`.
+ *
+ * Emits only Sandpack `theme` prop fields (`colors`, `syntax`, `font`).
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ */
+declare function renderThemeJson(theme: SandpackTheme): string;
+/**
+ * Serialize a Sandpack usage demo for `usage/*.json`.
+ *
+ * Shape is ready to feed `<Sandpack files={...} template={...} />`.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+declare function renderUsageJson(usage: SandpackUsage): string;
+/**
+ * Generate Sandpack theme JSON and component usage demos from a Razorwind
+ * schema.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+declare function generateSandpackTheme(spec: Schema, options: SandpackPluginOptions): GeneratorFunctionResult<Schema, SandpackPluginOptions>;
+//#endregion
+//#region src/usage.d.ts
+/**
+ * Build Sandpack `files` for a single component usage example.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+declare function usageToSandpackFiles(usage: ComponentUsage, component: Component): SandpackFiles | undefined;
+/**
+ * Derive Sandpack usage demos from extracted `schema.components[].usage`.
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ */
+declare function buildUsageFromComponents(components: Components, options?: {
+  template?: string;
+}): SandpackUsage[];
+//#endregion
+//#region src/index.d.ts
+/**
+ * Razorwind plugin that turns design tokens into Sandpack themes and component
+ * usage demos (`files` prop payloads).
+ *
+ * Provide {@link SandpackPluginOptions.mapTheme} to map extracted tokens to one
+ * or more theme documents. Component `usage` examples are emitted as Sandpack
+ * `files` JSON under `usage/` (override with {@link SandpackPluginOptions.mapFiles}).
+ *
+ * @see https://sandpack.codesandbox.io/docs/getting-started/themes#custom-theme
+ * @see https://sandpack.codesandbox.io/docs/getting-started/usage#files
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "@razorwind/core";
+ * import sandpack, { flattenTokens } from "@razorwind/sandpack";
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     sandpack({
+ *       mapTheme: tokens => {
+ *         const flat = flattenTokens(tokens);
+ *         const color = (path: string) =>
+ *           flat.find(t => t.path === path)?.cssValue ?? "#000000";
+ *
+ *         return {
+ *           name: "my-theme",
+ *           colors: {
+ *             surface1: color("color.bg"),
+ *             base: color("color.fg"),
+ *             accent: color("color.accent")
+ *           },
+ *           syntax: {
+ *             plain: color("color.fg"),
+ *             comment: color("color.muted"),
+ *             string: color("color.accent")
+ *           }
+ *         };
+ *       }
+ *     })
+ *   ]
+ * });
+ * ```
+ */
+declare const _default: (options?: SandpackPluginOptions | undefined) => import("@razorwind/core/plugin").Plugin;
+//#endregion
+export { type FlatToken, type GenerateSandpackFiles, type GenerateSandpackTheme, type SandpackFile, type SandpackFiles, type SandpackPluginOptions, type SandpackSyntaxStyle, type SandpackTheme, type SandpackThemeColors, type SandpackThemeFont, type SandpackThemeSyntax, type SandpackUsage, buildUsageFromComponents, _default as default, flattenTokens, formatTokenValue, generateSandpackTheme, normalizeThemes, normalizeUsages, renderInstallMd, renderThemeJson, renderUsageJson, resolveTokenSets, toCssVar, usageToSandpackFiles };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/install.ts","../src/generate.ts","../src/usage.ts","../src/index.ts"],"mappings":""}