@wp-typia/project-tools 0.16.1 → 0.16.4

package/dist/runtime/starter-manifests.d.ts

@@ -1,8 +1,9 @@
 /**
  * Scaffold-time starter manifest builders for generated projects.
  *
- * These helpers create placeholder `typia.manifest.json` artifacts so fresh
- * scaffolds can resolve runtime imports before the first canonical sync run.
+ * These helpers now reuse the Phase 2 built-in artifact model so generated
+ * `types.ts`, `block.json`, and starter `typia.manifest.json` all share the
+ * same attribute metadata source of truth.
  */
 import type { ManifestDocument } from "./migration-types.js";
 import type { ScaffoldTemplateVariables } from "./scaffold.js";

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-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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.16.1",
+  "version": "0.16.4",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -12,11 +12,56 @@
       "import": "./dist/runtime/index.js",
       "default": "./dist/runtime/index.js"
     },
+    "./cli-add": {
+      "types": "./dist/runtime/cli-add.d.ts",
+      "import": "./dist/runtime/cli-add.js",
+      "default": "./dist/runtime/cli-add.js"
+    },
+    "./cli-doctor": {
+      "types": "./dist/runtime/cli-doctor.d.ts",
+      "import": "./dist/runtime/cli-doctor.js",
+      "default": "./dist/runtime/cli-doctor.js"
+    },
+    "./cli-prompt": {
+      "types": "./dist/runtime/cli-prompt.d.ts",
+      "import": "./dist/runtime/cli-prompt.js",
+      "default": "./dist/runtime/cli-prompt.js"
+    },
+    "./cli-scaffold": {
+      "types": "./dist/runtime/cli-scaffold.d.ts",
+      "import": "./dist/runtime/cli-scaffold.js",
+      "default": "./dist/runtime/cli-scaffold.js"
+    },
+    "./cli-templates": {
+      "types": "./dist/runtime/cli-templates.d.ts",
+      "import": "./dist/runtime/cli-templates.js",
+      "default": "./dist/runtime/cli-templates.js"
+    },
+    "./hooked-blocks": {
+      "types": "./dist/runtime/hooked-blocks.d.ts",
+      "import": "./dist/runtime/hooked-blocks.js",
+      "default": "./dist/runtime/hooked-blocks.js"
+    },
+    "./migrations": {
+      "types": "./dist/runtime/migrations.d.ts",
+      "import": "./dist/runtime/migrations.js",
+      "default": "./dist/runtime/migrations.js"
+    },
+    "./package-managers": {
+      "types": "./dist/runtime/package-managers.d.ts",
+      "import": "./dist/runtime/package-managers.js",
+      "default": "./dist/runtime/package-managers.js"
+    },
     "./schema-core": {
       "types": "./dist/runtime/schema-core.d.ts",
       "import": "./dist/runtime/schema-core.js",
       "default": "./dist/runtime/schema-core.js"
     },
+    "./workspace-project": {
+      "types": "./dist/runtime/workspace-project.d.ts",
+      "import": "./dist/runtime/workspace-project.js",
+      "default": "./dist/runtime/workspace-project.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -27,10 +72,18 @@
   ],
   "scripts": {
     "build": "bun run --filter @wp-typia/api-client build && bun run --filter @wp-typia/block-runtime build && rm -rf dist && tsc -p tsconfig.runtime.json",
+    "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: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",
+    "test:migration-execution": "bun run build && bun test tests/migration-scaffold-diff.test.ts tests/migration-doctor.test.ts tests/migration-fixtures-fuzz.test.ts",
+    "test:project-tools": "bun run test:scaffold-core && bun run test:workspace && bun run test:compound && bun run test:migration-planning && bun run test:migration-execution",
     "test:coverage": "bun run build && bun test tests/*.test.ts --coverage --coverage-reporter=lcov --coverage-dir=coverage",
     "clean": "rm -rf dist",
-    "prepack": "bun run build"
+    "prepublishOnly": "bun run build"
   },
   "keywords": [
     "wordpress",
@@ -62,7 +115,7 @@
   },
   "dependencies": {
     "@wp-typia/api-client": "^0.4.2",
-    "@wp-typia/block-runtime": "^0.4.4",
+    "@wp-typia/block-runtime": "^0.4.5",
     "@wp-typia/rest": "^0.3.5",
     "@wp-typia/block-types": "^0.2.1",
     "mustache": "^4.2.0",

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"
-}