@wp-typia/project-tools 0.16.6 → 0.16.8

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

@@ -26,4 +26,19 @@ export declare function renderMustacheTemplateString(template: string, view: Tem
 export declare function copyRawDirectory(sourceDir: string, targetDir: string, options?: CopyRawDirectoryOptions): Promise<void>;
 export declare function copyRenderedDirectory(sourceDir: string, targetDir: string, view: TemplateRenderView): Promise<void>;
 export declare function copyInterpolatedDirectory(sourceDir: string, targetDir: string, view: Record<string, string>): Promise<void>;
+/**
+ * Lists the output file paths produced by an interpolated template directory
+ * without writing any files to disk.
+ *
+ * This walks the source directory, applies the same filename interpolation and
+ * `.mustache` stripping rules as `copyInterpolatedDirectory(...)`, and returns
+ * normalized output-relative paths under a virtual root.
+ *
+ * @param sourceDir - The template directory to traverse.
+ * @param view - The interpolation map used when resolving file and directory
+ * names.
+ * @returns A sorted array of normalized output paths relative to a virtual
+ * preview root.
+ */
+export declare function listInterpolatedDirectoryOutputs(sourceDir: string, view: Record<string, string>): Promise<string[]>;
 export declare function pathExists(targetPath: string): boolean;

package/dist/runtime/template-render.js

@@ -118,6 +118,42 @@ export async function copyInterpolatedDirectory(sourceDir, targetDir, view) {
         await fsp.writeFile(destinationPath, renderInterpolatedString(content, view), "utf8");
     }
 }
+/**
+ * Lists the output file paths produced by an interpolated template directory
+ * without writing any files to disk.
+ *
+ * This walks the source directory, applies the same filename interpolation and
+ * `.mustache` stripping rules as `copyInterpolatedDirectory(...)`, and returns
+ * normalized output-relative paths under a virtual root.
+ *
+ * @param sourceDir - The template directory to traverse.
+ * @param view - The interpolation map used when resolving file and directory
+ * names.
+ * @returns A sorted array of normalized output paths relative to a virtual
+ * preview root.
+ */
+export async function listInterpolatedDirectoryOutputs(sourceDir, view) {
+    const virtualRoot = path.resolve("/wp-typia-template-preview");
+    const outputs = [];
+    async function visit(currentSourceDir, currentTargetDir) {
+        const entries = await fsp.readdir(currentSourceDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const sourcePath = path.join(currentSourceDir, entry.name);
+            const destinationNameTemplate = entry.name.endsWith(".mustache")
+                ? entry.name.slice(0, -".mustache".length)
+                : entry.name;
+            const destinationName = renderInterpolatedString(destinationNameTemplate, view);
+            const destinationPath = resolveRenderedPath(currentTargetDir, destinationName);
+            if (entry.isDirectory()) {
+                await visit(sourcePath, destinationPath);
+                continue;
+            }
+            outputs.push(path.relative(virtualRoot, destinationPath).replace(/\\/g, "/"));
+        }
+    }
+    await visit(sourceDir, virtualRoot);
+    return outputs.sort((left, right) => left.localeCompare(right));
+}
 export function pathExists(targetPath) {
     return fs.existsSync(targetPath);
 }

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

@@ -52,6 +52,14 @@ interface NpmTemplateLocator {
     rawSpec: string;
     type: string;
 }
+interface SeedSource {
+    assetsDir?: string;
+    blockDir: string;
+    cleanup?: () => Promise<void>;
+    rootDir: string;
+    selectedVariant?: string | null;
+    warnings?: string[];
+}
 type RemoteTemplateLocator = {
     kind: "github";
     locator: GitHubTemplateLocator;
@@ -65,6 +73,15 @@ type RemoteTemplateLocator = {
 export declare function parseGitHubTemplateLocator(templateId: string): GitHubTemplateLocator | null;
 export declare function parseNpmTemplateLocator(templateId: string): NpmTemplateLocator | null;
 export declare function parseTemplateLocator(templateId: string): RemoteTemplateLocator;
+/**
+ * Resolves a template locator into a local seed source directory.
+ *
+ * @param locator Remote template locator describing a local path, GitHub source, or npm package.
+ * @param cwd Current working directory used to resolve local template paths.
+ * @returns A local seed source containing the resolved root and block directory, plus optional cleanup.
+ * @throws When the locator is invalid, the source cannot be fetched, or filesystem validation fails.
+ */
+export declare function resolveTemplateSeed(locator: RemoteTemplateLocator, cwd: string): Promise<SeedSource>;
 export declare function resolveTemplateSource(templateId: string, cwd: string, variables: {
     [key: string]: string;
 }, variant?: string): Promise<ResolvedTemplateSource>;

package/dist/runtime/template-source.js

@@ -9,16 +9,16 @@ 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, isBuiltInTemplateId, } from "./template-registry.js";
+import { BUILTIN_TEMPLATE_IDS, OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, PROJECT_TOOLS_PACKAGE_ROOT, isBuiltInTemplateId, } from "./template-registry.js";
 import { isPlainObject } from "./object-utils.js";
 import { getRemovedBuiltInTemplateMessage, isRemovedBuiltInTemplateId, } from "./template-defaults.js";
 import { getBuiltInTemplateLayerDirs, isOmittableBuiltInTemplateLayerDir, resolveBuiltInTemplateSource, } from "./template-builtins.js";
+import { loadExternalTemplateLayerManifest } from "./template-layers.js";
 import { getPackageVersions } from "./package-versions.js";
 import { toSegmentPascalCase } from "./string-case.js";
 import { copyRawDirectory, copyRenderedDirectory } from "./template-render.js";
 const EXTERNAL_TEMPLATE_ENTRY_CANDIDATES = ["index.js", "index.cjs", "index.mjs"];
 const TEMPLATE_WARNING_MESSAGE = "wp-typia owns package/tooling/sync setup for generated projects, so this external template setting is ignored.";
-const OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE = "@wp-typia/create-workspace-template";
 function isTemplatePathLocator(templateId) {
     return path.isAbsolute(templateId) || templateId.startsWith("./") || templateId.startsWith("../");
 }
@@ -316,6 +316,9 @@ async function detectTemplateSourceFormat(sourceDir) {
     if (fs.existsSync(path.join(sourceDir, "package.json.mustache"))) {
         return "wp-typia";
     }
+    if (await loadExternalTemplateLayerManifest(sourceDir)) {
+        throw new Error(`Template source at ${sourceDir} is an external layer package. External layers currently compose only through built-in scaffolds via the runtime API, not as standalone template ids.`);
+    }
     if (getExternalTemplateEntry(sourceDir)) {
         return "create-block-external";
     }
@@ -729,7 +732,15 @@ async function resolveGitHubTemplateSource(locator) {
         throw error;
     }
 }
-async function resolveTemplateSeed(locator, cwd) {
+/**
+ * Resolves a template locator into a local seed source directory.
+ *
+ * @param locator Remote template locator describing a local path, GitHub source, or npm package.
+ * @param cwd Current working directory used to resolve local template paths.
+ * @returns A local seed source containing the resolved root and block directory, plus optional cleanup.
+ * @throws When the locator is invalid, the source cannot be fetched, or filesystem validation fails.
+ */
+export async function resolveTemplateSeed(locator, cwd) {
     if (locator.kind === "path") {
         const sourceDir = path.resolve(cwd, locator.templatePath);
         if (!fs.existsSync(sourceDir)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.16.6",
+  "version": "0.16.8",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -75,7 +75,7 @@
     "prepack": "bun run build && node ./scripts/publish-manifest.mjs prepare",
     "postpack": "node ./scripts/publish-manifest.mjs restore",
     "test": "bun run build && bun test tests/*.test.ts",
-    "test:scaffold-core": "bun run build && bun test tests/block-generator-service.test.ts tests/built-in-block-artifacts.test.ts tests/scaffold-basic.test.ts tests/scaffold-persistence.test.ts tests/template-source.test.ts tests/cli-entry.test.ts tests/import-policy.test.ts",
+    "test:scaffold-core": "bun run build && bun test tests/block-generator-service.test.ts tests/built-in-block-artifacts.test.ts tests/scaffold-basic.test.ts tests/scaffold-persistence.test.ts tests/template-source.test.ts tests/cli-entry.test.ts tests/cli-prompt.test.ts tests/import-policy.test.ts",
     "test:workspace": "bun run build && bun test tests/workspace-add.test.ts tests/workspace-doctor.test.ts",
     "test:compound": "bun run build && bun test tests/scaffold-compound.test.ts",
     "test:migration-planning": "bun run build && bun test tests/migration-init.test.ts tests/migration-config.test.ts tests/migration-plan-wizard.test.ts",
@@ -114,9 +114,9 @@
     "bun": ">=1.3.11"
   },
   "dependencies": {
-    "@wp-typia/api-client": "^0.4.3",
-    "@wp-typia/block-runtime": "^0.4.6",
-    "@wp-typia/rest": "^0.3.6",
+    "@wp-typia/api-client": "^0.4.4",
+    "@wp-typia/block-runtime": "^0.4.7",
+    "@wp-typia/rest": "^0.3.7",
     "@wp-typia/block-types": "^0.2.1",
     "mustache": "^4.2.0",
     "npm-package-arg": "^13.0.0",
@@ -126,8 +126,6 @@
     "typescript": "^5.9.2"
   },
   "devDependencies": {
-    "react": "^19.2.0",
-    "react-devtools-core": "^7.0.1",
-    "ws": "^8.18.0"
+    "react": "^19.2.0"
   }
 }

package/templates/_shared/base/package.json.mustache

@@ -28,6 +28,7 @@
     "@wordpress/scripts": "^30.22.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "@typia/unplugin": "^12.0.1",
+    "prettier": "3.8.2",
     "tsx": "^4.20.5",
     "typescript": "^5.9.2",
     "typia": "^12.0.1"

package/templates/_shared/compound/core/package.json.mustache

@@ -31,7 +31,7 @@
     "@types/wordpress__blocks": "^12.5.18",
     "ajv": "^8.18.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
-    "prettier": "2.8.8",
+    "prettier": "3.8.2",
     "tsx": "^4.20.5",
     "typescript": "^5.9.2",
     "typia": "^12.0.1"

package/templates/_shared/compound/core/scripts/add-compound-child.ts.mustache

@@ -460,7 +460,8 @@ function renderEditFile(
 ): string {
 	const childCssClassName = buildBlockCssClassName( PARENT_BLOCK_NAMESPACE, childFolderSlug );
 
-	return `import { RichText, useBlockProps } from '@wordpress/block-editor';
+	return `import type { BlockEditProps } from '@wordpress/blocks';
+import { RichText, useBlockProps } from '@wordpress/block-editor';
 import { Notice } from '@wordpress/components';
 import { __ } from '@wordpress/i18n';
 
@@ -471,13 +472,12 @@ import {
 \tvalidate${ childInterfaceName },
 } from './validators';
 
+type EditProps = BlockEditProps< ${ childTypeName } >;
+
 export default function Edit( {
 \tattributes,
 \tsetAttributes,
-}: {
-\tattributes: ${ childTypeName };
-\tsetAttributes: ( attrs: Partial< ${ childTypeName } > ) => void;
-} ) {
+}: EditProps ) {
 \tconst updateAttribute = createAttributeUpdater( attributes, setAttributes );
 \tconst { errorMessages, isValid } = useTypiaValidation(
 \t\tattributes,

package/templates/_shared/compound/persistence/package.json.mustache

@@ -34,7 +34,7 @@
     "@types/wordpress__blocks": "^12.5.18",
     "ajv": "^8.18.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
-    "prettier": "2.8.8",
+    "prettier": "3.8.2",
     "tsx": "^4.20.5",
     "typescript": "^5.9.2",
     "typia": "^12.0.1"

package/templates/_shared/persistence/core/package.json.mustache

@@ -31,6 +31,7 @@
 		"@wordpress/scripts": "^30.22.0",
 		"eslint-plugin-jsx-a11y": "^6.10.2",
 		"@typia/unplugin": "^12.0.1",
+		"prettier": "3.8.2",
 		"tsx": "^4.20.5",
 		"typescript": "^5.9.2",
 		"typia": "^12.0.1"

package/templates/interactivity/package.json.mustache

@@ -25,9 +25,10 @@
 		"@types/wordpress__block-editor": "^11.5.17",
 		"@types/wordpress__blocks": "^12.5.18",
 		"@wordpress/browserslist-config": "^6.42.0",
-    "@wordpress/scripts": "^30.22.0",
+		"@wordpress/scripts": "^30.22.0",
 		"eslint-plugin-jsx-a11y": "^6.10.2",
 		"@typia/unplugin": "^12.0.1",
+		"prettier": "3.8.2",
 		"tsx": "^4.20.5",
 		"typescript": "^5.9.2",
 		"typia": "^12.0.1"