@mui/internal-docs-infra 0.1.1-alpha.1 → 0.1.1-alpha.11

package/useCode/useVariantSelection.js

@@ -0,0 +1,84 @@
+import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
+import _toConsumableArray from "@babel/runtime/helpers/esm/toConsumableArray";
+import _typeof from "@babel/runtime/helpers/esm/typeof";
+import * as React from 'react';
+import useLocalStorageState from "../useLocalStorageState/index.js";
+/**
+ * Hook for managing variant selection and providing variant-related data
+ * Uses the useLocalStorage hook for local storage persistence of variant preferences
+ */
+export function useVariantSelection(_ref) {
+  var effectiveCode = _ref.effectiveCode,
+    initialVariant = _ref.initialVariant;
+  // Get variant keys from effective code
+  var variantKeys = React.useMemo(function () {
+    return Object.keys(effectiveCode).filter(function (key) {
+      var variant = effectiveCode[key];
+      return variant && _typeof(variant) === 'object' && 'source' in variant;
+    });
+  }, [effectiveCode]);
+
+  // Generate storage key from sorted variant keys (only for multiple variants)
+  var storageKey = React.useMemo(function () {
+    if (variantKeys.length <= 1) {
+      return null; // Don't use localStorage for single variants - no choice to remember
+    }
+    var sortedKeys = _toConsumableArray(variantKeys).sort();
+    return "_docs_infra_variant_prefs_".concat(sortedKeys.join(':'));
+  }, [variantKeys]);
+
+  // Use localStorage hook for variant persistence - this is our single source of truth
+  var _useLocalStorageState = useLocalStorageState(storageKey, function () {
+      // Don't use initialVariant as the fallback - localStorage should take precedence
+      // We'll handle the initial variant separately in the selectedVariantKey logic
+      return null;
+    }),
+    _useLocalStorageState2 = _slicedToArray(_useLocalStorageState, 2),
+    storedValue = _useLocalStorageState2[0],
+    setStoredValue = _useLocalStorageState2[1];
+
+  // Handle validation manually - localStorage should take precedence over initialVariant
+  var selectedVariantKey = React.useMemo(function () {
+    // First priority: use stored value if it exists and is valid
+    if (storedValue && variantKeys.includes(storedValue)) {
+      return storedValue;
+    }
+
+    // Second priority: use initial variant if provided and valid (only when no localStorage value)
+    if (initialVariant && variantKeys.includes(initialVariant)) {
+      return initialVariant;
+    }
+
+    // Final fallback: use first available variant
+    return variantKeys[0] || '';
+  }, [storedValue, variantKeys, initialVariant]);
+  var setSelectedVariantKey = React.useCallback(function (value) {
+    setStoredValue(value);
+  }, [setStoredValue]);
+  var setSelectedVariantKeyAsUser = React.useCallback(function (value) {
+    var resolvedValue = typeof value === 'function' ? value(selectedVariantKey) : value;
+    setStoredValue(resolvedValue);
+  }, [setStoredValue, selectedVariantKey]);
+  var selectedVariant = React.useMemo(function () {
+    var variant = effectiveCode[selectedVariantKey];
+    if (variant && _typeof(variant) === 'object' && 'source' in variant) {
+      return variant;
+    }
+    return null;
+  }, [effectiveCode, selectedVariantKey]);
+
+  // Safety check: if selectedVariant doesn't exist, fall back to first variant
+  React.useEffect(function () {
+    if (!selectedVariant && variantKeys.length > 0) {
+      // Don't mark this as a user selection - it's just a fallback
+      // Use setValue instead of setValueAsUserSelection to avoid localStorage save
+      setSelectedVariantKey(variantKeys[0]);
+    }
+  }, [selectedVariant, variantKeys, setSelectedVariantKey]);
+  return {
+    variantKeys: variantKeys,
+    selectedVariantKey: selectedVariantKey,
+    selectedVariant: selectedVariant,
+    selectVariant: setSelectedVariantKeyAsUser
+  };
+}

package/useCopier/index.d.ts

@@ -10,6 +10,6 @@ export type UseCopierOpts = {
 };
 export declare function useCopier(contents: (() => string | undefined) | string, opts?: UseCopierOpts): {
   copy: (event: React.MouseEvent<HTMLButtonElement>) => Promise<void>;
-  disabled: boolean;
+  recentlySuccessful: boolean;
 };
 export {};

package/useCopier/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/useCopier/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAC3B,KAAK,WAAW,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAC5C,KAAK,WAAW,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;AACxE,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa;kBAO3E,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC;;EA0BpD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/useCopier/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAC3B,KAAK,WAAW,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAC5C,KAAK,WAAW,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;AACxE,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa;kBAO3E,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC;;EA0BpD"}

package/useCopier/index.js

@@ -13,8 +13,8 @@ export function useCopier(contents, opts) {
   var copyTimeoutRef = React.useRef(undefined);
   var _React$useState = React.useState(false),
     _React$useState2 = _slicedToArray(_React$useState, 2),
-    disabled = _React$useState2[0],
-    setDisabled = _React$useState2[1];
+    recentlySuccessful = _React$useState2[0],
+    setRecentlySuccessful = _React$useState2[1];
   var copy = React.useCallback(/*#__PURE__*/function () {
     var _ref2 = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee(event) {
       var content;
@@ -22,7 +22,7 @@ export function useCopier(contents, opts) {
         while (1) switch (_context.prev = _context.next) {
           case 0:
             clearTimeout(copyTimeoutRef.current);
-            setDisabled(true);
+            setRecentlySuccessful(false);
             _context.prev = 2;
             content = typeof contents === 'function' ? contents() : contents;
             if (!content) {
@@ -43,7 +43,7 @@ export function useCopier(contents, opts) {
             onClick == null || onClick(event);
             copyTimeoutRef.current = setTimeout(function () {
               clearTimeout(copyTimeoutRef.current);
-              setDisabled(false);
+              setRecentlySuccessful(false);
             }, timeout);
           case 15:
           case "end":
@@ -57,6 +57,6 @@ export function useCopier(contents, opts) {
   }(), [contents, timeout, onCopied, onError, onClick]);
   return {
     copy: copy,
-    disabled: disabled
+    recentlySuccessful: recentlySuccessful
   };
 }

package/useDemo/createCodeSandbox.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Utility function for creating CodeSandbox demos
+ * Returns the configuration that can be used with openWithForm
+ */
+import type { FlattenedFiles } from "./flattenVariant.js";
+/**
+ * Create CodeSandbox for use with openWithForm
+ */
+export declare function createCodeSandbox({
+  flattenedFiles,
+  rootFile
+}: {
+  flattenedFiles: FlattenedFiles;
+  rootFile: string;
+}): {
+  url: string;
+  formData: Record<string, string>;
+};

package/useDemo/createCodeSandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCodeSandbox.d.ts","sourceRoot":"","sources":["../../src/useDemo/createCodeSandbox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAYvD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,cAAc,EACd,QAAQ,GACT,EAAE;IACD,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG;IACF,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAsBA"}

package/useDemo/createCodeSandbox.js

@@ -0,0 +1,48 @@
+import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
+/**
+ * Utility function for creating CodeSandbox demos
+ * Returns the configuration that can be used with openWithForm
+ */
+
+// @ts-ignore
+import LZString from 'lz-string';
+/**
+ * Compress object for CodeSandbox API
+ */
+function compress(object) {
+  return LZString.compressToBase64(JSON.stringify(object)).replace(/\+/g, '-') // Convert '+' to '-'
+  .replace(/\//g, '_') // Convert '/' to '_'
+  .replace(/=+$/, ''); // Remove ending '='
+}
+
+/**
+ * Create CodeSandbox for use with openWithForm
+ */
+export function createCodeSandbox(_ref) {
+  var flattenedFiles = _ref.flattenedFiles,
+    rootFile = _ref.rootFile;
+  // Convert flattened files to string format
+  var files = {};
+  Object.entries(flattenedFiles).forEach(function (_ref2) {
+    var _ref3 = _slicedToArray(_ref2, 2),
+      filePath = _ref3[0],
+      fileData = _ref3[1];
+    files[filePath] = {
+      content: fileData.source
+    };
+  });
+  var parameters = compress({
+    files: files
+  });
+
+  // ref: https://codesandbox.io/docs/api/#define-api
+  var formData = {
+    parameters: parameters,
+    embed: '1',
+    query: "module=/".concat(rootFile, "&fontsize=12")
+  };
+  return {
+    url: 'https://codesandbox.io/api/v1/sandboxes/define',
+    formData: formData
+  };
+}

package/useDemo/createStackBlitz.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Utility function for creating StackBlitz demos
+ * Returns the configuration that can be used with openWithForm
+ */
+import type { FlattenedFiles } from "./flattenVariant.js";
+/**
+ * Create StackBlitz configuration for use with openWithForm
+ */
+export declare function createStackBlitz({
+  title,
+  description,
+  flattenedFiles,
+  rootFile
+}: {
+  title: string;
+  description: string;
+  flattenedFiles: FlattenedFiles;
+  rootFile: string;
+}): {
+  url: string;
+  formData: Record<string, string>;
+};

package/useDemo/createStackBlitz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStackBlitz.d.ts","sourceRoot":"","sources":["../../src/useDemo/createStackBlitz.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,WAAW,EACX,cAAc,EACd,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG;IACF,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAqBA"}

package/useDemo/createStackBlitz.js

@@ -0,0 +1,38 @@
+import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
+/**
+ * Utility function for creating StackBlitz demos
+ * Returns the configuration that can be used with openWithForm
+ */
+
+/**
+ * Create StackBlitz configuration for use with openWithForm
+ */
+export function createStackBlitz(_ref) {
+  var title = _ref.title,
+    description = _ref.description,
+    flattenedFiles = _ref.flattenedFiles,
+    rootFile = _ref.rootFile;
+  // Convert flattened files to string format
+  var files = {};
+  Object.entries(flattenedFiles).forEach(function (_ref2) {
+    var _ref3 = _slicedToArray(_ref2, 2),
+      filePath = _ref3[0],
+      fileData = _ref3[1];
+    files[filePath] = fileData.source;
+  });
+  var formData = {
+    'project[template]': 'node',
+    'project[title]': title,
+    'project[description]': "# ".concat(title, "\n").concat(description)
+  };
+  Object.entries(files).forEach(function (_ref4) {
+    var _ref5 = _slicedToArray(_ref4, 2),
+      key = _ref5[0],
+      value = _ref5[1];
+    formData["project[files][".concat(key, "]")] = value;
+  });
+  return {
+    url: "https://stackblitz.com/run?file=".concat(rootFile),
+    formData: formData
+  };
+}

package/useDemo/examineVariant.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Variant examination utility for analyzing variant structure and paths
+ */
+import type { VariantCode } from "../CodeHighlighter/types.js";
+interface PathContextBase {
+  hasMetadata: boolean;
+  maxBackNavigation: number;
+  urlDirectory: string[];
+  rootLevel: string;
+  pathInwardFromRoot: string;
+}
+interface PathContextWithUrl extends PathContextBase {
+  hasUrl: true;
+  actualUrl: string;
+}
+interface PathContextWithoutUrl extends PathContextBase {
+  hasUrl: false;
+  actualUrl?: undefined;
+}
+export type PathContext = PathContextWithUrl | PathContextWithoutUrl;
+/**
+ * Create path context for processing files with extended information
+ */
+export declare function createPathContext(variant: VariantCode): PathContext;
+export {};

package/useDemo/examineVariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examineVariant.d.ts","sourceRoot":"","sources":["../../src/useDemo/examineVariant.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,UAAU,eAAe;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,UAAU,kBAAmB,SAAQ,eAAe;IAClD,MAAM,EAAE,IAAI,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,qBAAsB,SAAQ,eAAe;IACrD,MAAM,EAAE,KAAK,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,qBAAqB,CAAC;AA8FrE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CA0CnE"}

package/useDemo/examineVariant.js

@@ -0,0 +1,134 @@
+import _typeof from "@babel/runtime/helpers/esm/typeof";
+import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
+/**
+ * Variant examination utility for analyzing variant structure and paths
+ */
+
+/**
+ * Extract directory segments from URL pathname
+ */
+function getDirectoryFromUrl(url) {
+  var urlObj = new URL(url);
+  var segments = urlObj.pathname.split('/').filter(Boolean);
+  segments.pop(); // Remove filename
+  return segments;
+}
+
+/**
+ * Calculate the maximum back navigation level from extra files
+ */
+function calculateMaxBackNavigation(extraFiles) {
+  var maxBackNavigation = 0;
+  for (var _i = 0, _Object$entries = Object.entries(extraFiles); _i < _Object$entries.length; _i++) {
+    var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
+      relativePath = _Object$entries$_i[0],
+      fileContent = _Object$entries$_i[1];
+    if (relativePath.startsWith('.')) {
+      var backCount = (relativePath.match(/\.\.\//g) || []).length;
+
+      // For metadata files, subtract 1 from their back navigation count
+      var file = typeof fileContent === 'string' ? {
+        source: fileContent
+      } : fileContent;
+      var adjustedBackCount = file.metadata ? Math.max(0, backCount - 1) : backCount;
+      maxBackNavigation = Math.max(maxBackNavigation, adjustedBackCount);
+    }
+  }
+  return maxBackNavigation;
+}
+
+/**
+ * Generate a synthetic path using alphabetic progression (a/b/c/d/e/...)
+ */
+function generateSyntheticPath(levels) {
+  if (levels <= 0) {
+    return '';
+  }
+  var parts = [];
+  for (var i = 0; i < levels; i += 1) {
+    var charCode = 97 + i % 26; // 97 is 'a', cycles through a-z
+    parts.push(String.fromCharCode(charCode));
+  }
+  return parts.join('/') + (levels > 0 ? '/' : '');
+}
+
+/**
+ * Calculate root level path based on URL and max back navigation
+ */
+function calculateRootLevel(url, maxBackNavigation) {
+  if (!url || maxBackNavigation === 0) {
+    return '';
+  }
+  var pathSegments = getDirectoryFromUrl(url);
+
+  // Go back by maxBackNavigation levels
+  for (var i = 0; i < maxBackNavigation; i += 1) {
+    pathSegments.pop();
+  }
+  var rootLevel = pathSegments.join('/');
+  return rootLevel && !rootLevel.endsWith('/') ? "".concat(rootLevel, "/") : rootLevel;
+}
+
+/**
+ * Calculate the path inward from the root to the variant location
+ */
+function calculatePathInwardFromRoot(url, maxBackNavigation) {
+  if (!url || maxBackNavigation === 0) {
+    return '';
+  }
+  var pathSegments = getDirectoryFromUrl(url);
+
+  // The path inward is the segments that remain after going back by maxBackNavigation
+  // but we want the path from root to the variant location, not to the parent directory
+  var variantDepthFromRoot = pathSegments.length - maxBackNavigation;
+  if (variantDepthFromRoot <= 0) {
+    return '';
+  }
+
+  // Get segments starting from the root level up to (but not including) the current directory
+  var rootSegments = pathSegments.slice(0, pathSegments.length - maxBackNavigation);
+  var variantSegments = pathSegments.slice(rootSegments.length);
+  return variantSegments.length > 0 ? "".concat(variantSegments.join('/'), "/") : '';
+}
+
+/**
+ * Create path context for processing files with extended information
+ */
+export function createPathContext(variant) {
+  var hasUrl = Boolean(variant.url);
+  var actualUrl = variant.url;
+  var hasMetadata = variant.extraFiles ? Object.values(variant.extraFiles).some(function (file) {
+    return _typeof(file) === 'object' && file.metadata;
+  }) : false;
+  var maxBackNavigation = variant.extraFiles ? calculateMaxBackNavigation(variant.extraFiles) : 0;
+
+  // If no URL but we have back navigation, create a synthetic URL
+  if (!hasUrl && maxBackNavigation > 0 && variant.fileName) {
+    var syntheticPath = generateSyntheticPath(maxBackNavigation);
+    actualUrl = "file:///".concat(syntheticPath).concat(variant.fileName);
+    hasUrl = true;
+  }
+  var urlDirectory = hasUrl && actualUrl ? getDirectoryFromUrl(actualUrl) : [];
+  var rootLevel = calculateRootLevel(actualUrl, maxBackNavigation);
+  var pathInwardFromRoot = calculatePathInwardFromRoot(actualUrl, maxBackNavigation);
+  if (hasUrl && actualUrl) {
+    return {
+      hasUrl: true,
+      hasMetadata: hasMetadata,
+      maxBackNavigation: maxBackNavigation,
+      urlDirectory: urlDirectory,
+      rootLevel: rootLevel,
+      pathInwardFromRoot: pathInwardFromRoot,
+      actualUrl: actualUrl
+    };
+  }
+  return {
+    hasUrl: false,
+    hasMetadata: hasMetadata,
+    maxBackNavigation: maxBackNavigation,
+    urlDirectory: urlDirectory,
+    rootLevel: rootLevel,
+    pathInwardFromRoot: pathInwardFromRoot,
+    actualUrl: undefined
+  };
+}

package/useDemo/exportVariant.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Export variant functionality to add extra files like package.json, tsconfig, etc.
+ * Users can pass configuration options that vary the output here.
+ */
+import type { VariantCode } from "../CodeHighlighter/types.js";
+/**
+ * Extract filename from URL or return undefined if not available
+ */
+export declare function getFilenameFromVariant(variantCode: VariantCode): string | undefined;
+/**
+ * Generate a unique entrypoint filename that doesn't conflict with existing files
+ */
+export declare function generateEntrypointFilename(existingFiles: Record<string, any>, sourceFilename: string | undefined, useTypescript: boolean, pathPrefix?: string): string;
+/**
+ * Generate the relative import path from entrypoint to source file
+ */
+export declare function getRelativeImportPath(sourceFilename: string | undefined): string;
+/**
+ * Default HTML template function for Vite-based demos
+ */
+export declare function defaultHtmlTemplate({
+  language,
+  title,
+  description,
+  head,
+  entrypoint
+}: {
+  language: string;
+  title: string;
+  description: string;
+  head?: string;
+  entrypoint: string;
+}): string;
+export interface ExportConfig {
+  /** The title for the demo (used in HTML title and package.json name) */
+  title?: string;
+  /** Description for package.json */
+  description?: string;
+  /**
+   * Prefix for output file paths (e.g., 'public/' for CRA, '' for Vite)
+   * @example
+   * htmlPrefix: 'public/' // outputs index.html to correct depth + public/index.html
+   */
+  htmlPrefix?: string;
+  /**
+   * Whether the framework handles entrypoint and HTML generation (e.g., CRA with webpack)
+   * When true, skips generating index.html and entrypoint files
+   */
+  frameworkHandlesEntrypoint?: boolean;
+  /**
+   * Custom HTML template function
+   * @example
+   * htmlTemplate: ({ language, title, description, head, entrypoint }) =>
+   *   `<!doctype html><html><head><title>${title}</title>${head || ''}</head><body><div id="root"></div><script src="${entrypoint}"></script></body></html>`
+   */
+  htmlTemplate?: (params: {
+    language: string;
+    title: string;
+    description: string;
+    head?: string;
+    entrypoint: string;
+  }) => string;
+  /**
+   * Custom head template function for generating additional head content
+   * @example
+   * headTemplate: ({ sourcePrefix, assetPrefix }) =>
+   *   `<link rel="stylesheet" href="${assetPrefix}/styles.css" />\n<meta name="theme-color" content="#000000" />`
+   */
+  headTemplate?: (params: {
+    sourcePrefix: string;
+    assetPrefix: string;
+  }) => string;
+  /** Custom React root index template function */
+  rootIndexTemplate?: (params: {
+    importString: string;
+    useTypescript: boolean;
+  }) => string;
+  /** Extra package.json dependencies to add */
+  dependencies?: Record<string, string>;
+  /** Extra package.json devDependencies to add */
+  devDependencies?: Record<string, string>;
+  /** Extra package.json scripts to add */
+  scripts?: Record<string, string>;
+  /** Package type: 'module' for ESM, 'commonjs' for CJS, undefined to omit */
+  packageType?: 'module' | 'commonjs';
+  /** Custom package.json fields to merge */
+  packageJsonFields?: Record<string, any>;
+  /** Extra tsconfig.json options to merge */
+  tsconfigOptions?: Record<string, any>;
+  /** Whether to include TypeScript configuration files */
+  useTypescript?: boolean;
+  /** Custom metadata files to add */
+  extraMetadataFiles?: Record<string, {
+    source: string;
+    metadata?: boolean;
+  }>;
+  /** Framework-specific files that override default files (index.html, entrypoint, etc.) */
+  frameworkFiles?: Record<string, {
+    source: string;
+    metadata?: boolean;
+  }>;
+}
+/**
+ * Export a VariantCode with additional configuration files
+ * Returns an object with the exported VariantCode and rootPath path
+ */
+export declare function exportVariant(variantCode: VariantCode, config?: ExportConfig): {
+  exported: VariantCode;
+  rootFile: string;
+};

package/useDemo/exportVariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportVariant.d.ts","sourceRoot":"","sources":["../../src/useDemo/exportVariant.ts"],"names":[],"mappings":"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"}