@mui/internal-docs-infra/esm/createDemoData/createDemoData.js

MUI Infra - internal documentation creation tools.

import { extractNameAndSlugFromUrl } from "../pipeline/loaderUtils/index.js";
/**
 * Creates demo data for displaying code examples with syntax highlighting.
 * A variant is a different implementation style of the same component.
 * Returns a data object containing demo metadata and components instead of a complete demo component.
 * Note: It is recommended to use abstractCreateDemo to create a complete demo component rather than just demo data.
 * @param url Depends on `import.meta.url` to determine the source file location.
 * @param variants The variants of the component to be rendered in the demo.
 * @param meta Additional meta for the demo.
 */
export function createDemoDataWithVariants(url, variants, meta) {
  var _meta$name, _meta$slug;
  if (!url.startsWith('file:')) {
    throw new Error('createDemoData() requires the `url` argument to be a file URL. Use `import.meta.url` to get the current file URL.');
  }
  if (!meta || !meta.precompute && !meta.skipPrecompute) {
    throw new Error("createDemoData() was unable to precompute the code in ".concat(url, ". Ensure the createDemoData() function is called within a path used for demo indexes. This is typically app/**/demos/*/index.ts but may be overridden in next.config.js"));
  }
  var precompute = meta.precompute;

  // Generate name and slug from URL if not provided in meta
  var generatedMeta = extractNameAndSlugFromUrl(url);
  var name = (_meta$name = meta.name) != null ? _meta$name : generatedMeta.name;
  var slug = (_meta$slug = meta.slug) != null ? _meta$slug : generatedMeta.slug;
  var displayName = (meta == null ? void 0 : meta.displayName) || "".concat(name.replace(/ /g, ''), "Demo");
  return {
    name: name,
    slug: slug,
    displayName: displayName,
    precompute: precompute,
    url: url,
    components: variants
  };
}

/**
 * Creates demo data for displaying code examples with syntax highlighting.
 * Returns a data object containing demo metadata and components instead of a complete demo component.
 * Note: It is recommended to use abstractCreateDemo to create a complete demo component rather than just demo data.
 * @param url Depends on `import.meta.url` to determine the source file location.
 * @param component The component to be rendered in the demo.
 * @param meta Additional meta for the demo.
 */
export function createDemoData(url, component, meta) {
  return createDemoDataWithVariants(url, {
    Default: component
  }, meta);
}

/**
 * Creates a demo data object for a global provider component with different variants.
 *
 * @param url The URL of the demo file.
 * @param globalProviders The variants of the global provider to be rendered in the demo.
 * @param meta Additional metadata for the demo data.
 * @returns Demo data object.
 */
export function createDemoGlobalWithVariants(url, globalProviders, meta) {
  return createDemoDataWithVariants(url, globalProviders, meta);
}

/**
 * Creates a demo data object for a global provider component.
 *
 * @param url The URL of the demo file.
 * @param globalProvider The global provider to be rendered in the demo.
 * @param meta Additional metadata for the demo data.
 * @returns Demo data object.
 */
export function createDemoGlobal(url, globalProvider, meta) {
  return createDemoGlobalWithVariants(url, {
    Default: globalProvider
  }, meta);
}