@wp-typia/project-tools 0.16.4 → 0.16.6

package/dist/runtime/built-in-block-non-ts-artifacts.js

@@ -0,0 +1,563 @@
+import { renderMustacheTemplateString } from "./template-render.js";
+const BASIC_STYLE_TEMPLATE = `/**
+ * {{title}} Block Styles
+ */
+
+.{{cssClassName}} {
+	padding: 20px;
+	border: 1px solid #ddd;
+	border-radius: 4px;
+	background-color: #fff;
+	box-shadow: 0 1px 3px rgba(0, 0, 0, 0.05);
+
+	&.is-hidden {
+		display: none;
+	}
+
+	&__content {
+		font-size: 16px;
+		line-height: 1.6;
+		color: #333;
+
+		// Alignment styles
+		&[data-align="center"] {
+			text-align: center;
+		}
+
+		&[data-align="right"] {
+			text-align: right;
+		}
+
+		&[data-align="justify"] {
+			text-align: justify;
+		}
+	}
+
+	// Hover state
+	&:hover {
+		box-shadow: 0 2px 5px rgba(0, 0, 0, 0.1);
+		transition: box-shadow 0.2s ease;
+	}
+}
+`;
+const BASIC_EDITOR_STYLE_TEMPLATE = `/**
+ * {{title}} Block Editor Styles
+ */
+
+.{{cssClassName}} {
+	outline: 1px dashed #ddd;
+	outline-offset: -1px;
+}
+`;
+const BASIC_RENDER_TEMPLATE = `<?php
+/**
+ * Optional server render placeholder for {{title}}.
+ *
+ * The basic scaffold stays static by default. Keep \`src/save.tsx\` as the
+ * canonical frontend output unless you intentionally convert this block into a
+ * dynamic render path and add \`render\` to \`block.json\`.
+ *
+ * @package {{slug}}
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+?>
+<div class="{{cssClassName}}__server-placeholder" hidden>
+	<?php esc_html_e( 'Server render placeholder.', '{{textDomain}}' ); ?>
+</div>
+`;
+const INTERACTIVITY_STYLE_TEMPLATE = `.{{cssClassName}} {
+  position: relative;
+  padding: 1rem;
+  border: 1px solid #dcdcde;
+  border-radius: 0.75rem;
+  background: #fff;
+
+  &__content {
+    display: grid;
+    gap: 0.75rem;
+  }
+
+  &__counter {
+    display: inline-flex;
+    gap: 0.35rem;
+    align-items: center;
+    font-size: 0.9rem;
+    font-weight: 600;
+  }
+
+  &__progress {
+    width: 100%;
+    height: 0.5rem;
+    overflow: hidden;
+    background: #f0f0f1;
+    border-radius: 999px;
+  }
+
+  &__progress-bar {
+    height: 100%;
+    background: #3858e9;
+    transition: width 0.2s ease;
+  }
+
+  &__animation {
+    min-height: 1.5rem;
+    font-size: 0.85rem;
+    color: #3858e9;
+    opacity: 0;
+    transition: opacity 0.2s ease;
+
+    &.is-active {
+      opacity: 1;
+    }
+  }
+
+  &__completion {
+    font-weight: 700;
+    color: #06752d;
+  }
+
+  &__reset {
+    align-self: start;
+    padding: 0.4rem 0.7rem;
+    border: 1px solid #dcdcde;
+    border-radius: 999px;
+    background: transparent;
+    cursor: pointer;
+  }
+}
+`;
+const INTERACTIVITY_EDITOR_STYLE_TEMPLATE = `/**
+ * {{title}} Block Editor Styles
+ */
+
+.{{cssClassName}} {
+	outline: 1px dashed #ddd;
+	outline-offset: -1px;
+}
+`;
+const PERSISTENCE_STYLE_TEMPLATE = `.{{cssClassName}} {
+	border: 1px solid #dcdcde;
+	border-radius: 12px;
+	padding: 16px;
+	background: #fff;
+
+	&__meta {
+		color: #50575e;
+		font-size: 13px;
+		margin: 8px 0 0;
+	}
+}
+
+.{{frontendCssClassName}} {
+	display: grid;
+	gap: 12px;
+	border: 1px solid #dcdcde;
+	border-radius: 12px;
+	padding: 16px;
+	background: #f6f7f7;
+
+	&__count {
+		display: inline-flex;
+		min-width: 3rem;
+		justify-content: center;
+		font-weight: 700;
+	}
+
+	&__notice,
+	&__error {
+		margin: 0;
+		font-size: 13px;
+	}
+
+	&__notice {
+		color: #50575e;
+	}
+
+	&__error {
+		color: #b32d2e;
+	}
+
+	button {
+		width: fit-content;
+	}
+}
+`;
+const PERSISTENCE_RENDER_TEMPLATE = `<?php
+/**
+ * Dynamic render entry for the {{title}} block.
+ *
+ * @package {{pascalCase}}
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+$validator_path = __DIR__ . '/typia-validator.php';
+if ( ! file_exists( $validator_path ) ) {
+	return '';
+}
+
+$validator = require $validator_path;
+if ( ! is_object( $validator ) || ! method_exists( $validator, 'apply_defaults' ) || ! method_exists( $validator, 'validate' ) ) {
+	return '';
+}
+
+$normalized   = $validator->apply_defaults( is_array( $attributes ) ? $attributes : array() );
+$validation   = $validator->validate( $normalized );
+$resource_key = isset( $normalized['resourceKey'] ) ? (string) $normalized['resourceKey'] : '';
+
+if ( empty( $validation['valid'] ) || '' === $resource_key ) {
+	return '';
+}
+
+$alignment          = isset( $normalized['alignment'] ) ? (string) $normalized['alignment'] : 'left';
+$button_label       = isset( $normalized['buttonLabel'] ) ? (string) $normalized['buttonLabel'] : 'Persist Count';
+$content            = isset( $normalized['content'] ) ? (string) $normalized['content'] : '';
+$post_id            = is_object( $block ) && isset( $block->context['postId'] )
+	? (int) $block->context['postId']
+	: (int) get_queried_object_id();
+$storage_mode       = '{{dataStorageMode}}';
+$persistence_policy = '{{persistencePolicy}}';
+
+{{phpPrefix}}_record_rendered_block_instance(
+	(int) $post_id,
+	'{{namespace}}/{{slugKebabCase}}',
+	$resource_key
+);
+
+$notice_message     = 'authenticated' === $persistence_policy
+	? __( 'Sign in to persist this counter.', '{{textDomain}}' )
+	: __( 'Public writes are temporarily unavailable.', '{{textDomain}}' );
+$context            = array(
+	'bootstrapReady'       => false,
+	'buttonLabel'          => $button_label,
+	'canWrite'             => false,
+	'client'               => array(
+		'writeExpiry' => 0,
+		'writeNonce'  => '',
+		'writeToken'  => '',
+	),
+	'count'                => 0,
+	'error'                => '',
+	'isBootstrapping'      => false,
+	'isLoading'            => false,
+	'isSaving'             => false,
+	'isVisible'            => ! empty( $normalized['isVisible'] ),
+	'persistencePolicy'    => $persistence_policy,
+	'postId'               => (int) $post_id,
+	'resourceKey'          => $resource_key,
+	'storage'              => $storage_mode,
+);
+
+$wrapper_attributes = get_block_wrapper_attributes(
+	array(
+		'data-wp-context'       => wp_json_encode( $context ),
+		'data-wp-interactive'   => '{{slugKebabCase}}',
+		'data-wp-init'          => 'callbacks.init',
+		'data-wp-run--mounted' => 'callbacks.mounted',
+	)
+);
+?>
+
+<div <?php echo $wrapper_attributes; ?>>
+	<div class="{{frontendCssClassName}}">
+		<p class="{{frontendCssClassName}}__content" style="<?php echo esc_attr( 'text-align:' . $alignment ); ?>">
+			<?php echo esc_html( $content ); ?>
+		</p>
+		<p
+			class="{{frontendCssClassName}}__notice"
+			data-wp-bind--hidden="!context.bootstrapReady || context.canWrite"
+			hidden
+		>
+			<?php echo esc_html( $notice_message ); ?>
+		</p>
+		<p
+			class="{{frontendCssClassName}}__error"
+			role="status"
+			aria-live="polite"
+			aria-atomic="true"
+			data-wp-bind--hidden="!context.error"
+			data-wp-text="context.error"
+			hidden
+		></p>
+		<?php if ( ! empty( $normalized['showCount'] ) ) : ?>
+			<span
+				class="{{frontendCssClassName}}__count"
+				role="status"
+				aria-live="polite"
+				aria-atomic="true"
+				data-wp-text="context.count"
+			>
+				0
+			</span>
+		<?php endif; ?>
+		<button
+			type="button"
+			disabled
+			data-wp-bind--disabled="!context.canWrite"
+			data-wp-on--click="actions.increment"
+		>
+			<?php echo esc_html( $button_label ); ?>
+		</button>
+	</div>
+</div>
+`;
+const COMPOUND_STYLE_TEMPLATE = `.{{cssClassName}} {
+	border: 1px solid #dcdcde;
+	border-radius: 12px;
+	padding: 1.25rem;
+	background: #fff;
+}
+
+.{{cssClassName}}__heading {
+	margin: 0 0 0.5rem;
+	font-size: 1.2rem;
+}
+
+.{{cssClassName}}__intro {
+	margin: 0 0 1rem;
+	color: #50575e;
+}
+
+.{{cssClassName}}__items {
+	display: grid;
+	gap: 0.75rem;
+}
+
+.{{cssClassName}}[data-show-dividers='true'] .{{compoundChildCssClassName}} {
+	border-top: 1px solid #dcdcde;
+	padding-top: 0.75rem;
+}
+
+.{{cssClassName}}[data-show-dividers='true'] .{{compoundChildCssClassName}}:first-child {
+	border-top: 0;
+	padding-top: 0;
+}
+`;
+function renderArtifact(relativePath, template, view) {
+    const source = renderMustacheTemplateString(template, view);
+    return {
+        relativePath,
+        source: source.endsWith("\n") ? source : `${source}\n`,
+    };
+}
+function toPhpSingleQuotedString(value) {
+    return `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+}
+function buildBasicArtifacts(variables) {
+    return [
+        renderArtifact("src/editor.scss", BASIC_EDITOR_STYLE_TEMPLATE, variables),
+        renderArtifact("src/style.scss", BASIC_STYLE_TEMPLATE, variables),
+        renderArtifact("src/render.php", BASIC_RENDER_TEMPLATE, variables),
+    ];
+}
+function buildInteractivityArtifacts(variables) {
+    return [
+        renderArtifact("src/editor.scss", INTERACTIVITY_EDITOR_STYLE_TEMPLATE, variables),
+        renderArtifact("src/style.scss", INTERACTIVITY_STYLE_TEMPLATE, variables),
+    ];
+}
+function buildPersistenceArtifacts(variables) {
+    return [
+        renderArtifact("src/style.scss", PERSISTENCE_STYLE_TEMPLATE, variables),
+        renderArtifact("src/render.php", PERSISTENCE_RENDER_TEMPLATE, variables),
+    ];
+}
+function buildCompoundArtifacts(variables) {
+    const artifacts = [
+        renderArtifact(`src/blocks/${variables.slugKebabCase}/style.scss`, COMPOUND_STYLE_TEMPLATE, variables),
+    ];
+    if (variables.compoundPersistenceEnabled === "true") {
+        const renderView = {
+            ...variables,
+            titlePhpLiteral: toPhpSingleQuotedString(variables.title),
+        };
+        const renderSource = `<?php
+/**
+ * Dynamic render entry for the {{title}} compound parent block.
+ *
+ * @package {{pascalCase}}
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+$validator_path = __DIR__ . '/typia-validator.php';
+if ( ! file_exists( $validator_path ) ) {
+	return '';
+}
+
+$validator = require $validator_path;
+if ( ! is_object( $validator ) || ! method_exists( $validator, 'apply_defaults' ) || ! method_exists( $validator, 'validate' ) ) {
+	return '';
+}
+
+$normalized         = $validator->apply_defaults( is_array( $attributes ) ? $attributes : array() );
+$validation         = $validator->validate( $normalized );
+$resource_key       = isset( $normalized['resourceKey'] ) ? (string) $normalized['resourceKey'] : '';
+$heading            = isset( $normalized['heading'] ) ? (string) $normalized['heading'] : {{titlePhpLiteral}};
+$intro              = isset( $normalized['intro'] ) ? (string) $normalized['intro'] : '';
+$button_label       = isset( $normalized['buttonLabel'] ) ? (string) $normalized['buttonLabel'] : 'Persist Count';
+$show_count         = ! empty( $normalized['showCount'] );
+$show_dividers      = ! empty( $normalized['showDividers'] );
+$post_id            = is_object( $block ) && isset( $block->context['postId'] )
+	? (int) $block->context['postId']
+	: (int) get_queried_object_id();
+$storage_mode       = '{{dataStorageMode}}';
+$persistence_policy = '{{persistencePolicy}}';
+
+{{phpPrefix}}_record_rendered_block_instance(
+	(int) $post_id,
+	'{{namespace}}/{{slugKebabCase}}',
+	$resource_key
+);
+
+$notice_message    = 'authenticated' === $persistence_policy
+	? __( 'Sign in to persist this counter.', '{{textDomain}}' )
+	: __( 'Public writes are temporarily unavailable.', '{{textDomain}}' );
+
+if ( empty( $validation['valid'] ) || '' === $resource_key ) {
+	return '';
+}
+
+$context = array(
+	'bootstrapReady'       => false,
+	'buttonLabel'          => $button_label,
+	'canWrite'             => false,
+	'client'               => array(
+		'writeExpiry' => 0,
+		'writeNonce'  => '',
+		'writeToken'  => '',
+	),
+	'count'                => 0,
+	'error'                => '',
+	'isBootstrapping'      => false,
+	'isLoading'            => false,
+	'isSaving'             => false,
+	'persistencePolicy'    => $persistence_policy,
+	'postId'               => (int) $post_id,
+	'resourceKey'          => $resource_key,
+	'showCount'            => $show_count,
+	'storage'              => $storage_mode,
+);
+
+$allowed_inner_html = wp_kses_allowed_html( 'post' );
+
+foreach ( $allowed_inner_html as &$allowed_attributes ) {
+	if ( ! is_array( $allowed_attributes ) ) {
+		continue;
+	}
+
+	$allowed_attributes['data-wp-bind--disabled'] = true;
+	$allowed_attributes['data-wp-bind--hidden'] = true;
+	$allowed_attributes['data-wp-bind--value'] = true;
+	$allowed_attributes['data-wp-class'] = true;
+	$allowed_attributes['data-wp-class--active'] = true;
+	$allowed_attributes['data-wp-context'] = true;
+	$allowed_attributes['data-wp-init'] = true;
+	$allowed_attributes['data-wp-interactive'] = true;
+	$allowed_attributes['data-wp-on--click'] = true;
+	$allowed_attributes['data-wp-on--mouseenter'] = true;
+	$allowed_attributes['data-wp-on--mouseleave'] = true;
+	$allowed_attributes['data-wp-run--mounted'] = true;
+	$allowed_attributes['data-wp-style--width'] = true;
+	$allowed_attributes['data-wp-text'] = true;
+}
+unset( $allowed_attributes );
+
+$sanitized_content = wp_kses( $content, $allowed_inner_html );
+
+$wrapper_attributes = get_block_wrapper_attributes(
+	array(
+		'class'                => '{{cssClassName}}',
+		'data-show-dividers'   => $show_dividers ? 'true' : 'false',
+		'data-wp-context'      => wp_json_encode( $context ),
+		'data-wp-init'         => 'callbacks.init',
+		'data-wp-interactive'  => '{{slugKebabCase}}',
+		'data-wp-run--mounted' => 'callbacks.mounted',
+	)
+);
+?>
+
+<div <?php echo $wrapper_attributes; ?>>
+	<h3 class="{{cssClassName}}__heading"><?php echo esc_html( $heading ); ?></h3>
+	<?php if ( '' !== $intro ) : ?>
+		<p class="{{cssClassName}}__intro"><?php echo esc_html( $intro ); ?></p>
+	<?php endif; ?>
+	<p
+		class="{{cssClassName}}__notice"
+		data-wp-bind--hidden="!context.bootstrapReady || context.canWrite"
+		hidden
+	>
+		<?php echo esc_html( $notice_message ); ?>
+	</p>
+	<p
+		class="{{cssClassName}}__error"
+		role="status"
+		aria-live="polite"
+		aria-atomic="true"
+		data-wp-bind--hidden="!context.error"
+		data-wp-text="context.error"
+		hidden
+	></p>
+	<?php if ( $show_count ) : ?>
+		<div class="{{cssClassName}}__counter">
+			<span
+				class="{{cssClassName}}__count"
+				role="status"
+				aria-live="polite"
+				aria-atomic="true"
+				data-wp-text="context.count"
+			>0</span>
+			<button
+				type="button"
+				disabled
+				data-wp-bind--disabled="!context.canWrite"
+				data-wp-on--click="actions.increment"
+			>
+				<?php echo esc_html( $button_label ); ?>
+			</button>
+		</div>
+	<?php endif; ?>
+	<div class="{{cssClassName}}__items">
+		<?php echo $sanitized_content; ?>
+	</div>
+</div>
+`;
+        artifacts.push(renderArtifact(`src/blocks/${variables.slugKebabCase}/render.php`, renderSource, renderView));
+    }
+    return artifacts;
+}
+/**
+ * Builds non-TypeScript scaffold artifacts for built-in block templates.
+ *
+ * @param options Build options for the selected built-in template family.
+ * @param options.templateId Built-in template identifier that controls which
+ * non-TS files should be emitted.
+ * @param options.variables Scaffold template variables used to render the
+ * generated sources.
+ * @returns An array of emitter-owned SCSS and PHP artifacts for the selected
+ * built-in template family.
+ */
+export function buildBuiltInNonTsArtifacts({ templateId, variables, }) {
+    switch (templateId) {
+        case "basic":
+            return buildBasicArtifacts(variables);
+        case "interactivity":
+            return buildInteractivityArtifacts(variables);
+        case "persistence":
+            return buildPersistenceArtifacts(variables);
+        case "compound":
+            return buildCompoundArtifacts(variables);
+        default: {
+            const unhandledTemplateId = templateId;
+            throw new Error(`Unhandled built-in template id: ${unhandledTemplateId}`);
+        }
+    }
+}

package/dist/runtime/cli-doctor.js

@@ -3,7 +3,7 @@ import os from "node:os";
 import path from "node:path";
 import { execFileSync } from "node:child_process";
 import { access, constants as fsConstants, rm, writeFile } from "node:fs/promises";
-import { getBuiltInTemplateLayerDirs } from "./template-builtins.js";
+import { getBuiltInTemplateLayerDirs, isOmittableBuiltInTemplateLayerDir, } from "./template-builtins.js";
 import { HOOKED_BLOCK_ANCHOR_PATTERN, HOOKED_BLOCK_POSITION_SET, } from "./hooked-blocks.js";
 import { isBuiltInTemplateId, listTemplates } from "./template-registry.js";
 import { readWorkspaceInventory } from "./workspace-inventory.js";
@@ -319,13 +319,18 @@ export async function getDoctorChecks(cwd) {
                     }),
                 ]))
                 : getBuiltInTemplateLayerDirs(builtInTemplateId);
-        const hasAssets = layerDirs.every((layerDir) => fs.existsSync(layerDir)) &&
-            layerDirs.some((layerDir) => fs.existsSync(path.join(layerDir, "package.json.mustache"))) &&
-            layerDirs.some((layerDir) => fs.existsSync(path.join(layerDir, "src")));
+        const missingRequiredLayer = layerDirs.some((layerDir) => !fs.existsSync(layerDir) &&
+            !isOmittableBuiltInTemplateLayerDir(builtInTemplateId, layerDir));
+        const existingLayerDirs = layerDirs.filter((layerDir) => fs.existsSync(layerDir));
+        const hasAssets = !missingRequiredLayer &&
+            existingLayerDirs.some((layerDir) => fs.existsSync(path.join(layerDir, "package.json.mustache"))) &&
+            existingLayerDirs.some((layerDir) => fs.existsSync(path.join(layerDir, "src")));
         checks.push({
             status: hasAssets ? "pass" : "fail",
             label: `Template ${template.id}`,
-            detail: hasAssets ? layerDirs.join(" + ") : "Missing core template assets",
+            detail: hasAssets
+                ? existingLayerDirs.join(" + ")
+                : "Missing core template assets",
         });
     }
     let workspace = null;

package/dist/runtime/template-builtins.d.ts

@@ -27,6 +27,15 @@ export interface MaterializedBuiltInTemplateSource {
  * resolve to the shared base plus their own template directory.
  */
 export declare function getBuiltInTemplateLayerDirs(templateId: BuiltInTemplateId, { persistenceEnabled, persistencePolicy, }?: BuiltInTemplateVariantOptions): string[];
+/**
+ * Returns whether a missing built-in overlay directory is expected because the
+ * template family no longer ships any Mustache assets in that layer.
+ *
+ * @param templateId Built-in template family being resolved.
+ * @param layerDir Candidate overlay directory for that family.
+ * @returns True when the missing layer can be skipped safely.
+ */
+export declare function isOmittableBuiltInTemplateLayerDir(templateId: BuiltInTemplateId, layerDir: string): boolean;
 /**
  * Materializes a built-in template into a temporary directory by copying each
  * resolved layer in order.

package/dist/runtime/template-builtins.js

@@ -1,7 +1,13 @@
+import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { promises as fsp } from "node:fs";
 import { getTemplateById, SHARED_BASE_TEMPLATE_ROOT, SHARED_COMPOUND_TEMPLATE_ROOT, SHARED_PERSISTENCE_TEMPLATE_ROOT, SHARED_REST_HELPER_TEMPLATE_ROOT, } from "./template-registry.js";
+const OMITTABLE_BUILT_IN_OVERLAY_TEMPLATE_IDS = new Set([
+    "basic",
+    "persistence",
+    "compound",
+]);
 /**
  * Returns the ordered overlay directories for a built-in template.
  *
@@ -33,6 +39,29 @@ export function getBuiltInTemplateLayerDirs(templateId, { persistenceEnabled = f
     }
     return [SHARED_BASE_TEMPLATE_ROOT, getTemplateById(templateId).templateDir];
 }
+/**
+ * Returns whether a missing built-in overlay directory is expected because the
+ * template family no longer ships any Mustache assets in that layer.
+ *
+ * @param templateId Built-in template family being resolved.
+ * @param layerDir Candidate overlay directory for that family.
+ * @returns True when the missing layer can be skipped safely.
+ */
+export function isOmittableBuiltInTemplateLayerDir(templateId, layerDir) {
+    return (OMITTABLE_BUILT_IN_OVERLAY_TEMPLATE_IDS.has(templateId) &&
+        layerDir === getTemplateById(templateId).templateDir);
+}
+function resolveMaterializedBuiltInTemplateLayerDirs(templateId, options) {
+    return getBuiltInTemplateLayerDirs(templateId, options).flatMap((layerDir) => {
+        if (fs.existsSync(layerDir)) {
+            return [layerDir];
+        }
+        if (isOmittableBuiltInTemplateLayerDir(templateId, layerDir)) {
+            return [];
+        }
+        throw new Error(`Built-in template layer is missing: ${layerDir}`);
+    });
+}
 /**
  * Materializes a built-in template into a temporary directory by copying each
  * resolved layer in order.
@@ -43,11 +72,12 @@ export function getBuiltInTemplateLayerDirs(templateId, { persistenceEnabled = f
  */
 export async function resolveBuiltInTemplateSource(templateId, options = {}) {
     const template = getTemplateById(templateId);
+    const layerDirs = resolveMaterializedBuiltInTemplateLayerDirs(templateId, options);
     const tempRoot = await fsp.mkdtemp(path.join(os.tmpdir(), "wp-typia-template-"));
     const templateDir = path.join(tempRoot, templateId);
     try {
         await fsp.mkdir(templateDir, { recursive: true });
-        for (const layerDir of getBuiltInTemplateLayerDirs(templateId, options)) {
+        for (const layerDir of layerDirs) {
             await fsp.cp(layerDir, templateDir, {
                 recursive: true,
                 force: true,

package/dist/runtime/template-source.js

@@ -9,10 +9,10 @@ import { pathToFileURL } from "node:url";
 import npa from "npm-package-arg";
 import semver from "semver";
 import { x as extractTarball } from "tar";
-import { BUILTIN_TEMPLATE_IDS, PROJECT_TOOLS_PACKAGE_ROOT, SHARED_BASE_TEMPLATE_ROOT, TEMPLATE_ROOT, isBuiltInTemplateId, } from "./template-registry.js";
+import { BUILTIN_TEMPLATE_IDS, PROJECT_TOOLS_PACKAGE_ROOT, isBuiltInTemplateId, } from "./template-registry.js";
 import { isPlainObject } from "./object-utils.js";
 import { getRemovedBuiltInTemplateMessage, isRemovedBuiltInTemplateId, } from "./template-defaults.js";
-import { resolveBuiltInTemplateSource } from "./template-builtins.js";
+import { getBuiltInTemplateLayerDirs, isOmittableBuiltInTemplateLayerDir, resolveBuiltInTemplateSource, } from "./template-builtins.js";
 import { getPackageVersions } from "./package-versions.js";
 import { toSegmentPascalCase } from "./string-case.js";
 import { copyRawDirectory, copyRenderedDirectory } from "./template-render.js";
@@ -522,7 +522,13 @@ async function normalizeCreateBlockSubset(seed, context) {
     const blockJson = readRemoteBlockJson(seed.blockDir);
     const sourceRoot = getSeedSourceRoot(seed.blockDir);
     await fsp.mkdir(templateDir, { recursive: true });
-    for (const layerDir of [SHARED_BASE_TEMPLATE_ROOT, path.join(TEMPLATE_ROOT, "basic")]) {
+    for (const layerDir of getBuiltInTemplateLayerDirs("basic")) {
+        if (!fs.existsSync(layerDir)) {
+            if (isOmittableBuiltInTemplateLayerDir("basic", layerDir)) {
+                continue;
+            }
+            throw new Error(`Built-in template layer is missing: ${layerDir}`);
+        }
         await fsp.cp(layerDir, templateDir, {
             recursive: true,
             force: true,