@wp-typia/project-tools 0.13.2 → 0.13.4

package/dist/runtime/scaffold-onboarding.js

@@ -44,7 +44,7 @@ export function getTemplateSourceOfTruthNote(templateId, { compoundPersistenceEn
     if (templateId === "persistence") {
         return "`src/types.ts` remains the source of truth for `block.json`, `typia.manifest.json`, and `typia-validator.php`. Fresh scaffolds include a starter `typia.manifest.json` so editor imports resolve before the first sync. `src/api-types.ts` remains the source of truth for `src/api-schemas/*` when you run `sync-rest`. This scaffold is intentionally server-rendered: `src/render.php` is the canonical frontend entry, and `src/save.tsx` returns `null` so PHP can inject post context, storage-backed state, and write-policy bootstrap data before hydration.";
     }
-    return "`src/types.ts` remains the source of truth for `block.json`, `typia.manifest.json`, and `typia-validator.php`. Fresh scaffolds include a starter `typia.manifest.json` so editor imports resolve before the first sync. The basic scaffold stays static by design: it does not generate `render.php`, `src/save.tsx` always returns stable markup, and the generated webpack config keeps the current `@wordpress/scripts` CommonJS baseline.";
+    return "`src/types.ts` remains the source of truth for `block.json`, `typia.manifest.json`, and `typia-validator.php`. Fresh scaffolds include a starter `typia.manifest.json` so editor imports resolve before the first sync. The basic scaffold stays static by design: `src/render.php` is only an opt-in server placeholder, `src/save.tsx` remains the canonical frontend output, and the generated webpack config keeps the current `@wordpress/scripts` CommonJS baseline unless you intentionally add `render` to `block.json`.";
 }
 /**
  * Returns the generated-project extension workflow for compound child blocks.

package/dist/runtime/scaffold.d.ts

@@ -129,9 +129,11 @@ export interface ScaffoldProjectResult {
  * Builds the generated WordPress wrapper CSS class for a scaffolded block.
  *
  * Returns `wp-block-{namespace}-{slug}` when a non-empty namespace is present,
- * or `wp-block-{slug}` when the namespace is empty or undefined. Both inputs
- * are normalized and validated with the same scaffold identifier rules used for
- * block names.
+ * or `wp-block-{slug}` when the namespace is empty or undefined. When the
+ * normalized namespace equals the normalized slug, appends `-block` so the
+ * generated class avoids repeated namespace segments without colliding with the
+ * default core wrapper classes. Both inputs are normalized and validated with
+ * the same scaffold identifier rules used for block names.
  */
 export declare function buildBlockCssClassName(namespace: string | undefined, slug: string): string;
 export declare function isDataStorageMode(value: string): value is DataStorageMode;

package/dist/runtime/scaffold.js

@@ -74,15 +74,20 @@ function resolveValidatedPhpPrefix(value) {
  * Builds the generated WordPress wrapper CSS class for a scaffolded block.
  *
  * Returns `wp-block-{namespace}-{slug}` when a non-empty namespace is present,
- * or `wp-block-{slug}` when the namespace is empty or undefined. Both inputs
- * are normalized and validated with the same scaffold identifier rules used for
- * block names.
+ * or `wp-block-{slug}` when the namespace is empty or undefined. When the
+ * normalized namespace equals the normalized slug, appends `-block` so the
+ * generated class avoids repeated namespace segments without colliding with the
+ * default core wrapper classes. Both inputs are normalized and validated with
+ * the same scaffold identifier rules used for block names.
  */
 export function buildBlockCssClassName(namespace, slug) {
     const normalizedSlug = resolveValidatedBlockSlug(slug);
     const normalizedNamespace = typeof namespace === "string" && namespace.trim().length > 0
         ? resolveValidatedNamespace(namespace)
         : "";
+    if (normalizedNamespace === normalizedSlug) {
+        return `wp-block-${normalizedSlug}-block`;
+    }
     return normalizedNamespace.length > 0
         ? `wp-block-${normalizedNamespace}-${normalizedSlug}`
         : `wp-block-${normalizedSlug}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.13.2",
+  "version": "0.13.4",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -63,7 +63,7 @@
   "dependencies": {
     "@wp-typia/api-client": "^0.4.0",
     "@wp-typia/block-runtime": "^0.4.0",
-    "@wp-typia/rest": "^0.3.3",
+    "@wp-typia/rest": "^0.3.4",
     "@wp-typia/block-types": "^0.2.0",
     "mustache": "^4.2.0",
     "npm-package-arg": "^13.0.0",

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

@@ -108,6 +108,10 @@ function buildBlockCssClassName( namespace: string, slug: string ): string {
 			? resolveValidatedNamespace( namespace )
 			: '';
 
+	if ( normalizedNamespace === normalizedSlug ) {
+		return `wp-block-${ normalizedSlug }-block`;
+	}
+
 	return normalizedNamespace.length > 0
 		? `wp-block-${ normalizedNamespace }-${ normalizedSlug }`
 		: `wp-block-${ normalizedSlug }`;

package/templates/basic/src/edit.tsx.mustache

@@ -29,7 +29,7 @@ type EditProps = BlockEditProps<{{pascalCase}}Attributes>;
 function Edit({ attributes, setAttributes }: EditProps) {
   const isVisible = attributes.isVisible !== false;
   const blockProps = useBlockProps({
-    className: isVisible ? undefined : 'is-hidden',
+    className: `{{cssClassName}}${isVisible ? '' : ' is-hidden'}`,
   });
   const editorFields = useEditorFields(currentManifest as ManifestDocument, {
     hidden: ['id', 'schemaVersion'],

package/templates/basic/src/render.php.mustache

@@ -0,0 +1,19 @@
+<?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>

package/templates/basic/src/save.tsx.mustache

@@ -12,7 +12,7 @@ interface SaveProps {
 export default function Save({ attributes }: SaveProps) {
   const isVisible = attributes.isVisible !== false;
   const blockProps = useBlockProps.save({
-    className: isVisible ? undefined : 'is-hidden',
+    className: `{{cssClassName}}${isVisible ? '' : ' is-hidden'}`,
     hidden: isVisible ? undefined : true,
     'aria-hidden': isVisible ? undefined : 'true',
   });