@tamagui/static 3.0.0-beta.1187.1 → 3.0.0-beta.1202.1

package/dist/cjs/exports.cjs

@@ -24,7 +24,8 @@ __export(exports_exports, {
 	clearFormatCache: () => import_detectModuleFormat.clearFormatCache,
 	detectModuleFormat: () => import_detectModuleFormat.detectModuleFormat,
 	esbundleTamaguiConfig: () => import_bundle.esbundleTamaguiConfig,
-	evaluateComponentModule: () => import_bundleConfig.evaluateComponentModule
+	evaluateComponentModule: () => import_bundleConfig.evaluateComponentModule,
+	generateConfigMarkdown: () => import_generateConfigMarkdown.generateConfigMarkdown
 });
 module.exports = __toCommonJS(exports_exports);
 __reExport(exports_exports, require("./checkDeps.cjs"), module.exports);
@@ -42,3 +43,4 @@ var import_detectModuleFormat = require("./extractor/detectModuleFormat.cjs");
 var import_bundle = require("./extractor/bundle.cjs");
 __reExport(exports_exports, require("./getPragmaOptions.cjs"), module.exports);
 __reExport(exports_exports, require("./zero/index.cjs"), module.exports);
+var import_generateConfigMarkdown = require("./extractor/generateConfigMarkdown.cjs");

package/dist/cjs/extractor/generateConfigMarkdown.cjs

@@ -0,0 +1,492 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: () => from[key],
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var generateConfigMarkdown_exports = {};
+__export(generateConfigMarkdown_exports, { generateConfigMarkdown: () => generateConfigMarkdown });
+module.exports = __toCommonJS(generateConfigMarkdown_exports);
+function generateConfigMarkdown(config, options) {
+	const sections = [];
+	sections.push("# Tamagui Configuration\n\n");
+	sections.push("This document provides an overview of the Tamagui configuration for this project.\n\n");
+	const shorthands = config.tamaguiConfig?.shorthands || {};
+	const reverseShorthands = {};
+	for (const [short, full] of Object.entries(shorthands)) {
+		reverseShorthands[full] = short;
+	}
+	const getPropName = (fullProp) => {
+		const settings2 = config.tamaguiConfig?.settings || {};
+		if (settings2.onlyAllowShorthands) {
+			if (reverseShorthands[fullProp]) return reverseShorthands[fullProp];
+			if (fullProp === "backgroundColor" && reverseShorthands["background"]) {
+				return reverseShorthands["background"];
+			}
+		}
+		return fullProp;
+	};
+	const settings = config.tamaguiConfig?.settings || {};
+	const syntaxChoice = options?.styleValueSyntax || settings.styleValueSyntax || "both";
+	sections.push("## Configuration Settings\n\n");
+	sections.push("**IMPORTANT:** These settings affect how you write Tamagui code in this project.\n\n");
+	if (settings.defaultFont) {
+		sections.push(`### Default Font: \`${settings.defaultFont}\`
+
+`);
+		sections.push(`All text components will use the "${settings.defaultFont}" font family by default.
+
+`);
+	}
+	if (settings.onlyAllowShorthands !== void 0) {
+		sections.push(`### Only Allow Shorthands: \`${settings.onlyAllowShorthands}\`
+
+`);
+		if (settings.onlyAllowShorthands) {
+			sections.push("**You MUST use shorthand properties in this project.**\n\n");
+			sections.push("Full property names are not allowed. For example:\n");
+			sections.push("- ✅ `<View w=\"10\" />` (correct)\n");
+			sections.push("- ❌ `<View width=\"10\" />` (will error)\n\n");
+			sections.push("See the Shorthand Properties section below for all available shorthands.\n\n");
+		} else {
+			sections.push("You can use either shorthand or full property names.\n\n");
+		}
+	}
+	if (syntaxChoice === "string") {
+		sections.push("### Style value syntax: `string`\n\n");
+		sections.push("Only the string form is allowed in this project (e.g. `bg=\"red hover:blue\"`).\n\n");
+	} else if (syntaxChoice === "object") {
+		sections.push("### Style value syntax: `object`\n\n");
+		sections.push("Only the object form is allowed in this project (e.g. `bg={{ default: 'red', hover: 'blue' }}`).\n\n");
+	} else {
+		sections.push("### Style value syntax\n\n");
+		sections.push("Both string and object style value syntax are allowed.\n\n");
+	}
+	if (settings.addThemeClassName !== void 0) {
+		sections.push(`### Theme Class Name: \`${settings.addThemeClassName}\`
+
+`);
+		if (settings.addThemeClassName === "html") {
+			sections.push("Theme classes are applied to the root HTML element.\n\n");
+		}
+	}
+	if (settings.allowedStyleValues) {
+		sections.push("### Allowed Style Values\n\n");
+		sections.push(`Type validation: \`${JSON.stringify(settings.allowedStyleValues)}\`.
+
+`);
+		sections.push("Single-token values are type-checked. Run `tamagui check --strict` to also validate conditional payloads.\n\n");
+	}
+	sections.push("## Flat Value Grammar\n\n");
+	sections.push("Conditional style values follow this grammar:\n\n");
+	sections.push("```txt\n");
+	sections.push("value  := base? clause*\n");
+	sections.push("clause := modifier(:modifier)*:payload\n");
+	sections.push("```\n\n");
+	sections.push("- No `$` sigils: bare token names (`bg=\"background\"`, not `bg=\"$background\"`).\n");
+	sections.push("- Kebab-case theme names: `background-hover`, `border-color`, `shadow-color`.\n");
+	sections.push("- Numbers are px: `p={4}` is 4px, while `p=\"4\"` is space token 4.\n");
+	sections.push("- Specificity precedence: platform (`ios:` > `native:` > bare) > condition count > category (media < container < theme < group < state).\n\n");
+	const bgProp = getPropName("background");
+	const pProp = getPropName("padding");
+	if (syntaxChoice === "string") {
+		sections.push("**String form:**\n\n");
+		sections.push("```tsx\n");
+		sections.push(`<View ${bgProp}="background hover:background-hover dark:blue-500" ${pProp}="4 sm:6 max-sm:2" />
+`);
+		sections.push("```\n\n");
+	} else if (syntaxChoice === "object") {
+		sections.push("**Object form:**\n\n");
+		sections.push("```tsx\n");
+		sections.push(`<View ${bgProp}={{ default: 'background', hover: 'background-hover', dark: 'blue-500' }} ${pProp}={{ default: '4', sm: '6', 'max-sm': '2' }} />
+`);
+		sections.push("```\n\n");
+	} else {
+		sections.push("Both forms are allowed:\n\n");
+		sections.push("```tsx\n");
+		sections.push("// string form\n");
+		sections.push(`<View ${bgProp}="background hover:background-hover dark:blue-500" ${pProp}="4 sm:6 max-sm:2" />
+
+`);
+		sections.push("// object form\n");
+		sections.push(`<View ${bgProp}={{ default: 'background', hover: 'background-hover', dark: 'blue-500' }} ${pProp}={{ default: '4', sm: '6', 'max-sm': '2' }} />
+`);
+		sections.push("```\n\n");
+	}
+	sections.push("## Shorthand Properties\n\n");
+	sections.push("These shorthand properties are available for styling:\n\n");
+	const shorthandEntries = Object.entries(shorthands).sort(([a], [b]) => a.localeCompare(b));
+	sections.push(shorthandEntries.map(([short, full]) => `- \`${short}\` \u2192 \`${full}\``).join("\n"));
+	sections.push("\n\n");
+	const sizes = config.tamaguiConfig?.sizes;
+	if (sizes && typeof sizes === "object") {
+		sections.push("## Named Control Sizes\n\n");
+		sections.push(`Control components (Button, Input, etc.) use the configured names below. Default is \`${sizes.default ?? "md"}\`.
+
+`);
+		sections.push("| Size | Configuration |\n");
+		sections.push("|---|---|\n");
+		for (const [sizeKey, val] of Object.entries(sizes)) {
+			if (sizeKey === "default") continue;
+			const valStr = typeof val === "object" && val !== null ? JSON.stringify(val) : String(val);
+			const isDefault = sizes.default === sizeKey ? " (default)" : "";
+			sections.push(`| \`${sizeKey}\`${isDefault} | ${valStr} |
+`);
+		}
+		sections.push("\n");
+	}
+	sections.push("## Themes\n\n");
+	const themes = config.tamaguiConfig?.themes || {};
+	const themeNames = Object.keys(themes).sort();
+	sections.push(themeNames.map((name) => `- \`${name}\``).join("\n"));
+	sections.push("\n\nTheme names above are exact configured names. Nested themes resolve relative to their parent. Use an explicit theme boundary in a component skin.\n\n");
+	if (themeNames.length) {
+		sections.push("### Theme Usage\n\n");
+		sections.push(`\`\`\`tsx
+<Theme name=${JSON.stringify(themeNames[0])}>
+  <Button>Uses this theme</Button>
+</Theme>
+\`\`\`
+
+`);
+	}
+	sections.push("**Accessing theme values:**\n\n");
+	sections.push("Components access theme values by their bare names:\n\n");
+	const colorProp = getPropName("color");
+	if (syntaxChoice === "string") {
+		sections.push("```tsx\n");
+		sections.push(`<View ${bgProp}="background hover:background-hover" ${colorProp}="color" />
+`);
+		sections.push("```\n\n");
+	} else if (syntaxChoice === "object") {
+		sections.push("```tsx\n");
+		sections.push(`<View ${bgProp}={{ default: 'background', hover: 'background-hover' }} ${colorProp}={{ default: 'color' }} />
+`);
+		sections.push("```\n\n");
+	} else {
+		sections.push("```tsx\n");
+		sections.push("// string form\n");
+		sections.push(`<View ${bgProp}="background hover:background-hover" ${colorProp}="color" />
+
+`);
+		sections.push("// object form\n");
+		sections.push(`<View ${bgProp}={{ default: 'background', hover: 'background-hover' }} ${colorProp}={{ default: 'color' }} />
+`);
+		sections.push("```\n\n");
+	}
+	sections.push("**Special props:**\n\n");
+	sections.push("- `theme=\"inverse\"`: Uses the opposite light or dark sub-theme\n");
+	sections.push("## Tokens\n\n");
+	sections.push("Tokens are design system values referenced by their bare names.\n\n");
+	const tokens = config.tamaguiConfig?.tokens || {};
+	if (tokens.space && Object.keys(tokens.space).length > 0) {
+		sections.push("### Space Tokens\n\n");
+		const spaceTokens = Object.entries(tokens.space).sort(([a], [b]) => {
+			const numA = parseFloat(a);
+			const numB = parseFloat(b);
+			if (!isNaN(numA) && !isNaN(numB)) {
+				return numA - numB;
+			}
+			return a.localeCompare(b);
+		});
+		sections.push(spaceTokens.map(([key, value]) => `- \`${key}\`: ${formatTokenValue(value)}`).join("\n"));
+		sections.push("\n\n");
+	}
+	if (tokens.size && Object.keys(tokens.size).length > 0) {
+		sections.push("### Size Tokens\n\n");
+		const sizeTokens = Object.entries(tokens.size).sort(([a], [b]) => {
+			const numA = parseFloat(a);
+			const numB = parseFloat(b);
+			if (!isNaN(numA) && !isNaN(numB)) {
+				return numA - numB;
+			}
+			return a.localeCompare(b);
+		});
+		sections.push(sizeTokens.map(([key, value]) => `- \`${key}\`: ${formatTokenValue(value)}`).join("\n"));
+		sections.push("\n\n");
+	}
+	if (tokens.radius && Object.keys(tokens.radius).length > 0) {
+		sections.push("### Radius Tokens\n\n");
+		const radiusTokens = Object.entries(tokens.radius).sort(([a], [b]) => {
+			const numA = parseFloat(a);
+			const numB = parseFloat(b);
+			if (!isNaN(numA) && !isNaN(numB)) {
+				return numA - numB;
+			}
+			return a.localeCompare(b);
+		});
+		sections.push(radiusTokens.map(([key, value]) => `- \`${key}\`: ${formatTokenValue(value)}`).join("\n"));
+		sections.push("\n\n");
+	}
+	if (tokens.zIndex && Object.keys(tokens.zIndex).length > 0) {
+		sections.push("### Z-Index Tokens\n\n");
+		const zIndexTokens = Object.entries(tokens.zIndex).sort(([a], [b]) => {
+			const numA = parseFloat(a);
+			const numB = parseFloat(b);
+			if (!isNaN(numA) && !isNaN(numB)) {
+				return numA - numB;
+			}
+			return a.localeCompare(b);
+		});
+		sections.push(zIndexTokens.map(([key, value]) => `- \`${key}\`: ${formatTokenValue(value)}`).join("\n"));
+		sections.push("\n\n");
+	}
+	let sampleColorBg = "blue-500";
+	let sampleColorText = "color";
+	if (tokens.color && Object.keys(tokens.color).length > 0) {
+		sections.push("### Color Tokens\n\n");
+		const colorKeys = Object.keys(tokens.color).sort();
+		const paletteMap = /* @__PURE__ */ new Map();
+		const standaloneColors = [];
+		for (const key of colorKeys) {
+			const match = key.match(/^([a-z]+)-(\d+)$/);
+			if (match) {
+				const [, palette, step] = match;
+				if (!paletteMap.has(palette)) {
+					paletteMap.set(palette, /* @__PURE__ */ new Set());
+				}
+				paletteMap.get(palette).add(step);
+			} else {
+				standaloneColors.push([key, tokens.color[key]]);
+			}
+		}
+		if (paletteMap.size >= 4) {
+			const palettes = Array.from(paletteMap.keys()).sort().join(", ");
+			sections.push(`**Tailwind Palettes (\`<name>-<50..950>\`):** ${palettes}
+
+`);
+			if (standaloneColors.length > 0) {
+				sections.push("**Named Colors:**\n\n");
+				sections.push(standaloneColors.map(([k, v]) => `- \`${k}\`: ${formatTokenValue(v)}`).join("\n"));
+				sections.push("\n\n");
+			}
+			sampleColorBg = colorKeys.find((k) => k.startsWith("blue-")) || colorKeys[0];
+			sampleColorText = colorKeys.find((k) => k.startsWith("gray-") || k.startsWith("zinc-")) || colorKeys[1] || "color";
+		} else {
+			sections.push(colorKeys.map((key) => `- \`${key}\`: ${formatTokenValue(tokens.color[key])}`).join("\n"));
+			sections.push("\n\n");
+			sampleColorBg = colorKeys[0] || "background";
+			sampleColorText = colorKeys[1] || "color";
+		}
+	} else {
+		sampleColorBg = "background";
+		sampleColorText = "color";
+	}
+	sections.push("### Token Usage\n\n");
+	sections.push("Tokens can be used in component props by their bare names:\n\n");
+	const paddingProp = getPropName("padding");
+	const gapProp = getPropName("gap");
+	const marginProp = getPropName("margin");
+	const widthProp = getPropName("width");
+	const heightProp = getPropName("height");
+	const radiusProp = getPropName("borderRadius");
+	const sampleRadius = tokens.radius?.md ? "md" : Object.keys(tokens.radius || {})[0] || "0px";
+	if (syntaxChoice === "string") {
+		sections.push("```tsx\n");
+		sections.push(`// Space tokens - for margin, padding, gap
+<View ${paddingProp}="4 sm:6" ${gapProp}="2" ${marginProp}="3" />
+
+`);
+		sections.push(`// Size tokens - for width, height, dimensions
+<View ${widthProp}="10 sm:12" ${heightProp}="6" />
+
+`);
+		sections.push(`// Color tokens - for colors and backgrounds
+<View ${bgProp}="${sampleColorBg} hover:${sampleColorBg}" ${colorProp}="${sampleColorText}" />
+
+`);
+		sections.push(`// Radius tokens - for border-radius
+<View ${radiusProp}="${sampleRadius}" />
+`);
+		sections.push("```\n\n");
+	} else if (syntaxChoice === "object") {
+		sections.push("```tsx\n");
+		sections.push(`// Space tokens - for margin, padding, gap
+<View ${paddingProp}={{ default: '4', sm: '6' }} ${gapProp}="2" ${marginProp}="3" />
+
+`);
+		sections.push(`// Size tokens - for width, height, dimensions
+<View ${widthProp}={{ default: '10', sm: '12' }} ${heightProp}="6" />
+
+`);
+		sections.push(`// Color tokens - for colors and backgrounds
+<View ${bgProp}={{ default: '${sampleColorBg}', hover: '${sampleColorBg}' }} ${colorProp}={{ default: '${sampleColorText}' }} />
+
+`);
+		sections.push(`// Radius tokens - for border-radius
+<View ${radiusProp}="${sampleRadius}" />
+`);
+		sections.push("```\n\n");
+	} else {
+		sections.push("```tsx\n");
+		sections.push("// String form\n");
+		sections.push(`<View ${paddingProp}="4 sm:6" ${widthProp}="10 sm:12" ${bgProp}="${sampleColorBg}" />
+
+`);
+		sections.push("// Object form\n");
+		sections.push(`<View ${paddingProp}={{ default: '4', sm: '6' }} ${widthProp}={{ default: '10', sm: '12' }} ${bgProp}={{ default: '${sampleColorBg}' }} />
+
+`);
+		sections.push(`// Space and radius tokens
+<View ${gapProp}="2" ${marginProp}="3" ${heightProp}="6" ${radiusProp}="${sampleRadius}" />
+`);
+		sections.push("```\n\n");
+	}
+	if (config.tamaguiConfig?.media) {
+		sections.push("## Media Queries\n\n");
+		sections.push("Available responsive breakpoints:\n\n");
+		const media = config.tamaguiConfig.media;
+		const mediaEntries = Object.entries(media).sort(([a], [b]) => a.localeCompare(b));
+		for (const [name, query] of mediaEntries) {
+			sections.push(`- **${name}**: ${formatMediaQuery(query)}
+`);
+		}
+		sections.push("\n");
+		sections.push("### Media Query Usage\n\n");
+		sections.push("Media queries can be used as style props or with the `useMedia` hook:\n\n");
+		const representative = mediaEntries.find(([n]) => n === "sm" || n === "md")?.[0] || mediaEntries.find(([n]) => !n.includes("-"))?.[0] || mediaEntries[0]?.[0];
+		if (representative) {
+			const isIdentifier = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(representative);
+			const mediaAccess = isIdentifier ? `media.${representative}` : `media['${representative}']`;
+			sections.push("```tsx\n");
+			if (syntaxChoice === "string") {
+				sections.push("// As a clause in the same style value\n");
+				sections.push(`<View ${widthProp}="100% ${representative}:50%" />
+
+`);
+			} else if (syntaxChoice === "object") {
+				sections.push("// Using the object form\n");
+				sections.push(`<View ${widthProp}={{ default: '100%', '${representative}': '50%' }} />
+
+`);
+			} else {
+				sections.push("// String form and object form\n");
+				sections.push(`<View ${widthProp}="100% ${representative}:50%" />
+`);
+				sections.push(`<View ${widthProp}={{ default: '100%', '${representative}': '50%' }} />
+
+`);
+			}
+			sections.push("// Using the useMedia hook\n");
+			sections.push("const media = useMedia()\n");
+			sections.push(`if (${mediaAccess}) {
+`);
+			sections.push("  // Render for this breakpoint\n");
+			sections.push("}\n");
+			sections.push("```\n\n");
+		}
+	}
+	if (config.tamaguiConfig?.fonts) {
+		sections.push("## Fonts\n\n");
+		sections.push("Available font families:\n\n");
+		const fonts = config.tamaguiConfig.fonts;
+		const fontNames = Object.keys(fonts).sort();
+		sections.push(fontNames.map((name) => `- ${name}`).join("\n"));
+		sections.push("\n\n");
+	}
+	if (config.tamaguiConfig?.animations) {
+		sections.push("## Animations\n\n");
+		sections.push("Available animation presets:\n\n");
+		const animations = config.tamaguiConfig.animations;
+		if (animations.animations) {
+			const animationNames = Object.keys(animations.animations).sort();
+			sections.push(animationNames.map((name) => `- ${name}`).join("\n"));
+			sections.push("\n\n");
+		}
+	}
+	const componentsSection = [];
+	const componentSet = /* @__PURE__ */ new Set();
+	let barrelExported = false;
+	const candidateModules = ["tamagui", ...(config.components || []).map((c) => c.moduleName)];
+	for (const modName of candidateModules) {
+		if (!modName) continue;
+		try {
+			const mod = require(modName);
+			for (const [key, val] of Object.entries(mod)) {
+				if (/^[A-Z]/.test(key) && (typeof val === "function" || typeof val === "object" && val !== null)) {
+					if (!key.endsWith("Context") && !key.endsWith("Provider") && key !== "Fragment") {
+						componentSet.add(key);
+						barrelExported = true;
+					}
+				}
+			}
+			if (barrelExported) break;
+		} catch {}
+	}
+	if (!barrelExported && config.components) {
+		for (const componentModule of config.components) {
+			for (const name of Object.keys(componentModule.nameToInfo || {})) {
+				componentSet.add(name);
+			}
+		}
+	}
+	const allComponents = Array.from(componentSet).filter((name) => {
+		if (name.endsWith("Frame")) {
+			const base = name.replace(/Frame$/, "");
+			if (componentSet.has(base) || name.startsWith("Popper") || name.startsWith("DialogPortal") || name.startsWith("SelectScrollButton")) {
+				return false;
+			}
+		}
+		return true;
+	});
+	componentsSection.push("## Components\n\n");
+	componentsSection.push("Available named exports (import these names directly):\n\n");
+	for (const name of allComponents.sort()) {
+		componentsSection.push(`- ${name}
+`);
+	}
+	componentsSection.push("\n");
+	sections.push(...componentsSection);
+	return sections.join("");
+}
+function formatTokenValue(value) {
+	if (typeof value === "object" && value !== null && "val" in value) {
+		return String(value.val);
+	}
+	return String(value);
+}
+function formatMediaQuery(query) {
+	if (typeof query !== "object" || query === null) {
+		return String(query);
+	}
+	const parts = [];
+	if (query.minWidth !== void 0) {
+		parts.push(`min-width: ${query.minWidth}px (screens >= ${query.minWidth}px wide)`);
+	}
+	if (query.maxWidth !== void 0) {
+		parts.push(`max-width: ${query.maxWidth}px (screens <= ${query.maxWidth}px wide)`);
+	}
+	if (query.minHeight !== void 0) {
+		parts.push(`min-height: ${query.minHeight}px (screens >= ${query.minHeight}px tall)`);
+	}
+	if (query.maxHeight !== void 0) {
+		parts.push(`max-height: ${query.maxHeight}px (screens <= ${query.maxHeight}px tall)`);
+	}
+	if (query.hover !== void 0) {
+		parts.push(`pointer: hover (${query.hover})`);
+	}
+	if (query.pointer !== void 0) {
+		parts.push(`pointer: ${query.pointer}`);
+	}
+	if (query.prefersReducedMotion !== void 0) {
+		parts.push(`prefers-reduced-motion: ${query.prefersReducedMotion}`);
+	}
+	if (parts.length === 0) {
+		return JSON.stringify(query);
+	}
+	return parts.join(", ");
+}

package/dist/cjs/extractor/loadTamagui.cjs

@@ -117,6 +117,7 @@ async function loadTamaguiFromModules(propsIn, evaluated) {
 	if (props.outputCSS) {
 		await (0, import_bundleConfig.writeTamaguiCSS)(props.outputCSS, projectInfo.tamaguiConfig);
 	}
+	await (0, import_regenerateConfig.regenerateConfig)(props, projectInfo);
 	return projectInfo;
 }
 let waiting = false;

package/dist/cjs/extractor/regenerateConfig.cjs

@@ -37,33 +37,35 @@ var import_generate_themes = require("@tamagui/generate-themes");
 var import_helpers = require("@tamagui/helpers");
 var import_tooling = require("@tamagui/style-grammar/tooling");
 var import_fs_extra = __toESM(require("fs-extra"), 1);
+var import_generateConfigMarkdown = require("./generateConfigMarkdown.cjs");
 var import_requireTamaguiCore = require("../helpers/requireTamaguiCore.cjs");
 var import_bundleConfig = require("./bundleConfig.cjs");
 async function regenerateConfig(tamaguiOptions, configIn, rebuild = false) {
-	try {
-		const config = configIn ?? await (0, import_bundleConfig.getBundledConfig)(tamaguiOptions, rebuild);
-		if (!config) return;
-		const out = transformConfig(config, tamaguiOptions.platform || "web");
-		const confFile = getConfigFile(tamaguiOptions);
-		await import_fs_extra.default.ensureDir((0, import_node_path.dirname)(confFile));
-		await import_fs_extra.default.writeJSON(confFile, out, { spaces: 2 });
-	} catch (err) {
-		if (process.env.DEBUG?.includes("tamagui") || process.env.IS_TAMAGUI_DEV) {
-			console.warn("regenerateConfig error", err);
+	const config = configIn ?? await (0, import_bundleConfig.getBundledConfig)(tamaguiOptions, rebuild);
+	if (!config) return;
+	const outputs = getConfigOutputs(tamaguiOptions, config);
+	await import_fs_extra.default.ensureDir((0, import_node_path.dirname)(outputs[0][0]));
+	await Promise.all(outputs.map(async ([file, content]) => {
+		if (await import_fs_extra.default.pathExists(file)) {
+			if (await import_fs_extra.default.readFile(file, "utf8") === content) return;
 		}
-	}
+		await import_fs_extra.default.writeFile(file, content);
+	}));
 }
 function regenerateConfigSync(tamaguiOptions, config) {
-	try {
-		const confFile = getConfigFile(tamaguiOptions);
-		import_fs_extra.default.ensureDirSync((0, import_node_path.dirname)(confFile));
-		import_fs_extra.default.writeJSONSync(confFile, transformConfig(config, tamaguiOptions.platform || "web"), { spaces: 2 });
-	} catch (err) {
-		if (process.env.DEBUG?.includes("tamagui") || process.env.IS_TAMAGUI_DEV) {
-			console.warn("regenerateConfig error", err);
-		}
+	const outputs = getConfigOutputs(tamaguiOptions, config);
+	import_fs_extra.default.ensureDirSync((0, import_node_path.dirname)(outputs[0][0]));
+	for (const [file, content] of outputs) {
+		if (import_fs_extra.default.existsSync(file) && import_fs_extra.default.readFileSync(file, "utf8") === content) continue;
+		import_fs_extra.default.writeFileSync(file, content);
 	}
 }
+function getConfigOutputs(options, config) {
+	const out = transformConfig(config, options.platform || "web");
+	const confFile = getConfigFile(options);
+	return [[confFile, `${JSON.stringify(out, null, 2)}
+`], [(0, import_node_path.join)((0, import_node_path.dirname)(confFile), "prompt.md"), (0, import_generateConfigMarkdown.generateConfigMarkdown)(out)]];
+}
 async function generateTamaguiThemes(tamaguiOptions, force = false) {
 	if (!tamaguiOptions.themeBuilder) {
 		return;

package/dist/esm/exports.mjs

@@ -1,6 +1,7 @@
 import { evaluateComponentModule } from "./extractor/bundleConfig.mjs";
 import { clearFormatCache, detectModuleFormat } from "./extractor/detectModuleFormat.mjs";
 import { esbundleTamaguiConfig } from "./extractor/bundle.mjs";
+import { generateConfigMarkdown } from "./extractor/generateConfigMarkdown.mjs";
 
 export * from "./checkDeps.mjs"
 
@@ -26,4 +27,4 @@ export * from "./getPragmaOptions.mjs"
 
 export * from "./zero/index.mjs"
 
-export { clearFormatCache, detectModuleFormat, esbundleTamaguiConfig, evaluateComponentModule };
+export { clearFormatCache, detectModuleFormat, esbundleTamaguiConfig, evaluateComponentModule, generateConfigMarkdown };