@wp-typia/project-tools 0.11.1

package/dist/runtime/typia-tags.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/runtime/typia-tags.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@wp-typia/project-tools",
+  "version": "0.11.1",
+  "description": "Project orchestration and programmatic tooling for wp-typia",
+  "packageManager": "bun@1.3.11",
+  "type": "module",
+  "main": "dist/runtime/index.js",
+  "types": "dist/runtime/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js",
+      "default": "./dist/runtime/index.js"
+    },
+    "./schema-core": {
+      "types": "./dist/runtime/schema-core.d.ts",
+      "import": "./dist/runtime/schema-core.js",
+      "default": "./dist/runtime/schema-core.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/",
+    "templates/",
+    "README.md",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "bun run --filter @wp-typia/block-runtime build && rm -rf dist && tsc -p tsconfig.runtime.json",
+    "test": "bun run --filter @wp-typia/block-runtime build && bun run build && bun test tests/*.test.ts",
+    "test:coverage": "bun run --filter @wp-typia/block-runtime build && bun run build && bun test tests/*.test.ts --coverage --coverage-reporter=lcov --coverage-dir=coverage",
+    "clean": "rm -rf dist",
+    "prepack": "bun run build"
+  },
+  "keywords": [
+    "wordpress",
+    "gutenberg",
+    "typia",
+    "scaffold",
+    "migrate",
+    "templates",
+    "tooling"
+  ],
+  "author": "imjlk",
+  "license": "GPL-2.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/imjlk/wp-typia.git",
+    "directory": "packages/wp-typia-project-tools"
+  },
+  "bugs": {
+    "url": "https://github.com/imjlk/wp-typia/issues"
+  },
+  "homepage": "https://github.com/imjlk/wp-typia/tree/main/packages/wp-typia-project-tools#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "npm": ">=10.0.0",
+    "bun": ">=1.3.11"
+  },
+  "dependencies": {
+    "@wp-typia/api-client": "^0.4.0",
+    "@wp-typia/block-runtime": "^0.3.0",
+    "@wp-typia/rest": "^0.3.1",
+    "@wp-typia/block-types": "^0.2.0",
+    "mustache": "^4.2.0",
+    "npm-package-arg": "^13.0.0",
+    "semver": "^7.7.3",
+    "tar": "^7.4.3",
+    "typescript": "^5.9.2"
+  },
+  "devDependencies": {
+    "react": "^19.2.0",
+    "react-devtools-core": "^7.0.1",
+    "ws": "^8.18.0"
+  }
+}

package/templates/_shared/base/languages/.gitkeep

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,41 @@
+{
+  "name": "{{slug}}",
+  "version": "0.1.0",
+  "packageManager": "bun@1.3.10",
+  "description": "{{description}}",
+  "author": "{{author}}",
+  "license": "GPL-2.0-or-later",
+  "main": "build/index.js",
+  "scripts": {
+    "sync-types": "tsx scripts/sync-types-to-block-json.ts",
+    "build": "bun run sync-types --check && wp-scripts build --experimental-modules",
+    "start": "bun run sync-types && wp-scripts start --experimental-modules",
+    "dev": "bun run start",
+    "lint:js": "wp-scripts lint-js",
+    "lint:css": "wp-scripts lint-style",
+    "lint": "bun run lint:js && bun run lint:css",
+    "format": "wp-scripts format",
+    "typecheck": "bun run sync-types --check && tsc --noEmit"
+  },
+  "devDependencies": {
+    "@wp-typia/block-runtime": "{{blockRuntimePackageVersion}}",
+    "@wp-typia/block-types": "{{blockTypesPackageVersion}}",
+    "ajv": "^8.18.0",
+    "@types/wordpress__block-editor": "^11.5.17",
+    "@types/wordpress__blocks": "^12.5.18",
+    "@wordpress/browserslist-config": "^6.42.0",
+    "@wordpress/scripts": "^30.22.0",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "@typia/unplugin": "^12.0.1",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2",
+    "typia": "^12.0.1"
+  },
+  "dependencies": {
+    "@wordpress/block-editor": "^15.2.0",
+    "@wordpress/blocks": "^15.2.0",
+    "@wordpress/components": "^30.2.0",
+    "@wordpress/element": "^6.29.0",
+    "@wordpress/i18n": "^6.2.0"
+  }
+}

package/templates/_shared/base/scripts/sync-types-to-block-json.ts.mustache

@@ -0,0 +1,118 @@
+import { runSyncBlockMetadata } from "@wp-typia/block-runtime/metadata-core";
+
+type SyncTypesReportMode = "human" | "json";
+
+interface SyncTypesCliOptions {
+  check: boolean;
+  failOnLossy: boolean;
+  report: SyncTypesReportMode;
+  strict: boolean;
+}
+
+function parseCliOptions(argv: string[]): SyncTypesCliOptions {
+  const options: SyncTypesCliOptions = {
+    check: false,
+    failOnLossy: false,
+    report: "human",
+    strict: false,
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const argument = argv[index];
+
+    if (argument === "--strict") {
+      options.strict = true;
+      continue;
+    }
+
+    if (argument === "--fail-on-lossy") {
+      options.failOnLossy = true;
+      continue;
+    }
+
+    if (argument === "--check") {
+      options.check = true;
+      continue;
+    }
+
+    if (argument === "--report") {
+      const reportMode = argv[index + 1];
+      if (reportMode !== "json") {
+        throw new Error('The `--report` flag currently supports only `json`.');
+      }
+      options.report = reportMode;
+      index += 1;
+      continue;
+    }
+
+    throw new Error(`Unknown sync-types flag: ${argument}`);
+  }
+
+  return options;
+}
+
+function printHumanReport(
+  options: SyncTypesCliOptions,
+  report: Awaited<ReturnType<typeof runSyncBlockMetadata>>,
+) {
+  if (report.failure) {
+    console.error("❌ Type sync failed:", report.failure.message);
+    return;
+  }
+
+  console.log(
+    options.check
+      ? "✅ block.json, typia.manifest.json, and typia-validator.php are already up to date with the TypeScript types!"
+      : "✅ block.json, typia.manifest.json, and typia-validator.php were generated from TypeScript types!",
+  );
+  console.log("📝 Generated attributes:", report.attributeNames);
+
+  if (report.lossyProjectionWarnings.length > 0) {
+    console.warn("⚠️ Some Typia constraints were preserved only in typia.manifest.json:");
+    for (const warning of report.lossyProjectionWarnings) {
+      console.warn(`   - ${warning}`);
+    }
+  }
+
+  if (report.phpGenerationWarnings.length > 0) {
+    console.warn("⚠️ Some Typia constraints are not yet enforced by typia-validator.php:");
+    for (const warning of report.phpGenerationWarnings) {
+      console.warn(`   - ${warning}`);
+    }
+  }
+
+  if (report.status === "error") {
+    console.error(
+      "❌ Type sync completed with warnings treated as errors because of the selected flags.",
+    );
+  }
+}
+
+async function main() {
+  const options = parseCliOptions(process.argv.slice(2));
+  const report = await runSyncBlockMetadata({
+    blockJsonFile: "src/block.json",
+    manifestFile: "src/typia.manifest.json",
+    sourceTypeName: "{{pascalCase}}Attributes",
+    typesFile: "src/types.ts",
+  }, {
+    check: options.check,
+    failOnLossy: options.failOnLossy,
+    strict: options.strict,
+  });
+
+  if (options.report === "json") {
+    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+  } else {
+    printHumanReport(options, report);
+  }
+
+  if (report.status === "error") {
+    process.exitCode = 1;
+  }
+}
+
+main().catch((error) => {
+  console.error("❌ Type sync failed:", error);
+  process.exit(1);
+});

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

@@ -0,0 +1,19 @@
+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/base/src/validator-toolkit.ts.mustache

@@ -0,0 +1,31 @@
+import typia from 'typia';
+
+import type { ManifestDefaultsDocument } from '@wp-typia/block-runtime/defaults';
+import {
+	createScaffoldValidatorToolkit,
+	type ScaffoldValidatorToolkitOptions,
+} from '@wp-typia/block-runtime/validation';
+
+interface TemplateValidatorToolkitOptions< T extends object > {
+	finalize?: ScaffoldValidatorToolkitOptions< T >['finalize'];
+	manifest: unknown;
+	onValidationError?: ScaffoldValidatorToolkitOptions< T >['onValidationError'];
+}
+
+export function createTemplateValidatorToolkit< T extends object >( {
+	finalize,
+	manifest,
+	onValidationError,
+}: TemplateValidatorToolkitOptions< T > ) {
+	return createScaffoldValidatorToolkit< T >( {
+		manifest: manifest as ManifestDefaultsDocument,
+		validate: typia.createValidate< T >(),
+		assert: typia.createAssert< T >(),
+		is: typia.createIs< T >(),
+		random: typia.createRandom< T >() as ( ...args: unknown[] ) => T,
+		clone: typia.misc.createClone< T >() as ( value: T ) => T,
+		prune: typia.misc.createPrune< T >(),
+		finalize,
+		onValidationError,
+	} );
+}

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

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "strict": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "baseUrl": ".",
+    "types": ["wordpress__block-editor", "wordpress__blocks"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "build"]
+}

package/templates/_shared/base/webpack.config.js.mustache

@@ -0,0 +1,99 @@
+const fs = require("fs");
+const path = require("path");
+const defaultConfig = require("@wordpress/scripts/config/webpack.config");
+
+const STATIC_ARTIFACT_FILENAMES = new Set([
+	"render.php",
+	"typia.manifest.json",
+	"typia-validator.php",
+	"typia-migration-registry.php",
+]);
+const ROOT_GENERATED_ARTIFACT_FILENAMES = new Set([
+	...STATIC_ARTIFACT_FILENAMES,
+	"typia.schema.json",
+	"typia.openapi.json",
+]);
+
+function isGeneratedArtifact(filename) {
+	return (
+		STATIC_ARTIFACT_FILENAMES.has(filename) ||
+		filename.endsWith(".openapi.json") ||
+		filename.endsWith(".schema.json")
+	);
+}
+
+function getArtifactEntries() {
+	const entries = [];
+
+	for (const filename of ROOT_GENERATED_ARTIFACT_FILENAMES) {
+		const rootArtifactPath = path.resolve(process.cwd(), filename);
+		if (fs.existsSync(rootArtifactPath)) {
+			entries.push({
+				inputPath: rootArtifactPath,
+				outputPath: filename,
+			});
+		}
+	}
+
+	const srcDir = path.resolve(process.cwd(), "src");
+	if (!fs.existsSync(srcDir)) {
+		return entries;
+	}
+
+	for (const inputPath of findArtifactFiles(srcDir)) {
+		entries.push({
+			inputPath,
+			outputPath: path.relative(srcDir, inputPath),
+		});
+	}
+
+	return entries;
+}
+
+function findArtifactFiles(directory) {
+	const artifactFiles = [];
+
+	for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+		const entryPath = path.join(directory, entry.name);
+
+		if (entry.isDirectory()) {
+			artifactFiles.push(...findArtifactFiles(entryPath));
+			continue;
+		}
+		if (entry.isFile() && isGeneratedArtifact(entry.name)) {
+			artifactFiles.push(entryPath);
+		}
+	}
+
+	return artifactFiles;
+}
+
+function resolveOptionalEntry(name, candidates) {
+	for (const candidate of candidates) {
+		const entryPath = path.resolve(process.cwd(), candidate);
+		if (fs.existsSync(entryPath)) {
+			return [name, entryPath];
+		}
+	}
+
+	return null;
+}
+
+module.exports = async () => {
+	const { createTypiaWebpackConfig } = await import("@wp-typia/block-runtime/blocks");
+	const optionalModuleEntries = Object.fromEntries(
+		[
+			resolveOptionalEntry("interactivity", ["src/interactivity.ts", "src/interactivity.js"]),
+			resolveOptionalEntry("view", ["src/view.ts", "src/view.js"]),
+		].filter(Boolean),
+	);
+
+	return createTypiaWebpackConfig({
+		defaultConfig,
+		fs,
+		path,
+		getArtifactEntries,
+		getOptionalModuleEntries: () => optionalModuleEntries,
+		importTypiaWebpackPlugin: () => import("@typia/unplugin/webpack"),
+	});
+};

package/templates/_shared/base/{{slugKebabCase}}.php.mustache

@@ -0,0 +1,53 @@
+<?php
+/**
+ * Plugin Name:       {{title}}
+ * Description:       {{description}}
+ * Version:           0.1.0
+ * Requires at least: 6.7
+ * Tested up to:      6.9
+ * Requires PHP:      8.0
+ * Author:            {{author}}
+ * License:           GPL-2.0-or-later
+ * License URI:       https://www.gnu.org/licenses/gpl-2.0.html
+ * Text Domain:       {{textDomain}}
+ * Domain Path:       /languages
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+function {{phpPrefix}}_load_textdomain() {
+	load_plugin_textdomain(
+		'{{textDomain}}',
+		false,
+		dirname( plugin_basename( __FILE__ ) ) . '/languages'
+	);
+}
+
+function {{phpPrefix}}_get_build_dir() {
+	$candidates = array(
+		__DIR__ . '/build',
+		__DIR__ . '/build/{{slugKebabCase}}',
+	);
+
+	foreach ( $candidates as $candidate ) {
+		if ( file_exists( $candidate . '/block.json' ) ) {
+			return $candidate;
+		}
+	}
+
+	return null;
+}
+
+function {{phpPrefix}}_register_block() {
+	$build_dir = {{phpPrefix}}_get_build_dir();
+	if ( ! $build_dir ) {
+		return;
+	}
+
+	register_block_type( $build_dir );
+}
+
+add_action( 'init', '{{phpPrefix}}_load_textdomain' );
+add_action( 'init', '{{phpPrefix}}_register_block' );

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

@@ -0,0 +1,45 @@
+{
+  "name": "{{slug}}",
+  "version": "0.1.0",
+  "packageManager": "bun@1.3.10",
+  "description": "{{description}}",
+  "author": "{{author}}",
+  "license": "GPL-2.0-or-later",
+  "main": "build/index.js",
+  "scripts": {
+    "add-child": "tsx scripts/add-compound-child.ts",
+    "sync-types": "tsx scripts/sync-types-to-block-json.ts",
+    "build": "bun run sync-types --check && wp-scripts build --experimental-modules",
+    "start": "bun run sync-types && wp-scripts start --experimental-modules",
+    "dev": "bun run start",
+    "typecheck": "bun run sync-types --check && tsc --noEmit",
+    "lint:js": "wp-scripts lint-js",
+    "lint:css": "wp-scripts lint-style",
+    "lint": "bun run lint:js && bun run lint:css",
+    "format": "wp-scripts format"
+  },
+	"devDependencies": {
+		"@wp-typia/block-runtime": "{{blockRuntimePackageVersion}}",
+		"@wp-typia/block-types": "{{blockTypesPackageVersion}}",
+    "@typia/unplugin": "^12.0.1",
+    "@wordpress/browserslist-config": "^6.42.0",
+    "@wordpress/scripts": "^30.22.0",
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.2",
+    "@types/wordpress__block-editor": "^11.5.17",
+    "@types/wordpress__blocks": "^12.5.18",
+    "ajv": "^8.18.0",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "prettier": "2.8.8",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2",
+    "typia": "^12.0.1"
+  },
+  "dependencies": {
+    "@wordpress/block-editor": "^15.2.0",
+    "@wordpress/blocks": "^15.2.0",
+    "@wordpress/components": "^30.2.0",
+    "@wordpress/element": "^6.29.0",
+    "@wordpress/i18n": "^6.2.0"
+  }
+}