@wp-typia/project-tools 0.16.4 → 0.16.6

package/README.md

@@ -8,7 +8,8 @@ Package roles:
 - `@wp-typia/project-tools` owns scaffold, add-block, migrate, template, doctor, and schema project helpers.
   It also owns the typed generator boundary via `BlockSpec` and `BlockGeneratorService`,
   plus the emitter-owned built-in structural/code path where built-in
-  templates no longer ship structural or TS/TSX Mustache files.
+  templates no longer ship structural, TS/TSX, style, or block-local `render.php`
+  Mustache files.
 - `@wp-typia/block-runtime/*` owns generated-project runtime helpers.
 - `@wp-typia/create` is the deprecated legacy package shell.
 
@@ -40,10 +41,11 @@ import { normalizeEndpointAuthDefinition } from "@wp-typia/project-tools/schema-
 ```
 
 `BlockGeneratorService` is the additive typed orchestration boundary for built-in
-block scaffolds. Built-in templates no longer ship structural or TS/TSX
-Mustache files for built-in `types.ts`, `block.json`, or generated scaffold
-bodies; those files and starter `typia.manifest.json` now come from the emitter
-path, while styles, PHP, and the remaining non-TS scaffold files still come
-from Mustache-backed template copy.
+block scaffolds. Built-in templates no longer ship structural, TS/TSX, style,
+or block-local `render.php` Mustache files for built-in `types.ts`,
+`block.json`, generated scaffold bodies, or block-local non-TS assets; those
+files and starter `typia.manifest.json` now come from the emitter path, while
+project bootstrap/package-manager files, sync scripts, shared REST helpers, and
+the remaining non-block assets still come from Mustache-backed template copy.
 
 If you need metadata sync, editor helpers, validation helpers, or other generated-project runtime utilities, import them directly from `@wp-typia/block-runtime/*`.

package/dist/runtime/built-in-block-code-artifacts.d.ts

@@ -1,11 +1,12 @@
 import type { ScaffoldTemplateVariables } from "./scaffold.js";
 import type { BuiltInTemplateId } from "./template-registry.js";
 /**
- * Emits built-in TS/TSX scaffold sources from typed block generation inputs.
+ * Emits built-in scaffold source files from typed block generation inputs.
  *
  * This module is intentionally internal to the runtime boundary: built-in
- * scaffold bodies are now derived from `ScaffoldTemplateVariables`, but the
- * emitter helpers themselves are not part of the public root export surface.
+ * scaffold bodies and adjacent emitted source files are now derived from
+ * `ScaffoldTemplateVariables`, but the emitter helpers themselves are not part
+ * of the public root export surface.
  */
 export interface BuiltInCodeArtifact {
     /**
@@ -18,11 +19,11 @@ export interface BuiltInCodeArtifact {
     source: string;
 }
 /**
- * Build the emitter-owned TS/TSX scaffold files for a built-in template family.
+ * Build the emitter-owned scaffold files for a built-in template family.
  *
- * These artifacts are written after template copy so built-in structural and
- * code files always come from the typed generator boundary rather than stale
- * Mustache sources.
+ * These artifacts are written after template copy so built-in structural,
+ * source, and adjacent generated files always come from the typed generator
+ * boundary rather than stale Mustache sources.
  */
 export declare function buildBuiltInCodeArtifacts({ templateId, variables, }: {
     templateId: BuiltInTemplateId;

package/dist/runtime/built-in-block-code-artifacts.js

@@ -1,3 +1,4 @@
+import { buildBuiltInNonTsArtifacts } from "./built-in-block-non-ts-artifacts.js";
 import { renderMustacheTemplateString } from "./template-render.js";
 const SHARED_HOOKS_TEMPLATE = "import { useMemo } from '@wordpress/element';\n\nimport {\n\tcreateUseTypiaValidationHook,\n\tformatValidationError,\n\tformatValidationErrors,\n} from '@wp-typia/block-runtime/validation';\n\nexport {\n\tformatValidationError,\n\tformatValidationErrors,\n\ttype TypiaValidationError,\n\ttype ValidationResult,\n\ttype ValidationState,\n} from '@wp-typia/block-runtime/validation';\n\nexport const useTypiaValidation = createUseTypiaValidationHook( {\n\tuseMemo,\n} );\n";
 const BASIC_EDIT_TEMPLATE = "/**\n * Editor component for {{title}} Block\n */\n\nimport { BlockEditProps } from '@wordpress/blocks';\nimport {\n  InspectorControls,\n  RichText,\n  useBlockProps,\n} from '@wordpress/block-editor';\nimport { Notice, PanelBody, TextControl } from '@wordpress/components';\nimport { __ } from '@wordpress/i18n';\nimport currentManifest from './typia.manifest.json';\nimport {\n  InspectorFromManifest,\n  type ManifestDocument,\n  useEditorFields,\n  useTypedAttributeUpdater,\n} from '@wp-typia/block-runtime/inspector';\nimport { {{pascalCase}}Attributes } from './types';\nimport {\n  sanitize{{pascalCase}}Attributes,\n  validate{{pascalCase}}Attributes,\n} from './validators';\nimport { useTypiaValidation } from './hooks';\n\ntype EditProps = BlockEditProps<{{pascalCase}}Attributes>;\n\nconst validationErrorItemStyle = { color: '#cc1818', fontSize: '12px' };\nconst validationListStyle = { margin: 0, paddingLeft: '1em' };\n\nfunction Edit({ attributes, setAttributes }: EditProps) {\n  const isVisible = attributes.isVisible !== false;\n  const blockProps = useBlockProps({\n    className: `{{cssClassName}}${isVisible ? '' : ' is-hidden'}`,\n  });\n  const editorFields = useEditorFields(currentManifest as ManifestDocument, {\n    hidden: ['id', 'schemaVersion'],\n    manual: ['content'],\n    labels: {\n      alignment: __('Alignment', '{{textDomain}}'),\n      className: __('CSS Class', '{{textDomain}}'),\n      content: __('Content', '{{textDomain}}'),\n      isVisible: __('Visible', '{{textDomain}}'),\n    },\n  });\n  const classNameField = editorFields.getField('className');\n  const { errorMessages, isValid } = useTypiaValidation(\n    attributes,\n    validate{{pascalCase}}Attributes\n  );\n  const validateEditorUpdate = (nextAttributes: {{pascalCase}}Attributes) => {\n    try {\n      return {\n        data: sanitize{{pascalCase}}Attributes(nextAttributes),\n        errors: [],\n        isValid: true as const,\n      };\n    } catch {\n      return validate{{pascalCase}}Attributes(nextAttributes);\n    }\n  };\n  const { updateField } = useTypedAttributeUpdater(\n    attributes,\n    setAttributes,\n    validateEditorUpdate\n  );\n\n  return (\n    <>\n      <InspectorControls>\n        <InspectorFromManifest\n          attributes={attributes}\n          fieldLookup={editorFields}\n          onChange={updateField}\n          paths={['alignment', 'isVisible']}\n          title={__('Settings', '{{textDomain}}')}\n        >\n          <TextControl\n            label={__('Content', '{{textDomain}}')}\n            value={attributes.content || ''}\n            onChange={(value) => updateField('content', value)}\n            help={__('Mirrors the main block content.', '{{textDomain}}')}\n          />\n\n          <TextControl\n            label={classNameField?.label || __('CSS Class', '{{textDomain}}')}\n            value={attributes.className || ''}\n            onChange={(value) => updateField('className', value)}\n            help={__('Add an optional CSS class name.', '{{textDomain}}')}\n          />\n        </InspectorFromManifest>\n\n        {!isValid && (\n          <PanelBody title={__('Validation Errors', '{{textDomain}}')} initialOpen>\n            {errorMessages.map((error, index) => (\n              <div key={index} style={validationErrorItemStyle}>\n                • {error}\n              </div>\n            ))}\n          </PanelBody>\n        )}\n      </InspectorControls>\n\n      <div {...blockProps}>\n        <div className=\"{{cssClassName}}__content\">\n          <RichText\n            tagName=\"p\"\n            value={attributes.content || ''}\n            onChange={(value) => updateField('content', value)}\n            placeholder={__('Add your content...', '{{textDomain}}')}\n          />\n        </div>\n        {!isValid && (\n          <Notice status=\"error\" isDismissible={false}>\n            <p>\n              <strong>{__('Validation Errors', '{{textDomain}}')}</strong>\n            </p>\n            <ul style={validationListStyle}>\n              {errorMessages.map((error, index) => (\n                <li key={index}>{error}</li>\n              ))}\n            </ul>\n          </Notice>\n        )}\n      </div>\n    </>\n  );\n}\n\nexport default Edit;\n";
@@ -38,30 +39,42 @@ function createCodeArtifact(relativePath, template, variables) {
         source: renderCodeTemplate(template, variables),
     };
 }
+function ensureUniqueArtifactPaths(artifacts) {
+    const seenPaths = new Set();
+    for (const artifact of artifacts) {
+        if (seenPaths.has(artifact.relativePath)) {
+            throw new Error(`Duplicate built-in artifact path emitted: ${artifact.relativePath}`);
+        }
+        seenPaths.add(artifact.relativePath);
+    }
+    return artifacts;
+}
 function buildBasicCodeArtifacts(variables) {
-    return [
+    return ensureUniqueArtifactPaths([
         createCodeArtifact("src/hooks.ts", SHARED_HOOKS_TEMPLATE, variables),
         createCodeArtifact("src/edit.tsx", BASIC_EDIT_TEMPLATE, variables),
         createCodeArtifact("src/save.tsx", BASIC_SAVE_TEMPLATE, variables),
         createCodeArtifact("src/index.tsx", BASIC_INDEX_TEMPLATE, variables),
         createCodeArtifact("src/validators.ts", BASIC_VALIDATORS_TEMPLATE, variables),
-    ];
+        ...buildBuiltInNonTsArtifacts({ templateId: "basic", variables }),
+    ]);
 }
 function buildInteractivityCodeArtifacts(variables) {
-    return [
+    return ensureUniqueArtifactPaths([
         createCodeArtifact("src/hooks.ts", SHARED_HOOKS_TEMPLATE, variables),
         createCodeArtifact("src/edit.tsx", INTERACTIVITY_EDIT_TEMPLATE, variables),
         createCodeArtifact("src/save.tsx", INTERACTIVITY_SAVE_TEMPLATE, variables),
         createCodeArtifact("src/index.tsx", INTERACTIVITY_INDEX_TEMPLATE, variables),
         createCodeArtifact("src/interactivity.ts", INTERACTIVITY_SCRIPT_TEMPLATE, variables),
         createCodeArtifact("src/validators.ts", INTERACTIVITY_VALIDATORS_TEMPLATE, variables),
-    ];
+        ...buildBuiltInNonTsArtifacts({ templateId: "interactivity", variables }),
+    ]);
 }
 function buildCompoundCodeArtifacts(variables) {
     const parentBasePath = `src/blocks/${variables.slugKebabCase}`;
     const childBasePath = `src/blocks/${variables.slugKebabCase}-item`;
     const compoundPersistenceEnabled = variables.compoundPersistenceEnabled === "true";
-    return [
+    return ensureUniqueArtifactPaths([
         createCodeArtifact("src/hooks.ts", SHARED_HOOKS_TEMPLATE, variables),
         createCodeArtifact(`${parentBasePath}/edit.tsx`, compoundPersistenceEnabled
             ? COMPOUND_PERSISTENCE_PARENT_EDIT_TEMPLATE
@@ -85,24 +98,26 @@ function buildCompoundCodeArtifacts(variables) {
         createCodeArtifact(`${childBasePath}/index.tsx`, COMPOUND_CHILD_INDEX_TEMPLATE, variables),
         createCodeArtifact(`${childBasePath}/hooks.ts`, COMPOUND_LOCAL_HOOKS_TEMPLATE, variables),
         createCodeArtifact(`${childBasePath}/validators.ts`, COMPOUND_CHILD_VALIDATORS_TEMPLATE, variables),
-    ];
+        ...buildBuiltInNonTsArtifacts({ templateId: "compound", variables }),
+    ]);
 }
 function buildPersistenceCodeArtifacts(variables) {
-    return [
+    return ensureUniqueArtifactPaths([
         createCodeArtifact("src/hooks.ts", SHARED_HOOKS_TEMPLATE, variables),
         createCodeArtifact("src/edit.tsx", PERSISTENCE_EDIT_TEMPLATE, variables),
         createCodeArtifact("src/save.tsx", PERSISTENCE_SAVE_TEMPLATE, variables),
         createCodeArtifact("src/index.tsx", PERSISTENCE_INDEX_TEMPLATE, variables),
         createCodeArtifact("src/interactivity.ts", PERSISTENCE_INTERACTIVITY_TEMPLATE, variables),
         createCodeArtifact("src/validators.ts", PERSISTENCE_VALIDATORS_TEMPLATE, variables),
-    ];
+        ...buildBuiltInNonTsArtifacts({ templateId: "persistence", variables }),
+    ]);
 }
 /**
- * Build the emitter-owned TS/TSX scaffold files for a built-in template family.
+ * Build the emitter-owned scaffold files for a built-in template family.
  *
- * These artifacts are written after template copy so built-in structural and
- * code files always come from the typed generator boundary rather than stale
- * Mustache sources.
+ * These artifacts are written after template copy so built-in structural,
+ * source, and adjacent generated files always come from the typed generator
+ * boundary rather than stale Mustache sources.
  */
 export function buildBuiltInCodeArtifacts({ templateId, variables, }) {
     switch (templateId) {

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

@@ -0,0 +1,18 @@
+import type { BuiltInCodeArtifact } from "./built-in-block-code-artifacts.js";
+import type { ScaffoldTemplateVariables } from "./scaffold.js";
+import type { BuiltInTemplateId } from "./template-registry.js";
+/**
+ * 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 declare function buildBuiltInNonTsArtifacts({ templateId, variables, }: {
+    templateId: BuiltInTemplateId;
+    variables: ScaffoldTemplateVariables;
+}): BuiltInCodeArtifact[];