@wp-typia/project-tools 0.16.2 → 0.16.5

package/dist/runtime/starter-manifests.js

@@ -1,378 +1,28 @@
-const ALIGNMENT_VALUES = ["left", "center", "right", "justify"];
-const INTERACTIVE_MODE_VALUES = ["click", "hover", "auto"];
-const ANIMATION_VALUES = ["none", "bounce", "pulse", "shake", "flip"];
-const DEFAULT_COMPOUND_CHILD_BODY_PLACEHOLDER = "Add supporting details for this internal item.";
-function createConstraints(overrides = {}) {
-    return {
-        exclusiveMaximum: null,
-        exclusiveMinimum: null,
-        format: null,
-        maxLength: null,
-        maxItems: null,
-        maximum: null,
-        minLength: null,
-        minItems: null,
-        minimum: null,
-        multipleOf: null,
-        pattern: null,
-        typeTag: null,
-        ...overrides,
-    };
-}
-function createAttribute({ constraints, defaultValue, enumValues = null, kind, required, sourceType, }) {
-    const hasDefault = defaultValue !== undefined;
-    return {
-        ts: {
-            items: null,
-            kind,
-            properties: null,
-            required,
-            union: null,
-        },
-        typia: {
-            constraints: createConstraints(constraints),
-            defaultValue: hasDefault ? defaultValue : null,
-            hasDefault,
-        },
-        wp: {
-            defaultValue: hasDefault ? defaultValue : null,
-            enum: enumValues,
-            hasDefault,
-            type: sourceType,
-        },
-    };
-}
-function createManifest(sourceType, attributes) {
-    return {
-        attributes,
-        manifestVersion: 2,
-        sourceType,
-    };
-}
-function buildBasicStarterManifest(variables) {
-    return createManifest(`${variables.pascalCase}Attributes`, {
-        alignment: createAttribute({
-            defaultValue: "left",
-            enumValues: [...ALIGNMENT_VALUES],
-            kind: "string",
-            required: false,
-            sourceType: "string",
-        }),
-        className: createAttribute({
-            constraints: {
-                maxLength: 100,
-            },
-            defaultValue: "",
-            kind: "string",
-            required: false,
-            sourceType: "string",
-        }),
-        content: createAttribute({
-            constraints: {
-                maxLength: 1000,
-            },
-            defaultValue: "",
-            kind: "string",
-            required: true,
-            sourceType: "string",
-        }),
-        id: createAttribute({
-            constraints: {
-                format: "uuid",
-            },
-            kind: "string",
-            required: false,
-            sourceType: "string",
-        }),
-        isVisible: createAttribute({
-            defaultValue: true,
-            kind: "boolean",
-            required: false,
-            sourceType: "boolean",
-        }),
-        schemaVersion: createAttribute({
-            constraints: {
-                typeTag: "uint32",
-            },
-            defaultValue: 1,
-            kind: "number",
-            required: false,
-            sourceType: "number",
-        }),
-    });
-}
-function buildInteractivityStarterManifest(variables) {
-    return createManifest(`${variables.pascalCase}Attributes`, {
-        alignment: createAttribute({
-            defaultValue: "left",
-            enumValues: [...ALIGNMENT_VALUES],
-            kind: "string",
-            required: false,
-            sourceType: "string",
-        }),
-        animation: createAttribute({
-            defaultValue: "none",
-            enumValues: [...ANIMATION_VALUES],
-            kind: "string",
-            required: false,
-            sourceType: "string",
-        }),
-        autoPlayInterval: createAttribute({
-            constraints: {
-                minimum: 0,
-                typeTag: "uint32",
-            },
-            defaultValue: 0,
-            kind: "number",
-            required: false,
-            sourceType: "number",
-        }),
-        clickCount: createAttribute({
-            constraints: {
-                minimum: 0,
-                typeTag: "uint32",
-            },
-            defaultValue: 0,
-            kind: "number",
-            required: false,
-            sourceType: "number",
-        }),
-        content: createAttribute({
-            constraints: {
-                maxLength: 1000,
-            },
-            defaultValue: "",
-            kind: "string",
-            required: true,
-            sourceType: "string",
-        }),
-        interactiveMode: createAttribute({
-            defaultValue: "click",
-            enumValues: [...INTERACTIVE_MODE_VALUES],
-            kind: "string",
-            required: false,
-            sourceType: "string",
-        }),
-        isAnimating: createAttribute({
-            defaultValue: false,
-            kind: "boolean",
-            required: false,
-            sourceType: "boolean",
-        }),
-        isVisible: createAttribute({
-            defaultValue: true,
-            kind: "boolean",
-            required: false,
-            sourceType: "boolean",
-        }),
-        maxClicks: createAttribute({
-            constraints: {
-                minimum: 0,
-                typeTag: "uint32",
-            },
-            defaultValue: 10,
-            kind: "number",
-            required: false,
-            sourceType: "number",
-        }),
-        showCounter: createAttribute({
-            defaultValue: true,
-            kind: "boolean",
-            required: false,
-            sourceType: "boolean",
-        }),
-        uniqueId: createAttribute({
-            defaultValue: "",
-            kind: "string",
-            required: false,
-            sourceType: "string",
-        }),
-    });
-}
-function buildPersistenceStarterManifest(variables) {
-    return createManifest(`${variables.pascalCase}Attributes`, {
-        alignment: createAttribute({
-            defaultValue: "left",
-            enumValues: [...ALIGNMENT_VALUES],
-            kind: "string",
-            required: false,
-            sourceType: "string",
-        }),
-        buttonLabel: createAttribute({
-            constraints: {
-                maxLength: 40,
-                minLength: 1,
-            },
-            defaultValue: "Persist Count",
-            kind: "string",
-            required: false,
-            sourceType: "string",
-        }),
-        content: createAttribute({
-            constraints: {
-                maxLength: 250,
-                minLength: 1,
-            },
-            defaultValue: `${variables.title} persistence block`,
-            kind: "string",
-            required: true,
-            sourceType: "string",
-        }),
-        isVisible: createAttribute({
-            defaultValue: true,
-            kind: "boolean",
-            required: false,
-            sourceType: "boolean",
-        }),
-        resourceKey: createAttribute({
-            constraints: {
-                maxLength: 100,
-                minLength: 1,
-            },
-            defaultValue: "primary",
-            kind: "string",
-            required: false,
-            sourceType: "string",
-        }),
-        showCount: createAttribute({
-            defaultValue: true,
-            kind: "boolean",
-            required: false,
-            sourceType: "boolean",
-        }),
-    });
-}
-function buildCompoundParentStarterManifest(variables) {
-    const attributes = {
-        heading: createAttribute({
-            constraints: {
-                maxLength: 80,
-                minLength: 1,
-            },
-            defaultValue: variables.title,
-            kind: "string",
-            required: true,
-            sourceType: "string",
-        }),
-        intro: createAttribute({
-            constraints: {
-                maxLength: 180,
-                minLength: 1,
-            },
-            defaultValue: "Add and reorder internal items inside this compound block.",
-            kind: "string",
-            required: false,
-            sourceType: "string",
-        }),
-        showDividers: createAttribute({
-            defaultValue: true,
-            kind: "boolean",
-            required: false,
-            sourceType: "boolean",
-        }),
-    };
-    if (variables.compoundPersistenceEnabled === "true") {
-        attributes.showCount = createAttribute({
-            defaultValue: true,
-            kind: "boolean",
-            required: false,
-            sourceType: "boolean",
-        });
-        attributes.buttonLabel = createAttribute({
-            constraints: {
-                maxLength: 40,
-                minLength: 1,
-            },
-            defaultValue: "Persist Count",
-            kind: "string",
-            required: false,
-            sourceType: "string",
-        });
-        attributes.resourceKey = createAttribute({
-            constraints: {
-                maxLength: 100,
-                minLength: 1,
-            },
-            defaultValue: "primary",
-            kind: "string",
-            required: false,
-            sourceType: "string",
-        });
-    }
-    return createManifest(`${variables.pascalCase}Attributes`, attributes);
-}
-function buildCompoundChildStarterManifest(variables) {
-    return buildCompoundChildStarterManifestDocument(`${variables.pascalCase}ItemAttributes`, variables.compoundChildTitle);
-}
+import { buildBuiltInBlockArtifacts, buildCompoundChildStarterManifestDocument as buildCompoundChildStarterManifestFromArtifacts, } from "./built-in-block-artifacts.js";
 /**
  * Builds the starter manifest used by generated compound child blocks.
  */
-export function buildCompoundChildStarterManifestDocument(childTypeName, childTitle, bodyPlaceholder = DEFAULT_COMPOUND_CHILD_BODY_PLACEHOLDER) {
-    return createManifest(childTypeName, {
-        body: createAttribute({
-            constraints: {
-                maxLength: 280,
-                minLength: 1,
-            },
-            defaultValue: bodyPlaceholder,
-            kind: "string",
-            required: true,
-            sourceType: "string",
-        }),
-        title: createAttribute({
-            constraints: {
-                maxLength: 80,
-                minLength: 1,
-            },
-            defaultValue: childTitle,
-            kind: "string",
-            required: true,
-            sourceType: "string",
-        }),
-    });
+export function buildCompoundChildStarterManifestDocument(childTypeName, childTitle, bodyPlaceholder) {
+    return buildCompoundChildStarterManifestFromArtifacts(childTypeName, childTitle, bodyPlaceholder);
 }
 /**
  * Returns the starter manifest files that should be seeded for a built-in
  * template before the first sync.
  */
 export function getStarterManifestFiles(templateId, variables) {
-    if (templateId === "basic") {
-        return [
-            {
-                document: buildBasicStarterManifest(variables),
-                relativePath: "src/typia.manifest.json",
-            },
-        ];
-    }
-    if (templateId === "interactivity") {
-        return [
-            {
-                document: buildInteractivityStarterManifest(variables),
-                relativePath: "src/typia.manifest.json",
-            },
-        ];
-    }
-    if (templateId === "persistence") {
-        return [
-            {
-                document: buildPersistenceStarterManifest(variables),
-                relativePath: "src/typia.manifest.json",
-            },
-        ];
-    }
-    if (templateId === "compound") {
-        return [
-            {
-                document: buildCompoundParentStarterManifest(variables),
-                relativePath: `src/blocks/${variables.slugKebabCase}/typia.manifest.json`,
-            },
-            {
-                document: buildCompoundChildStarterManifest(variables),
-                relativePath: `src/blocks/${variables.slugKebabCase}-item/typia.manifest.json`,
-            },
-        ];
+    if (templateId !== "basic" &&
+        templateId !== "interactivity" &&
+        templateId !== "persistence" &&
+        templateId !== "compound") {
+        return [];
     }
-    return [];
+    return buildBuiltInBlockArtifacts({
+        templateId,
+        variables,
+    }).map((artifact) => ({
+        document: artifact.manifestDocument,
+        relativePath: `${artifact.relativeDir}/typia.manifest.json`,
+    }));
 }
 /**
  * Serializes a starter manifest using the generated-project JSON formatting

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-render.d.ts

@@ -15,6 +15,11 @@ export interface CopyRawDirectoryOptions {
      */
     filter?: (sourcePath: string, targetPath: string, entry: fs.Dirent) => boolean | Promise<boolean>;
 }
+/**
+ * Render a Mustache template while keeping HTML escaping disabled only for the
+ * current render call.
+ */
+export declare function renderMustacheTemplateString(template: string, view: TemplateRenderView): string;
 /**
  * Recursively copies a directory tree without rendering template contents.
  */

package/dist/runtime/template-render.js

@@ -19,9 +19,19 @@ const BINARY_EXTENSIONS = new Set([
     ".woff",
     ".woff2",
 ]);
-Mustache.escape = (value) => value;
-function renderMustacheTemplateString(template, view) {
-    return Mustache.render(template, view);
+/**
+ * Render a Mustache template while keeping HTML escaping disabled only for the
+ * current render call.
+ */
+export function renderMustacheTemplateString(template, view) {
+    const originalEscape = Mustache.escape;
+    Mustache.escape = (value) => value;
+    try {
+        return Mustache.render(template, view);
+    }
+    finally {
+        Mustache.escape = originalEscape;
+    }
 }
 function escapeRegExp(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");

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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.16.2",
+  "version": "0.16.5",
   "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/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/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",

package/templates/_shared/compound/persistence/scripts/block-config.ts.mustache

@@ -31,7 +31,7 @@ export const BLOCKS = [
 					queryContract: 'state-query',
 					responseContract: 'state-response',
 					summary: 'Read the current persisted state.',
-					tags: [ '{{title}}' ],
+					tags: [ {{titleJson}} ],
 				},
 				{
 					auth: '{{restWriteAuthIntent}}',
@@ -41,7 +41,7 @@ export const BLOCKS = [
 					path: '/{{namespace}}/v1/{{slugKebabCase}}/state',
 					responseContract: 'state-response',
 					summary: 'Write the current persisted state.',
-					tags: [ '{{title}}' ],
+					tags: [ {{titleJson}} ],
 					wordpressAuth: {
 						mechanism: '{{restWriteAuthMechanism}}',
 					},
@@ -54,11 +54,11 @@ export const BLOCKS = [
 					queryContract: 'bootstrap-query',
 					responseContract: 'bootstrap-response',
 					summary: 'Read fresh session bootstrap state for the current viewer.',
-					tags: [ '{{title}}' ],
+					tags: [ {{titleJson}} ],
 				},
 			],
 			info: {
-				title: '{{title}} REST API',
+				title: {{titleJson}} + ' REST API',
 				version: '1.0.0',
 			},
 		} ),

package/templates/_shared/persistence/core/scripts/sync-rest-contracts.ts.mustache

@@ -76,7 +76,7 @@ const REST_ENDPOINT_MANIFEST = defineEndpointManifest( {
 			queryContract: 'state-query',
 			responseContract: 'state-response',
 			summary: 'Read the current persisted state.',
-			tags: [ '{{title}}' ],
+			tags: [ {{titleJson}} ],
 		},
 		{
 			auth: '{{restWriteAuthIntent}}',
@@ -86,7 +86,7 @@ const REST_ENDPOINT_MANIFEST = defineEndpointManifest( {
 			path: '/{{namespace}}/v1/{{slugKebabCase}}/state',
 			responseContract: 'state-response',
 			summary: 'Write the current persisted state.',
-			tags: [ '{{title}}' ],
+			tags: [ {{titleJson}} ],
 			wordpressAuth: {
 				mechanism: '{{restWriteAuthMechanism}}',
 			},
@@ -99,11 +99,11 @@ const REST_ENDPOINT_MANIFEST = defineEndpointManifest( {
 			queryContract: 'bootstrap-query',
 			responseContract: 'bootstrap-response',
 			summary: 'Read fresh session bootstrap state for the current viewer.',
-			tags: [ '{{title}}' ],
+			tags: [ {{titleJson}} ],
 		},
 	],
 	info: {
-		title: '{{title}} REST API',
+		title: {{titleJson}} + ' REST API',
 		version: '1.0.0',
 	},
 } );

package/templates/_shared/base/src/hooks.ts.mustache

@@ -1,19 +0,0 @@
-import { useMemo } from '@wordpress/element';
-
-import {
-	createUseTypiaValidationHook,
-	formatValidationError,
-	formatValidationErrors,
-} from '@wp-typia/block-runtime/validation';
-
-export {
-	formatValidationError,
-	formatValidationErrors,
-	type TypiaValidationError,
-	type ValidationResult,
-	type ValidationState,
-} from '@wp-typia/block-runtime/validation';
-
-export const useTypiaValidation = createUseTypiaValidationHook( {
-	useMemo,
-} );

package/templates/_shared/compound/persistence/src/blocks/{{slugKebabCase}}/block.json.mustache

@@ -1,52 +0,0 @@
-{
-	"$schema": "https://schemas.wp.org/trunk/block.json",
-	"apiVersion": 3,
-	"name": "{{namespace}}/{{slugKebabCase}}",
-	"version": "{{blockMetadataVersion}}",
-	"title": {{titleJson}},
-	"category": "{{category}}",
-	"icon": "{{icon}}",
-	"description": "{{description}}",
-	"example": {},
-	"supports": {
-		"html": false,
-		"anchor": true,
-		"className": true,
-		"interactivity": true
-	},
-	"attributes": {
-		"heading": {
-			"type": "string",
-			"source": "html",
-			"selector": ".{{cssClassName}}__heading",
-			"default": {{titleJson}}
-		},
-		"intro": {
-			"type": "string",
-			"source": "html",
-			"selector": ".{{cssClassName}}__intro",
-			"default": "Add and reorder internal items inside this compound block."
-		},
-		"showDividers": {
-			"type": "boolean",
-			"default": true
-		},
-		"showCount": {
-			"type": "boolean",
-			"default": true
-		},
-		"buttonLabel": {
-			"type": "string",
-			"default": "Persist Count"
-		},
-		"resourceKey": {
-			"type": "string",
-			"default": ""
-		}
-	},
-	"textdomain": "{{textDomain}}",
-	"editorScript": "file:./index.js",
-	"style": "file:./style-index.css",
-	"viewScriptModule": "file:./interactivity.js",
-	"render": "file:./render.php"
-}