bejamas 0.4.0 → 0.5.0

package/README.md

@@ -28,9 +28,16 @@ npx bejamas add [component]
 
 ```bash
 npx bejamas add button
+npx bejamas add navigation-headers-01
+npx bejamas add @bejamas/footer-01
 ```
 
-You can also run the command without any arguments to view a list of all available components:
+Blocks are installed under `src/components/blocks/<block-id>` together with
+their required UI components. In a monorepo, run the command from the app so
+the block lands in the app while its UI dependencies go to the shared UI
+package.
+
+You can also run the command without any arguments to view a list of all available components and blocks:
 
 ```bash
 npx bejamas add

package/dist/{generate-mdx-oWy6Hzgd.js → generate-mdx-Bd_qGcMg.js}

@@ -1,4 +1,4 @@
-import { _ as getConfig, a as extractComponentTagsFromMDX, b as logger, c as extractPropsFromDeclaredProps, d as parseJsDocMetadata, f as resolveOutDir, g as spinner, h as toIdentifier, i as discoverExamples, l as normalizeBlockMDX, m as slugify, n as createSourceFileFromFrontmatter, o as extractFrontmatter, p as resolveUiRoot, r as detectHasImportTopLevel, s as extractPropsFromAstroProps, st as __require, t as RESERVED_COMPONENTS, u as normalizeUsageMDX } from "./utils-otwzm7kH.js";
+import { a as extractComponentTagsFromMDX, c as extractPropsFromDeclaredProps, ct as __require, d as parseJsDocMetadata, f as resolveOutDir, g as spinner, h as toIdentifier, i as discoverExamples, l as normalizeBlockMDX, m as slugify, n as createSourceFileFromFrontmatter, o as extractFrontmatter, p as resolveUiRoot, r as detectHasImportTopLevel, s as extractPropsFromAstroProps, t as RESERVED_COMPONENTS, u as normalizeUsageMDX, v as getConfig, x as logger } from "./utils-BEqgES6q.js";
 import { dirname, extname, join, relative } from "path";
 import { existsSync, mkdirSync } from "fs";
 import { readFile, readdir, writeFile } from "fs/promises";
@@ -105,7 +105,7 @@ function decodeEscapedScriptTags(source) {
 	if (!source || !source.length) return source;
 	return source.replace(/&lt;script&gt;/gi, "<script>").replace(/&lt;\/script&gt;/gi, "<\/script>");
 }
-const CONSOLE_SCRIPT_FENCE_LANGS = new Set([
+const CONSOLE_SCRIPT_FENCE_LANGS = /* @__PURE__ */ new Set([
 	"js",
 	"ts",
 	"javascript",
@@ -169,7 +169,7 @@ function extractFirstAstroFence(body) {
 	const astroFenceIndex = fences.findIndex((fence) => fence.lang === "astro");
 	if (astroFenceIndex === -1) return null;
 	const astroFence = fences[astroFenceIndex];
-	const consumedFenceIndexes = new Set([astroFenceIndex]);
+	const consumedFenceIndexes = /* @__PURE__ */ new Set([astroFenceIndex]);
 	let companionSourceMD = "";
 	let consoleScripts = [];
 	let companionIntroMD = "";
@@ -304,7 +304,7 @@ function extractTags(block) {
 }
 function extractComponentTagsFromPreviewMarkdown(block, config = {}) {
 	if (!block || !block.length) return [];
-	const { defaultPreview = true } = config;
+	const { defaultPreview = true, allowForcedPreview = true } = config;
 	const found = /* @__PURE__ */ new Set();
 	const lines = block.split("\n");
 	let inFence = false;
@@ -328,7 +328,7 @@ function extractComponentTagsFromPreviewMarkdown(block, config = {}) {
 				const sourceCode = fenceBody.join("\n").trim();
 				const prepared = prepareExampleContent(`${fenceOpen}\n${sourceCode}\n${line}`);
 				const hasForcedPreviewFlag = currentFenceFlags.has("preview") || currentFenceFlags.has("console");
-				if (!prepared.skipPreview && (defaultPreview || hasForcedPreviewFlag)) for (const tag of extractTags(prepared.snippet)) found.add(tag);
+				if (!prepared.skipPreview && (defaultPreview || allowForcedPreview && hasForcedPreviewFlag)) for (const tag of extractTags(prepared.snippet)) found.add(tag);
 			}
 			inFence = false;
 			fenceOpen = "";
@@ -364,8 +364,8 @@ function extractComponentTagsFromExamplesSections(sections) {
 /**
 * Check if an import path uses the new barrel export pattern (no .astro extension)
 */
-function isBarrelImport(path$1) {
-	return !path$1.endsWith(".astro");
+function isBarrelImport(path) {
+	return !path.endsWith(".astro");
 }
 /**
 * Convert a PascalCase component name to its folder path (kebab-case).
@@ -384,7 +384,12 @@ function componentToFolder(name) {
 		"LinkGroup",
 		"RadioGroup",
 		"ButtonGroup",
-		"StickySurface"
+		"StickySurface",
+		"DropdownMenu",
+		"NavigationMenu",
+		"ContextMenu",
+		"HoverCard",
+		"ToggleGroup"
 	].sort((a, b) => b.length - a.length);
 	for (const family of sortedFamilies) if (name === family || name.startsWith(family)) return family.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
 	const baseMatch = name.match(/^[A-Z][a-z]*/);
@@ -394,8 +399,6 @@ function resolveComponentFolder(name, componentFolderMap) {
 	if (!componentFolderMap) return componentToFolder(name);
 	const direct = componentFolderMap[name];
 	if (direct && direct.length) return direct;
-	const prefixMatch = Object.keys(componentFolderMap).filter((key) => name.startsWith(key)).sort((a, b) => b.length - a.length)[0];
-	if (prefixMatch) return componentFolderMap[prefixMatch];
 	return componentToFolder(name);
 }
 /**
@@ -419,6 +422,10 @@ function generateBarrelImports(components, componentsAlias, componentFolderMap)
 	const sortedFolders = Array.from(groups.keys()).sort();
 	for (const folder of sortedFolders) {
 		const names = groups.get(folder).sort();
+		if (folder.endsWith(".astro")) {
+			for (const name of names) lines.push(`import ${name} from '${componentsAlias}/${folder}';`);
+			continue;
+		}
 		lines.push(`import { ${names.join(", ")} } from '${componentsAlias}/${folder}';`);
 	}
 	return lines;
@@ -431,15 +438,23 @@ function generateDefaultImports(components, componentsAlias) {
 }
 function buildMdx(params) {
 	const { importName, importPath, title, description, descriptionBodyMDX, usageMDX, hasImport, propsList, propsTable, examples, examplesSections, componentFolderMap, autoImports, lucideIcons, primaryExampleMDX, componentSource, commandName, figmaUrl, componentsAlias, namedExports, apiMDX } = params;
+	const available = params.availableComponents ? new Set(params.availableComponents) : null;
+	const missingFromNames = (names) => names.filter((name) => available && !available.has(name) && !RESERVED_COMPONENTS.has(name) && !/Icon$/.test(name));
+	const missingFromSnippet = (snippet) => missingFromNames([...new Set([...snippet.matchAll(/<([A-Z][A-Za-z0-9_]*)\b/g)].map((match) => match[1]))]);
+	const missingNotice = (names) => {
+		return `> Preview unavailable. Run \`bejamas add ${[...new Set(names.map((name) => resolveComponentFolder(name, componentFolderMap)))].sort().join(" ")}\` to install the required components, then regenerate the docs.`;
+	};
 	const useBarrelPattern = isBarrelImport(importPath);
 	const sortedLucide = (lucideIcons ?? []).slice().sort();
 	const externalTopImports = [`import { Tabs as DocsTabs, TabItem as DocsTabItem } from '@astrojs/starlight/components';`, sortedLucide.length ? `import { ${sortedLucide.join(", ")} } from '@lucide/astro';` : null].filter((v) => v != null).slice().sort((a, b) => String(a).localeCompare(String(b)));
-	const sortedUiAuto = (autoImports ?? []).slice().sort();
-	const uiAutoLines = useBarrelPattern ? generateBarrelImports(sortedUiAuto, componentsAlias, componentFolderMap) : generateDefaultImports(sortedUiAuto, componentsAlias);
-	const exampleLines = (examples ?? []).map((ex) => `import ${ex.importName} from '${ex.importPath}';`).sort((a, b) => a.localeCompare(b));
+	const sortedUiAuto = (autoImports ?? []).filter((name) => !available || available.has(name)).slice().sort();
+	const uiAutoLines = useBarrelPattern || componentFolderMap ? generateBarrelImports(sortedUiAuto, componentsAlias, componentFolderMap) : generateDefaultImports(sortedUiAuto, componentsAlias);
+	const exampleLines = (examples ?? []).filter((ex) => !missingFromSnippet(ex.source).length).map((ex) => `import ${ex.importName} from '${ex.importPath}';`).sort((a, b) => a.localeCompare(b));
 	let mainImportLine = null;
-	if (!hasImport) if (useBarrelPattern) mainImportLine = `import { ${[importName, ...namedExports ?? []].sort().join(", ")} } from '${importPath}';`;
-	else mainImportLine = `import ${importName} from '${importPath}';`;
+	if (!hasImport) {
+		if (useBarrelPattern) mainImportLine = `import { ${[importName, ...namedExports ?? []].sort().join(", ")} } from '${importPath}';`;
+		else mainImportLine = `import ${importName} from '${importPath}';`;
+	}
 	const internalTopImports = [
 		mainImportLine,
 		...uiAutoLines,
@@ -450,7 +465,7 @@ function buildMdx(params) {
 		externalTopImports.length && internalTopImports.length ? "" : null,
 		...internalTopImports
 	].filter((v) => v !== null && v !== void 0);
-	const extractTags$1 = (snippet) => {
+	const extractTags = (snippet) => {
 		const found = /* @__PURE__ */ new Set();
 		const tagRegex = /<([A-Z][A-Za-z0-9_]*)\b/g;
 		let m;
@@ -459,7 +474,7 @@ function buildMdx(params) {
 	};
 	const buildSnippetImportLines = (snippet) => {
 		if (!snippet || !snippet.length) return [];
-		const used = extractTags$1(snippet);
+		const used = extractTags(snippet);
 		const usedIcons = sortedLucide.filter((n) => used.has(n));
 		const usedUi = (autoImports ?? []).filter((n) => used.has(n));
 		const includeMain = !hasImport && used.has(importName);
@@ -475,7 +490,7 @@ function buildMdx(params) {
 			if (usedUi.length > 0) internal.push(...generateBarrelImports(usedUi, componentsAlias, componentFolderMap));
 		} else {
 			if (includeMain) internal.push(`import ${importName} from '${importPath}';`);
-			internal.push(...usedUi.slice().sort().map((name) => `import ${name} from '${componentsAlias}/${name}.astro';`));
+			internal.push(...componentFolderMap ? generateBarrelImports(usedUi, componentsAlias, componentFolderMap) : generateDefaultImports(usedUi, componentsAlias));
 		}
 		const externalSorted = external.slice().sort((a, b) => a.localeCompare(b));
 		const internalSorted = internal.slice().sort((a, b) => a.localeCompare(b));
@@ -541,13 +556,15 @@ function buildMdx(params) {
 		const { enableConsolePanel = false, consoleScripts = [] } = options;
 		const extracted = extractInlineScripts(snippet);
 		const resolvedConsoleScripts = enableConsolePanel && consoleScripts.length ? consoleScripts : enableConsolePanel ? extracted.scripts : [];
-		const withConvertedParagraphs = convertParagraphsWithComponents(extracted.markup.replace(/<!--([\s\S]*?)-->/g, "{/*$1*/}"));
+		const withoutComments = extracted.markup.replace(/<!--([\s\S]*?)-->/g, "{/*$1*/}");
+		const withConvertedParagraphs = convertParagraphsWithComponents(withoutComments);
 		if (/<p[\s>]/i.test(withConvertedParagraphs)) return {
 			markup: normalizeInlineWhitespace(withConvertedParagraphs),
 			scripts: resolvedConsoleScripts
 		};
+		const normalized = normalizeInlineWhitespace(withConvertedParagraphs);
 		return {
-			markup: wrapTextNodes(normalizeInlineWhitespace(withConvertedParagraphs)),
+			markup: wrapTextNodes(normalized),
 			scripts: resolvedConsoleScripts
 		};
 	};
@@ -669,6 +686,8 @@ function buildMdx(params) {
 		return parts.join("\n");
 	};
 	const renderPreviewBlock = (snippet, options = {}) => {
+		const missing = missingFromSnippet(snippet);
+		if (missing.length) return missingNotice(missing);
 		const { enableConsolePanel = false } = options;
 		const preparedPreview = toMdxPreview(snippet, options);
 		if (!preparedPreview.markup || !preparedPreview.markup.length) return "";
@@ -691,7 +710,12 @@ ${preparedPreview.markup}
 	};
 	const renderAstroPreviewsInMarkdown = (block, config = {}) => {
 		if (!block || !block.length) return block;
-		const { defaultPreview = true } = config;
+		const missingRaw = missingFromNames(extractComponentTagsFromPreviewMarkdown(block, {
+			defaultPreview: false,
+			allowForcedPreview: false
+		}));
+		if (missingRaw.length) return `${missingNotice(missingRaw)}\n\n\`\`\`\`mdx\n${block}\n\`\`\`\``;
+		const { defaultPreview = true, allowForcedPreview = true } = config;
 		const lines = block.split("\n");
 		const out = [];
 		let inFence = false;
@@ -745,7 +769,7 @@ ${preparedPreview.markup}
 					const companionMarkdown = companionConsoleFence ? lines.slice(lineIndex + 1, companionConsoleFence.end + 1).join("\n") : "";
 					const prepared = prepareExampleContent(companionMarkdown.length ? `${fenceOpen}\n${sourceCode}\n${line}\n${companionMarkdown}` : `${fenceOpen}\n${sourceCode}\n${line}`);
 					const hasForcedPreviewFlag = currentFenceFlags.has("preview") || currentFenceFlags.has("console");
-					const shouldPreview = !prepared.skipPreview && (defaultPreview || hasForcedPreviewFlag);
+					const shouldPreview = !prepared.skipPreview && (defaultPreview || allowForcedPreview && hasForcedPreviewFlag);
 					if (prepared.snippet && prepared.snippet.length && shouldPreview) {
 						const previewBlock = renderPreviewBlock(prepared.snippet, {
 							enableConsolePanel: prepared.enableConsolePanel,
@@ -803,7 +827,10 @@ ${preparedPreview.markup}
 	};
 	const renderedDescriptionBodyMDX = renderAstroPreviewsInMarkdown(descriptionBodyMDX || "");
 	const renderedUsageMDX = renderAstroPreviewsInMarkdown(usageMDX || "", { defaultPreview: false });
-	const renderedApiMDX = renderAstroPreviewsInMarkdown(apiMDX || "");
+	const renderedApiMDX = renderAstroPreviewsInMarkdown(apiMDX || "", {
+		defaultPreview: false,
+		allowForcedPreview: false
+	});
 	const primaryExampleSection = primaryExampleMDX && primaryExampleMDX.length ? `${renderPreviewBlock(primaryExampleMDX)}
 
 \`\`\`astro
@@ -815,7 +842,7 @@ ${(() => {
 	const renderExampleItem = (headingLevel, headingTitle, body) => {
 		const prepared = prepareExampleContent(body);
 		const blocks = [`${headingLevel} ${headingTitle}`];
-		if (prepared.descriptionMD && prepared.descriptionMD.length) blocks.push(prepared.descriptionMD);
+		if (prepared.descriptionMD && prepared.descriptionMD.length) blocks.push(renderAstroPreviewsInMarkdown(prepared.descriptionMD));
 		if (prepared.snippet && prepared.snippet.length && prepared.sourceCode && prepared.sourceCode.length && !prepared.skipPreview) blocks.push(renderPreviewBlock(prepared.snippet, {
 			enableConsolePanel: prepared.enableConsolePanel,
 			consoleScripts: prepared.consoleScripts
@@ -831,7 +858,7 @@ ${sourceBlock}
 \`\`\``);
 			if (prepared.companionIntroMD && prepared.companionIntroMD.length && !prepared.mergeCompanionWithSource) blocks.push(prepared.companionIntroMD);
 			if (prepared.companionSourceMD && prepared.companionSourceMD.length && !prepared.mergeCompanionWithSource) blocks.push(renderCompanionSourceMD(prepared.companionSourceMD));
-			if (prepared.trailingDescriptionMD && prepared.trailingDescriptionMD.length) blocks.push(prepared.trailingDescriptionMD);
+			if (prepared.trailingDescriptionMD && prepared.trailingDescriptionMD.length) blocks.push(renderAstroPreviewsInMarkdown(prepared.trailingDescriptionMD));
 		}
 		return blocks.join("\n\n");
 	};
@@ -842,7 +869,7 @@ ${sourceBlock}
 			const sectionParts = [];
 			const hasSectionTitle = !!(section.title && section.title.length);
 			if (hasSectionTitle) sectionParts.push(`### ${section.title}`);
-			if (section.introMD && section.introMD.length) sectionParts.push(section.introMD);
+			if (section.introMD && section.introMD.length) sectionParts.push(renderAstroPreviewsInMarkdown(section.introMD));
 			if (section.items && section.items.length) {
 				const itemHeadingLevel = hasSectionTitle ? "####" : "###";
 				for (const item of section.items) sectionParts.push(renderExampleItem(itemHeadingLevel, item.title, item.body));
@@ -859,9 +886,9 @@ ${sourceBlock}
 	}
 	if (examples && examples.length) for (const ex of examples) renderedExampleSections.push(`### ${ex.title}
 
-<div class="not-content">
+${missingFromSnippet(ex.source).length ? missingNotice(missingFromSnippet(ex.source)) : `<div class="not-content">
   <${ex.importName} />
-</div>
+</div>`}
 
 \`\`\`astro
 ${ex.source}
@@ -945,15 +972,16 @@ ${ex.source}
 */
 async function discoverComponents(componentsDir) {
 	const entries = [];
-	const dirEntries = await readdir(componentsDir, { withFileTypes: true });
+	const dirEntries = (await readdir(componentsDir, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name));
 	for (const entry of dirEntries) if (entry.isDirectory()) {
 		const folderPath = join(componentsDir, entry.name);
 		const indexPath = join(folderPath, "index.ts");
 		if (existsSync(indexPath)) {
-			const namedExports = parseBarrelExports(await readFile(indexPath, "utf-8"));
+			const localExports = parseBarrelExports(await readFile(indexPath, "utf-8")).filter(({ file }) => dirname(join(folderPath, file)) === folderPath && existsSync(join(folderPath, file)));
+			const namedExports = localExports.map(({ name }) => name);
 			const mainComponentName = findMainComponent(namedExports, entry.name);
 			if (mainComponentName) {
-				const mainFilePath = join(folderPath, `${mainComponentName}.astro`);
+				const mainFilePath = join(folderPath, localExports.find(({ name }) => name === mainComponentName).file);
 				if (existsSync(mainFilePath)) {
 					const subComponents = namedExports.filter((n) => n !== mainComponentName);
 					entries.push({
@@ -976,12 +1004,17 @@ async function discoverComponents(componentsDir) {
 			namedExports: []
 		});
 	}
-	return entries;
+	const nestedNames = new Set(entries.filter((entry) => entry.isFolder).map((entry) => entry.name));
+	return entries.filter((entry) => entry.isFolder || !nestedNames.has(entry.name));
 }
 function buildComponentFolderMap(components) {
 	const map = {};
 	for (const component of components) {
-		if (!component.isFolder || !component.folderName) continue;
+		if (!component.isFolder) {
+			map[component.name] = `${component.name}.astro`;
+			continue;
+		}
+		if (!component.folderName) continue;
 		map[component.name] = component.folderName;
 		for (const sub of component.namedExports) map[sub] = component.folderName;
 	}
@@ -995,9 +1028,12 @@ function buildComponentFolderMap(components) {
 */
 function parseBarrelExports(content) {
 	const exports = [];
-	const exportRegex = /export\s*\{\s*default\s+as\s+(\w+)\s*\}/g;
+	const exportRegex = /export\s*\{\s*default\s+as\s+(\w+)\s*\}\s*from\s*["'](\.\/[^"']+\.astro)["']/g;
 	let match;
-	while ((match = exportRegex.exec(content)) !== null) exports.push(match[1]);
+	while ((match = exportRegex.exec(content)) !== null) exports.push({
+		name: match[1],
+		file: match[2]
+	});
 	return exports;
 }
 /**
@@ -1017,7 +1053,7 @@ async function main() {
 	const config = await getConfig(cwd);
 	const componentsAlias = (config?.aliases?.ui || config?.aliases?.components || "@bejamas/ui/components").replace(/\/$/, "");
 	const componentsDirFromConfig = config?.resolvedPaths?.ui || config?.resolvedPaths?.components;
-	let uiRoot = resolveUiRoot(cwd);
+	let uiRoot = componentsDirFromConfig ? dirname(dirname(componentsDirFromConfig)) : resolveUiRoot(cwd);
 	let componentsDir = join(uiRoot, "src", "components");
 	if (componentsDirFromConfig) {
 		componentsDir = componentsDirFromConfig;
@@ -1034,6 +1070,8 @@ async function main() {
 	}
 	const components = await discoverComponents(componentsDir);
 	const componentFolderMap = buildComponentFolderMap(components);
+	const availableComponents = Object.keys(componentFolderMap);
+	const rewriteAliases = (source) => source.replace(/@bejamas\/ui\/components(?=[/"'])/g, componentsAlias).replace(/@bejamas\/(?:ui|registry)\/lib\/utils(?=["'])/g, config?.aliases?.utils ?? "@/lib/utils").replace(/@bejamas\/(?:ui|registry)\/lib(?=[/"'])/g, config?.aliases?.lib ?? "@/lib");
 	if (DEBUG) {
 		logger.info(`[docs-generator] components found: ${components.length}`);
 		if (components.length) logger.info(`[docs-generator] first few: ${components.slice(0, 5).map((c) => c.name).join(", ")}`);
@@ -1046,7 +1084,7 @@ async function main() {
 		const astroFile = await readFile(filePath, "utf-8");
 		const frontmatterCode = extractFrontmatter(astroFile);
 		const sourceFile = createSourceFileFromFrontmatter(frontmatterCode);
-		const meta = parseJsDocMetadata(frontmatterCode);
+		const meta = parseJsDocMetadata(rewriteAliases(frontmatterCode));
 		const declaredProps = extractPropsFromDeclaredProps(sourceFile);
 		const destructuredProps = extractPropsFromAstroProps(sourceFile);
 		const defaultsMap = /* @__PURE__ */ new Map();
@@ -1078,9 +1116,10 @@ async function main() {
 		if (parsedExamplesSections.length === 0) {
 			exampleRelPaths = await discoverExamples(filePath, componentsDir);
 			examples = (exampleRelPaths || []).map((rel) => {
-				const importPathEx = `${componentsAlias}/${rel.split(__require("path").sep).join(__require("path").posix.sep)}`;
+				const posixRel = rel.split(__require("path").sep).join(__require("path").posix.sep);
+				const importPathEx = `${componentsAlias}/${posixRel}`;
 				const abs = join(componentsDir, rel);
-				const source = __require("fs").readFileSync(abs, "utf-8");
+				const source = rewriteAliases(__require("fs").readFileSync(abs, "utf-8"));
 				const base = toIdentifier(__require("path").basename(rel, __require("path").extname(rel)));
 				return {
 					importName: `${pascal}${base}`,
@@ -1094,8 +1133,11 @@ async function main() {
 		const usedInDescription = extractComponentTagsFromPreviewMarkdown(descriptionBodyMDX).filter((n) => n !== pascal);
 		const usedInExamples = extractComponentTagsFromExamplesSections(parsedExamplesSections).filter((n) => n !== pascal);
 		const usedInPrimary = extractComponentTagsFromMDX(primaryExampleMDX).filter((n) => n !== pascal);
-		const usedInApi = extractComponentTagsFromPreviewMarkdown(apiMDX).filter((n) => n !== pascal);
-		const autoSet = new Set([
+		const usedInApi = extractComponentTagsFromPreviewMarkdown(apiMDX, {
+			defaultPreview: false,
+			allowForcedPreview: false
+		}).filter((n) => n !== pascal);
+		const autoSet = /* @__PURE__ */ new Set([
 			...usedInUsage,
 			...usedInDescription,
 			...usedInExamples,
@@ -1104,9 +1146,12 @@ async function main() {
 		]);
 		const usedNamedExports = isFolder ? namedExports.filter((n) => autoSet.has(n)) : [];
 		if (isFolder) for (const n of namedExports) autoSet.delete(n);
-		const autoImports = Array.from(autoSet).filter((name) => !RESERVED_COMPONENTS.has(name)).filter((name) => true);
-		const lucideIcons = autoImports.filter((n) => /Icon$/.test(n));
-		const uiAutoImports = autoImports.filter((n) => !/Icon$/.test(n));
+		const autoImports = Array.from(autoSet).filter((name) => !RESERVED_COMPONENTS.has(name));
+		const isLucideIcon = (name) => /Icon$/.test(name) && !componentFolderMap[name];
+		const lucideIcons = autoImports.filter(isLucideIcon);
+		const uiAutoImports = autoImports.filter((name) => !isLucideIcon(name));
+		const missingComponents = uiAutoImports.filter((name) => !availableComponents.includes(name));
+		if (missingComponents.length) logger.warn(`${slug}.mdx: previews require ${missingComponents.sort().join(", ")}; keeping their source examples without executing them.`);
 		const mdx = buildMdx({
 			importName,
 			importPath,
@@ -1119,6 +1164,7 @@ async function main() {
 			examples,
 			examplesSections: parsedExamplesSections,
 			componentFolderMap,
+			availableComponents,
 			autoImports: uiAutoImports,
 			lucideIcons,
 			primaryExampleMDX,
@@ -1139,7 +1185,9 @@ async function main() {
 	}
 	spin.succeed(`Created ${generatedCount} file${generatedCount === 1 ? "" : "s"}:`);
 	components.map((c) => {
-		return relative(cwd, join(outDir, `${slugify(c.name)}.mdx`));
+		const slug = slugify(c.name);
+		const outFile = join(outDir, `${slug}.mdx`);
+		return relative(cwd, outFile);
 	}).sort((a, b) => a.localeCompare(b)).forEach((p) => {
 		logger.log(`  - ${p}`);
 	});
@@ -1155,4 +1203,4 @@ if (process.env.BEJAMAS_SKIP_AUTO_RUN !== "1" && process.env.BEJAMAS_SKIP_AUTO_R
 
 //#endregion
 export { runDocsGenerator };
-//# sourceMappingURL=generate-mdx-oWy6Hzgd.js.map
+//# sourceMappingURL=generate-mdx-Bd_qGcMg.js.map