npm - @mui/internal-docs-infra - Versions diffs - 0.1.1-alpha.13 → 0.1.1-alpha.14 - Mend

@mui/internal-docs-infra 0.1.1-alpha.13 → 0.1.1-alpha.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (25) hide show

package/CodeHighlighter/CodeHighlighterClient.d.ts.map +1 -1
package/CodeHighlighter/CodeHighlighterClient.js +45 -16
package/CodeHighlighter/addPathsToVariant.d.ts +18 -0
package/CodeHighlighter/addPathsToVariant.d.ts.map +1 -0
package/CodeHighlighter/addPathsToVariant.js +352 -0
package/{useDemo → CodeHighlighter}/examineVariant.d.ts +1 -1
package/CodeHighlighter/examineVariant.d.ts.map +1 -0
package/CodeHighlighter/examineVariant.js +103 -0
package/CodeHighlighter/mergeMetadata.d.ts +40 -0
package/CodeHighlighter/mergeMetadata.d.ts.map +1 -0
package/CodeHighlighter/mergeMetadata.js +189 -0
package/CodeHighlighter/types.d.ts +3 -0
package/CodeHighlighter/types.d.ts.map +1 -1
package/package.json +1 -1
package/useDemo/exportVariant.d.ts +49 -11
package/useDemo/exportVariant.d.ts.map +1 -1
package/useDemo/exportVariant.js +170 -94
package/useDemo/flattenVariant.d.ts +2 -0
package/useDemo/flattenVariant.d.ts.map +1 -1
package/useDemo/flattenVariant.js +19 -178
package/useDemo/useDemo.d.ts +7 -0
package/useDemo/useDemo.d.ts.map +1 -1
package/useDemo/useDemo.js +37 -18
package/useDemo/examineVariant.d.ts.map +0 -1
package/useDemo/examineVariant.js +0 -134

package/useDemo/exportVariant.js CHANGED Viewed

@@ -1,5 +1,5 @@
-import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
 import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
+import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
 /**
  * Export variant functionality to add extra files like package.json, tsconfig, etc.
  * Users can pass configuration options that vary the output here.
@@ -7,7 +7,37 @@ import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
 import { externalsToPackages } from "../pipeline/loaderUtils/index.js";
 import { getFileNameFromUrl } from "../pipeline/loaderUtils/getFileNameFromUrl.js";
-import { createPathContext } from "./examineVariant.js";
+import { createPathContext } from "../CodeHighlighter/examineVariant.js";
+import { mergeMetadata, extractMetadata } from "../CodeHighlighter/mergeMetadata.js";
+/**
+ * Merges multiple file objects into a single object.
+ * Similar to mergeExternals but for file structures.
+ * Automatically adds metadata: false to files that don't have a metadata property.
+ */
+function mergeFiles() {
+  var merged = {};
+  for (var _len = arguments.length, fileSets = new Array(_len), _key = 0; _key < _len; _key++) {
+    fileSets[_key] = arguments[_key];
+  }
+  for (var _i = 0, _fileSets = fileSets; _i < _fileSets.length; _i++) {
+    var fileSet = _fileSets[_i];
+    for (var _i2 = 0, _Object$entries = Object.entries(fileSet); _i2 < _Object$entries.length; _i2++) {
+      var _Object$entries$_i = _slicedToArray(_Object$entries[_i2], 2),
+        fileName = _Object$entries$_i[0],
+        fileData = _Object$entries$_i[1];
+      // Later files override earlier ones (similar to Object.assign behavior)
+      var normalizedData = typeof fileData === 'string' ? {
+        source: fileData
+      } : _objectSpread({}, fileData);
+      // Add metadata: false if not already set (source files default to false)
+      if (!('metadata' in normalizedData)) {
+        normalizedData.metadata = false;
+      }
+      merged[fileName] = normalizedData;
+    }
+  }
+  return merged;
+}
 /**
  * Extract filename from URL or return undefined if not available
@@ -30,15 +60,15 @@ export function getFilenameFromVariant(variantCode) {
 export function generateEntrypointFilename(existingFiles, sourceFilename, useTypescript) {
   var pathPrefix = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : '';
   var ext = useTypescript ? 'tsx' : 'jsx';
-  var candidates = ["".concat(pathPrefix, "index.").concat(ext), "".concat(pathPrefix, "entrypoint.").concat(ext), "".concat(pathPrefix, "main.").concat(ext)];
+  var candidates = ["".concat(pathPrefix, "App.").concat(ext), "".concat(pathPrefix, "entrypoint.").concat(ext), "".concat(pathPrefix, "main.").concat(ext)];
   // If we have a source filename, also try variations
   if (sourceFilename) {
     var baseName = sourceFilename.replace(/\.[^.]*$/, '');
     candidates.push("".concat(pathPrefix).concat(baseName, "-entry.").concat(ext));
   }
-  for (var _i = 0, _candidates = candidates; _i < _candidates.length; _i++) {
-    var candidate = _candidates[_i];
+  for (var _i3 = 0, _candidates = candidates; _i3 < _candidates.length; _i3++) {
+    var candidate = _candidates[_i3];
     if (candidate !== "".concat(pathPrefix).concat(sourceFilename) && !existingFiles[candidate]) {
       return candidate;
     }
@@ -74,17 +104,24 @@ export function defaultHtmlTemplate(_ref) {
   return "<!doctype html>\n<html lang=\"".concat(language, "\">\n  <head>\n    <meta charset=\"UTF-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n    <title>").concat(title, "</title>\n    <meta name=\"description\" content=\"").concat(description, "\" />").concat(head ? "\n    ".concat(head) : '', "\n  </head>\n  <body>\n    <div id=\"root\"></div>").concat(entrypoint ? "\n    <script type=\"module\" src=\"".concat(entrypoint, "\"></script>") : '', "\n  </body>\n</html>");
 }
 /**
- * Export a VariantCode with additional configuration files
- * Returns an object with the exported VariantCode and rootPath path
+ * Export a variant as a standalone project with metadata files properly scoped
  */
 export function exportVariant(variantCode) {
+  var _frameworkFiles$varia;
   var config = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
   var _config$title = config.title,
     title = _config$title === void 0 ? 'Demo' : _config$title,
     _config$description = config.description,
     description = _config$description === void 0 ? 'Demo created with Vite' : _config$description,
+    variantName = config.variantName,
+    _config$language = config.language,
+    language = _config$language === void 0 ? 'en' : _config$language,
     _config$htmlPrefix = config.htmlPrefix,
     htmlPrefix = _config$htmlPrefix === void 0 ? '' : _config$htmlPrefix,
+    _config$sourcePrefix = config.sourcePrefix,
+    sourcePrefix = _config$sourcePrefix === void 0 ? 'src/' : _config$sourcePrefix,
+    _config$assetPrefix = config.assetPrefix,
+    assetPrefix = _config$assetPrefix === void 0 ? '' : _config$assetPrefix,
     _config$frameworkHand = config.frameworkHandlesEntrypoint,
     frameworkHandlesEntrypoint = _config$frameworkHand === void 0 ? false : _config$frameworkHand,
     htmlTemplate = config.htmlTemplate,
@@ -106,7 +143,23 @@ export function exportVariant(variantCode) {
     _config$extraMetadata = config.extraMetadataFiles,
     extraMetadataFiles = _config$extraMetadata === void 0 ? {} : _config$extraMetadata,
     _config$frameworkFile = config.frameworkFiles,
-    frameworkFiles = _config$frameworkFile === void 0 ? {} : _config$frameworkFile;
+    frameworkFiles = _config$frameworkFile === void 0 ? {} : _config$frameworkFile,
+    transformVariant = config.transformVariant;
+  // Use extractMetadata to properly separate metadata and non-metadata files
+  var _extractMetadata = extractMetadata(variantCode),
+    processedVariantCode = _extractMetadata.variant,
+    processedGlobals = _extractMetadata.metadata;
+  if (transformVariant) {
+    var transformed = transformVariant(processedVariantCode, variantName, processedGlobals);
+    if (transformed) {
+      // Re-extract metadata after transformation
+      var result = extractMetadata(transformed.variant || variantCode);
+      processedVariantCode = result.variant;
+      // Combine metadata from extraction with transformed globals
+      processedGlobals = _objectSpread(_objectSpread({}, result.metadata), transformed.globals);
+    }
+  }
   // If packageType is explicitly provided (even as undefined), use that value
   var finalPackageType;
@@ -117,50 +170,70 @@ export function exportVariant(variantCode) {
   }
   // Get existing extraFiles and source filename
-  var existingExtraFiles = variantCode.extraFiles || {};
-  var sourceFilename = getFilenameFromVariant(variantCode);
+  var sourceFilename = getFilenameFromVariant(processedVariantCode);
-  // Get path context to calculate proper URLs
-  var pathContext = createPathContext(variantCode);
+  // Get path context to understand navigation
+  var pathContext = createPathContext(variantCode); // Determine if we need to rename the source file (if it's index.tsx in src dir)
-  // Calculate the correct prefix for metadata files based on path depth
-  var metadataPrefix = '../'.repeat(pathContext.maxBackNavigation + 1);
+  var ext = useTypescript ? 'tsx' : 'jsx';
+  var isSourceFileIndex = sourceFilename === "index.".concat(ext);
+  // Use urlDirectory to determine if it's in src root (should only have 'src' as the directory)
+  var isInSrcRoot = pathContext.urlDirectory.length <= 1;
+  var actualSourceFilename = sourceFilename;
+  // Use urlDirectory to construct the full path from src root
+  var directoryPath = pathContext.urlDirectory.slice(1).join('/'); // Remove 'src' and join the rest
+  var actualRootFile = directoryPath ? "".concat(sourcePrefix).concat(directoryPath, "/").concat(sourceFilename) : "".concat(sourcePrefix).concat(sourceFilename);
-  // Generate unique entrypoint filename
-  var entrypointFilename = generateEntrypointFilename(existingExtraFiles, sourceFilename, useTypescript);
+  // If the source file is index.tsx and it's in the src root, we need to rename it
+  if (isSourceFileIndex && isInSrcRoot) {
+    actualSourceFilename = generateEntrypointFilename(processedVariantCode.extraFiles || {}, sourceFilename, useTypescript);
+    actualRootFile = "".concat(sourcePrefix).concat(actualSourceFilename);
+  }
-  // Calculate the entrypoint URL relative to the root
-  var entrypoint = "/src/".concat(pathContext.pathInwardFromRoot).concat(entrypointFilename);
+  // The main entrypoint is always src/index.tsx (or .jsx)
+  var mainEntrypointFilename = "index.".concat(ext);
+  var entrypoint = "".concat(sourcePrefix).concat(mainEntrypointFilename);
   // Get relative import path for the main component
-  var rootFile = "src/".concat(pathContext.pathInwardFromRoot).concat(sourceFilename);
-  var importPath = getRelativeImportPath(sourceFilename);
-  var importString = variantCode.namedExport ? "import { ".concat(variantCode.namedExport, " as App } from '").concat(importPath, "';") : "import App from '".concat(importPath, "';");
-  // Create new extraFiles object
-  var newExtraFiles = _objectSpread({}, existingExtraFiles);
-  // Add framework-specific files (if any)
-  for (var _i2 = 0, _Object$entries = Object.entries(frameworkFiles); _i2 < _Object$entries.length; _i2++) {
-    var _fileData$metadata;
-    var _Object$entries$_i = _slicedToArray(_Object$entries[_i2], 2),
-      fileName = _Object$entries$_i[0],
-      fileData = _Object$entries$_i[1];
-    newExtraFiles[fileName] = {
-      source: fileData.source,
-      metadata: (_fileData$metadata = fileData.metadata) != null ? _fileData$metadata : true
-    };
+  var importPath;
+  if (isInSrcRoot) {
+    // Component is in src root - import directly
+    importPath = getRelativeImportPath(actualSourceFilename);
+  } else {
+    // Component is in a subdirectory - import with full path from src root
+    // Use urlDirectory excluding the root level to get the full directory path
+    var _directoryPath = pathContext.urlDirectory.slice(1).join('/'); // Remove 'src' and join the rest
+    var componentPath = _directoryPath ? "".concat(_directoryPath, "/").concat(actualSourceFilename) : actualSourceFilename;
+    importPath = "./".concat((componentPath || '').replace(/\.[^.]*$/, '')); // Remove extension
+  }
+  // Strip /index from the end of import paths since module resolution handles it automatically
+  if (importPath.endsWith('/index')) {
+    importPath = importPath.slice(0, -6); // Remove '/index'
+  }
+  var importString = processedVariantCode.namedExport ? "import { ".concat(processedVariantCode.namedExport, " as App } from '").concat(importPath, "';") : "import App from '".concat(importPath, "';");
+  // Collect all files that will be generated
+  var generatedFiles = {};
+  // Update the variant's fileName if we renamed it
+  if (isSourceFileIndex && isInSrcRoot && actualSourceFilename && actualSourceFilename !== sourceFilename) {
+    processedVariantCode.fileName = actualSourceFilename;
   }
-  // Check if we're using a framework (has framework files)
-  var isFramework = frameworkFiles && Object.keys(frameworkFiles).length > 0;
-  var externalPackages = externalsToPackages(variantCode.externals || []);
+  // Check if they're providing their own framework
+  var isFramework = 'frameworkFiles' in config;
+  var externalPackages = externalsToPackages(processedVariantCode.externals || []);
   var variantDeps = Object.keys(externalPackages).reduce(function (acc, pkg) {
     acc[pkg] = 'latest';
     return acc;
   }, {});
-  // Generate package.json (always)
+  // Collect metadata files to be generated
+  var metadataFiles = {};
+  // Generate package.json
   var packageJson = _objectSpread(_objectSpread({
     "private": true,
     name: title.toLowerCase().replace(/[^a-z0-9]/g, '-'),
@@ -188,62 +261,35 @@ export function exportVariant(variantCode) {
       '@types/react-dom': 'latest'
     }), devDependencies)
   }, packageJsonFields);
-  newExtraFiles["".concat(metadataPrefix, "package.json")] = {
-    source: JSON.stringify(packageJson, null, 2),
-    metadata: true
+  metadataFiles['package.json'] = {
+    source: JSON.stringify(packageJson, null, 2)
   };
   // Generate entrypoint and HTML files unless framework handles them
   if (!frameworkHandlesEntrypoint) {
-    // Add index.html (with configurable prefix for different frameworks)
-    var headContent = headTemplate ? headTemplate({
-      sourcePrefix: '/src',
-      assetPrefix: ''
-    }) : undefined;
-    var htmlContent = htmlTemplate ? htmlTemplate({
-      language: 'en',
-      title: title,
-      description: description,
-      head: headContent,
-      entrypoint: entrypoint
-    }) : defaultHtmlTemplate({
-      language: 'en',
-      title: title,
-      description: description,
-      head: headContent,
-      entrypoint: entrypoint
-    });
-    var htmlFilePath = htmlPrefix ? "".concat(metadataPrefix).concat(htmlPrefix, "index.html") : "".concat(metadataPrefix, "index.html");
-    newExtraFiles[htmlFilePath] = {
-      source: htmlContent,
-      metadata: true
-    };
     // Create entrypoint file that imports the main component
     var defaultEntrypointContent = "import * as React from 'react';\nimport * as ReactDOM from 'react-dom/client';\n".concat(importString, "\n\nReactDOM.createRoot(document.getElementById('root')").concat(useTypescript ? '!' : '', ").render(\n  <React.StrictMode>\n    <App />\n  </React.StrictMode>\n);");
     var entrypointContent = rootIndexTemplate ? rootIndexTemplate({
       importString: importString,
       useTypescript: useTypescript
     }) : defaultEntrypointContent;
-    newExtraFiles[entrypointFilename] = {
-      source: entrypointContent,
-      metadata: false
+    generatedFiles[mainEntrypointFilename] = {
+      source: entrypointContent
     };
   }
   // Add Vite config file only if no framework files (Vite-specific)
   if (!isFramework) {
     var viteConfigContent = "import { defineConfig } from 'vite';\nimport react from '@vitejs/plugin-react';\nimport { externalsToPackages } from '../loaderUtils/externalsToPackages';\n\n// https://vitejs.dev/config/\nexport default defineConfig({\n  plugins: [react()],\n  define: { 'process.env': {} },\n});";
-    newExtraFiles["".concat(metadataPrefix, "vite.config.").concat(useTypescript ? 'ts' : 'js')] = {
-      source: viteConfigContent,
-      metadata: true
+    metadataFiles["vite.config.".concat(useTypescript ? 'ts' : 'js')] = {
+      source: viteConfigContent
     };
   }
-  // Add TypeScript configuration if requested (up one directory, metadata: true)
+  // Add TypeScript configuration if requested
   if (useTypescript) {
     // Check if frameworkFiles already includes a tsconfig
-    var hasFrameworkTsConfig = frameworkFiles && Object.keys(frameworkFiles).some(function (fileName) {
+    var hasFrameworkTsConfig = (frameworkFiles == null ? void 0 : frameworkFiles.globals) && Object.keys(frameworkFiles.globals).some(function (fileName) {
       return fileName.includes('tsconfig.json') && !fileName.includes('tsconfig.node.json');
     });
     if (!hasFrameworkTsConfig) {
@@ -272,9 +318,8 @@ export function exportVariant(variantCode) {
           path: './tsconfig.node.json'
         }]
       });
-      newExtraFiles["".concat(metadataPrefix, "tsconfig.json")] = {
-        source: JSON.stringify(defaultTsConfig, null, 2),
-        metadata: true
+      metadataFiles['tsconfig.json'] = {
+        source: JSON.stringify(defaultTsConfig, null, 2)
       };
     }
@@ -291,30 +336,61 @@ export function exportVariant(variantCode) {
         },
         include: ['vite.config.ts']
       };
-      newExtraFiles["".concat(metadataPrefix, "tsconfig.node.json")] = {
-        source: JSON.stringify(nodeTsConfig, null, 2),
-        metadata: true
+      metadataFiles['tsconfig.node.json'] = {
+        source: JSON.stringify(nodeTsConfig, null, 2)
       };
     }
   }
-  // Add custom metadata files (respect metadata flag)
-  for (var _i3 = 0, _Object$entries2 = Object.entries(extraMetadataFiles); _i3 < _Object$entries2.length; _i3++) {
-    var _fileData$metadata2;
-    var _Object$entries2$_i = _slicedToArray(_Object$entries2[_i3], 2),
-      _fileName = _Object$entries2$_i[0],
-      _fileData = _Object$entries2$_i[1];
-    newExtraFiles["".concat(metadataPrefix).concat(_fileName)] = {
-      source: _fileData.source,
-      metadata: (_fileData$metadata2 = _fileData.metadata) != null ? _fileData$metadata2 : true
+  // Generate HTML file after all files are ready
+  if (!frameworkHandlesEntrypoint) {
+    // Add index.html
+    var headContent = headTemplate ? headTemplate({
+      sourcePrefix: sourcePrefix,
+      assetPrefix: assetPrefix,
+      variant: processedVariantCode,
+      variantName: variantName
+    }) : undefined;
+    var htmlContent = htmlTemplate ? htmlTemplate({
+      language: language,
+      title: title,
+      description: description,
+      head: headContent,
+      entrypoint: entrypoint,
+      variant: processedVariantCode,
+      variantName: variantName
+    }) : defaultHtmlTemplate({
+      language: language,
+      title: title,
+      description: description,
+      head: headContent,
+      entrypoint: entrypoint
+    });
+    var htmlFileName = htmlPrefix ? "".concat(htmlPrefix, "index.html") : 'index.html';
+    metadataFiles[htmlFileName] = {
+      source: htmlContent
     };
   }
-  // Return new VariantCode with updated extraFiles
+  // Merge all metadata files including framework metadata and globals
+  var allMetadataFiles = mergeFiles(processedGlobals || {}, metadataFiles, extraMetadataFiles, frameworkFiles.globals || {});
+  // Merge all files using mergeMetadata to properly position everything with 'src/' (sourcePrefix opt) prefix
+  var allSourceFilesWithFramework = mergeFiles(processedVariantCode.extraFiles || {}, generatedFiles, ((_frameworkFiles$varia = frameworkFiles.variant) == null ? void 0 : _frameworkFiles$varia.extraFiles) || {});
+  // Update the variant with all source files including framework source files
+  var finalVariantWithSources = _objectSpread(_objectSpread({}, processedVariantCode), {}, {
+    extraFiles: allSourceFilesWithFramework
+  });
+  // Use mergeMetadata to position everything correctly
+  var finalVariant = mergeMetadata(finalVariantWithSources, allMetadataFiles, {
+    metadataPrefix: sourcePrefix
+  });
+  // Return new VariantCode with properly positioned files
   return {
-    exported: _objectSpread(_objectSpread({}, variantCode), {}, {
-      extraFiles: newExtraFiles
-    }),
-    rootFile: rootFile
+    exported: finalVariant,
+    rootFile: actualRootFile
   };
 }

package/useDemo/flattenVariant.d.ts CHANGED Viewed

@@ -1,6 +1,7 @@
 /**
  * Flatten variant utility to convert a VariantCode into a flat files list
  * Handles relative path resolution and metadata file scoping
+ * Uses addPathsToVariant for the core logic, then flattens the result
  */
 import type { VariantCode } from "../CodeHighlighter/types.js";
 export interface FlatFile {
@@ -13,5 +14,6 @@ export interface FlattenedFiles {
 /**
  * Flatten a VariantCode into a flat files structure
  * Resolves relative paths and handles metadata file scoping
+ * Uses addPathsToVariant for path resolution logic
  */
 export declare function flattenVariant(variant: VariantCode): FlattenedFiles;

package/useDemo/flattenVariant.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"flattenVariant.d.ts","sourceRoot":"","sources":["../../src/useDemo/flattenVariant.ts"],"names":[],"mappings":"AAAA~~;;;GAGG~~;AAEH,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,0BAA0B,CAAC;~~AAK3E~~,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC9B;~~AAiLD;;;GAGG~~;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,~~CA+BnE~~"}
1	+ {"version":3,"file":"flattenVariant.d.ts","sourceRoot":"","sources":["../../src/useDemo/flattenVariant.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,0BAA0B,CAAC;AAI3E,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CA6BnE"}

package/useDemo/flattenVariant.js CHANGED Viewed

@@ -1,204 +1,45 @@
 import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
 import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
-import _createForOfIteratorHelper from "@babel/runtime/helpers/esm/createForOfIteratorHelper";
 /**
  * Flatten variant utility to convert a VariantCode into a flat files list
  * Handles relative path resolution and metadata file scoping
+ * Uses addPathsToVariant for the core logic, then flattens the result
  */
 import { stringOrHastToString } from "../pipeline/hastUtils/index.js";
-import { getFileNameFromUrl } from "../pipeline/loaderUtils/getFileNameFromUrl.js";
-import { createPathContext } from "./examineVariant.js";
-/**
- * Resolve a relative path from a base URL to get the target directory structure
- */
-function resolveRelativePath(baseUrl, relativePath) {
-  var url = new URL(baseUrl);
-  var pathSegments = url.pathname.split('/').filter(Boolean);
-  pathSegments.pop(); // Remove filename to get directory
-  var relativeSegments = relativePath.split('/');
-  var _iterator = _createForOfIteratorHelper(relativeSegments),
-    _step;
-  try {
-    for (_iterator.s(); !(_step = _iterator.n()).done;) {
-      var segment = _step.value;
-      if (segment === '..') {
-        pathSegments.pop();
-      } else if (segment !== '.' && segment !== '') {
-        pathSegments.push(segment);
-      }
-    }
-  } catch (err) {
-    _iterator.e(err);
-  } finally {
-    _iterator.f();
-  }
-  return pathSegments.join('/');
-}
-/**
- * Process the main file and determine its final path
- */
-function processMainFile(variant, context) {
-  var effectiveFileName = variant.fileName;
-  // If fileName is missing but we have a URL, derive it from the URL
-  if (!effectiveFileName && context.hasUrl) {
-    var _getFileNameFromUrl = getFileNameFromUrl(context.actualUrl),
-      fileName = _getFileNameFromUrl.fileName;
-    effectiveFileName = fileName;
-  }
-  if (!effectiveFileName || variant.source === undefined) {
-    return null;
-  }
-  var mainFilePath;
-  if (context.hasUrl && context.maxBackNavigation > 0) {
-    // URL with back navigation - calculate relative path from root level
-    // TypeScript knows context.actualUrl is defined when context.hasUrl is true
-    var urlObj = new URL(context.actualUrl);
-    var fullPath = urlObj.pathname.substring(1); // Remove leading slash
-    var relativePath = context.rootLevel ? fullPath.substring(context.rootLevel.length) : fullPath;
-    mainFilePath = relativePath.replace(/\/[^/]+$/, "/".concat(effectiveFileName));
-  } else if (context.hasUrl && variant.extraFiles && Object.keys(variant.extraFiles).length > 0) {
-    // URL with extra files but no back navigation
-    if (context.hasMetadata) {
-      // For metadata cases, preserve the full directory structure
-      mainFilePath = context.urlDirectory.length > 0 ? "".concat(context.urlDirectory.join('/'), "/").concat(effectiveFileName) : effectiveFileName;
-    } else {
-      // Check if all extra files are current directory references
-      var allCurrentDir = Object.keys(variant.extraFiles).every(function (path) {
-        return path.startsWith('./') || !path.startsWith('../') && !path.startsWith('.');
-      });
-      if (allCurrentDir) {
-        // For current directory references without metadata, flatten to root
-        mainFilePath = effectiveFileName;
-      } else {
-        // Use just the immediate parent directory
-        var lastSegment = context.urlDirectory[context.urlDirectory.length - 1];
-        mainFilePath = lastSegment ? "".concat(lastSegment, "/").concat(effectiveFileName) : effectiveFileName;
-      }
-    }
-  } else {
-    // Simple case - just use the filename
-    mainFilePath = effectiveFileName;
-  }
-  // Add src/ prefix if we have metadata
-  if (context.hasMetadata) {
-    // When there are metadata files, simplify the main file path
-    if (context.hasUrl && !context.maxBackNavigation) {
-      // No back navigation - just use the filename
-      mainFilePath = effectiveFileName;
-    }
-    mainFilePath = "src/".concat(mainFilePath);
-  }
-  return {
-    path: mainFilePath,
-    hasDirectory: mainFilePath.includes('/')
-  };
-}
-/**
- * Process metadata files to determine their final paths
- */
-function processMetadataFile(relativePath) {
-  // Extract everything after the back navigation, preserving directory structure
-  return relativePath.replace(/^(\.\.\/)+/, '');
-}
-/**
- * Process extra file paths to determine their final paths
- */
-function processExtraFilePath(relativePath, context, mainFile) {
-  if (relativePath.startsWith('./')) {
-    // Current directory reference - just remove the ./
-    return relativePath.substring(2);
-  }
-  if (relativePath.startsWith('../')) {
-    // Back navigation - resolve relative to URL or create synthetic paths
-    if (context.hasUrl) {
-      // TypeScript knows context.actualUrl is defined when context.hasUrl is true
-      var resolved = resolveRelativePath(context.actualUrl, relativePath);
-      if (context.rootLevel) {
-        var rootLevelClean = context.rootLevel.replace(/\/$/, '');
-        if (resolved.startsWith("".concat(rootLevelClean, "/"))) {
-          return resolved.substring(rootLevelClean.length + 1);
-        }
-        if (resolved === rootLevelClean) {
-          return relativePath.split('/').pop() || relativePath;
-        }
-        return resolved;
-      }
-      return resolved;
-    }
-    // Fallback: if somehow we don't have a URL (shouldn't happen anymore with synthetic URLs)
-    return relativePath.split('/').pop() || relativePath;
-  }
-  // Regular relative path (like 'dir/utils.ts')
-  if (context.hasUrl && !context.hasMetadata && mainFile != null && mainFile.hasDirectory) {
-    // Place relative to main file's directory if it has one
-    var lastSegment = context.urlDirectory[context.urlDirectory.length - 1];
-    return lastSegment ? "".concat(lastSegment, "/").concat(relativePath) : relativePath;
-  }
-  return relativePath;
-}
-/**
- * Process an extra file to determine its final path
- */
-function processExtraFile(relativePath, file, context, mainFile) {
-  var finalPath;
-  if (file.metadata) {
-    finalPath = processMetadataFile(relativePath);
-  } else {
-    finalPath = processExtraFilePath(relativePath, context, mainFile);
-    // Add src/ prefix if we have metadata (all paths are relative to main file)
-    if (context.hasMetadata) {
-      finalPath = "src/".concat(finalPath);
-    }
-  }
-  return finalPath;
-}
+import { addPathsToVariant } from "../CodeHighlighter/addPathsToVariant.js";
 /**
  * Flatten a VariantCode into a flat files structure
  * Resolves relative paths and handles metadata file scoping
+ * Uses addPathsToVariant for path resolution logic
  */
 export function flattenVariant(variant) {
   var result = {};
-  var context = createPathContext(variant);
-  // Process main file
-  var mainFile = processMainFile(variant, context);
-  if (mainFile && variant.source !== undefined) {
-    result[mainFile.path] = {
-      source: stringOrHastToString(variant.source)
+  // Use addPathsToVariant to get the structured paths
+  var variantWithPaths = addPathsToVariant(variant);
+  // Add main file if it exists
+  if (variantWithPaths.path && variantWithPaths.source !== undefined) {
+    result[variantWithPaths.path] = {
+      source: stringOrHastToString(variantWithPaths.source)
     };
   }
-  // Process extra files
-  if (variant.extraFiles) {
-    for (var _i = 0, _Object$entries = Object.entries(variant.extraFiles); _i < _Object$entries.length; _i++) {
+  // Add extra files if they exist
+  if (variantWithPaths.extraFiles) {
+    for (var _i = 0, _Object$entries = Object.entries(variantWithPaths.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];
-      var file = typeof fileContent === 'string' ? {
-        source: fileContent
-      } : fileContent;
+        fileWithPath = _Object$entries$_i[1];
       // Skip files with no source content
-      if (!file.source && file.source !== '') {
+      if (!fileWithPath.source && fileWithPath.source !== '') {
         continue;
       }
-      var finalPath = processExtraFile(relativePath, file, context, mainFile);
-      result[finalPath] = _objectSpread({
-        source: stringOrHastToString(file.source || '')
-      }, file.metadata && {
-        metadata: file.metadata
+      result[fileWithPath.path] = _objectSpread({
+        source: stringOrHastToString(fileWithPath.source || '')
+      }, fileWithPath.metadata && {
+        metadata: fileWithPath.metadata
       });
     }
   }

package/useDemo/useDemo.d.ts CHANGED Viewed

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import { UseCopierOpts } from "../useCopier/index.js";
 import type { ContentProps } from "../CodeHighlighter/types.js";
+import { type ExportConfig } from "./exportVariant.js";
 /**
  * Demo templates use the exportVariant/exportVariantAsCra with flattenVariant pattern:
  *
@@ -23,6 +24,12 @@ type UseDemoOpts = {
   stackBlitzPrefix?: string;
   initialVariant?: string;
   initialTransform?: string;
+  /** Common export configuration applied to both StackBlitz and CodeSandbox */
+  export?: ExportConfig;
+  /** StackBlitz-specific export configuration (merged with common export config) */
+  exportStackBlitz?: ExportConfig;
+  /** CodeSandbox-specific export configuration (merged with common export config) */
+  exportCodeSandbox?: ExportConfig;
 };
 /**
  * Helper to create HTML form element with hidden inputs

package/useDemo/useDemo.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useDemo.d.ts","sourceRoot":"","sources":["../../src/useDemo/useDemo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;~~AAQ7D~~;;;;;;;;;;;;;GAaG;AAEH,KAAK,WAAW,GAAG;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;~~CAC3B~~,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMvF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAC3B,GAAG,EACH,QAAQ,EACR,MAAe,EACf,MAAiB,GAClB,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CAaP;AAGD,wBAAgB,OAAO,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW;;;;;;;;;;;;;~~YAxD1E~~,~~CAAC~~;;;;;;;;;;;;;;;;;;;~~EA4KlB~~"}
1	+ {"version":3,"file":"useDemo.d.ts","sourceRoot":"","sources":["../../src/useDemo/useDemo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAInE;;;;;;;;;;;;;GAaG;AAEH,KAAK,WAAW,GAAG;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,YAAY,CAAC;IAChC,mFAAmF;IACnF,iBAAiB,CAAC,EAAE,YAAY,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMvF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAC3B,GAAG,EACH,QAAQ,EACR,MAAe,EACf,MAAiB,GAClB,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CAaP;AAGD,wBAAgB,OAAO,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW;;;;;;;;;;;;;YA9D3F,CAAD;;;;;;;;;;;;;;;;;;;EAqNC"}