@wp-typia/project-tools 0.24.3 → 0.24.5

package/dist/runtime/workspace-inventory-templates.js

@@ -1,277 +1 @@
-export const BLOCK_CONFIG_ENTRY_MARKER = "\t// wp-typia add block entries";
-export const VARIATION_CONFIG_ENTRY_MARKER = "\t// wp-typia add variation entries";
-export const BLOCK_STYLE_CONFIG_ENTRY_MARKER = "\t// wp-typia add style entries";
-export const BLOCK_TRANSFORM_CONFIG_ENTRY_MARKER = "\t// wp-typia add transform entries";
-export const PATTERN_CONFIG_ENTRY_MARKER = "\t// wp-typia add pattern entries";
-export const BINDING_SOURCE_CONFIG_ENTRY_MARKER = "\t// wp-typia add binding-source entries";
-export const CONTRACT_CONFIG_ENTRY_MARKER = "\t// wp-typia add contract entries";
-export const REST_RESOURCE_CONFIG_ENTRY_MARKER = "\t// wp-typia add rest-resource entries";
-/**
- * Marker used to append generated post-meta entries into `POST_META`.
- */
-export const POST_META_CONFIG_ENTRY_MARKER = "\t// wp-typia add post-meta entries";
-export const ABILITY_CONFIG_ENTRY_MARKER = "\t// wp-typia add ability entries";
-export const AI_FEATURE_CONFIG_ENTRY_MARKER = "\t// wp-typia add ai-feature entries";
-export const ADMIN_VIEW_CONFIG_ENTRY_MARKER = "\t// wp-typia add admin-view entries";
-/**
- * Marker used to append generated editor-plugin entries into `EDITOR_PLUGINS`.
- */
-export const EDITOR_PLUGIN_CONFIG_ENTRY_MARKER = "\t// wp-typia add editor-plugin entries";
-export const VARIATIONS_INTERFACE_SECTION = `
-
-export interface WorkspaceVariationConfig {
-\tblock: string;
-\tfile: string;
-\tslug: string;
-}
-`;
-export const VARIATIONS_CONST_SECTION = `
-
-export const VARIATIONS: WorkspaceVariationConfig[] = [
-\t// wp-typia add variation entries
-];
-`;
-export const BLOCK_STYLES_INTERFACE_SECTION = `
-
-export interface WorkspaceBlockStyleConfig {
-\tblock: string;
-\tfile: string;
-\tslug: string;
-}
-`;
-export const BLOCK_STYLES_CONST_SECTION = `
-
-export const BLOCK_STYLES: WorkspaceBlockStyleConfig[] = [
-\t// wp-typia add style entries
-];
-`;
-export const BLOCK_TRANSFORMS_INTERFACE_SECTION = `
-
-export interface WorkspaceBlockTransformConfig {
-\tblock: string;
-\tfile: string;
-\tfrom: string;
-\tslug: string;
-\tto: string;
-}
-`;
-export const BLOCK_TRANSFORMS_CONST_SECTION = `
-
-export const BLOCK_TRANSFORMS: WorkspaceBlockTransformConfig[] = [
-\t// wp-typia add transform entries
-];
-`;
-export const PATTERNS_INTERFACE_SECTION = `
-
-export interface WorkspacePatternConfig {
-\tcontentFile?: string;
-\tfile?: string;
-\tscope?: 'full' | 'section';
-\tsectionRole?: string;
-\tslug: string;
-\ttags?: string[];
-\tthumbnailUrl?: string;
-\ttitle?: string;
-}
-`;
-export const PATTERNS_CONST_SECTION = `
-
-export const PATTERNS: WorkspacePatternConfig[] = [
-\t// wp-typia add pattern entries
-];
-`;
-export const BINDING_SOURCES_INTERFACE_SECTION = `
-
-export interface WorkspaceBindingSourceConfig {
-\tattribute?: string;
-\tblock?: string;
-\teditorFile: string;
-\tmetaPath?: string;
-\tpostMeta?: string;
-\tserverFile: string;
-\tslug: string;
-}
-`;
-export const BINDING_SOURCES_CONST_SECTION = `
-
-export const BINDING_SOURCES: WorkspaceBindingSourceConfig[] = [
-\t// wp-typia add binding-source entries
-];
-`;
-export const CONTRACTS_INTERFACE_SECTION = `
-
-export interface WorkspaceContractConfig {
-\tschemaFile: string;
-\tslug: string;
-\tsourceTypeName: string;
-\ttypesFile: string;
-}
-`;
-export const CONTRACTS_CONST_SECTION = `
-
-export const CONTRACTS: WorkspaceContractConfig[] = [
-\t// wp-typia add contract entries
-];
-`;
-export const REST_RESOURCES_INTERFACE_SECTION = `
-
-export interface WorkspaceRestResourceBaseConfig {
-\tapiFile: string;
-\tauth?: 'authenticated' | 'public' | 'public-write-protected';
-\tbodyTypeName?: string;
-\tclientFile: string;
-\tcontrollerClass?: string;
-\tcontrollerExtends?: string;
-\tnamespace: string;
-\topenApiFile: string;
-\tpermissionCallback?: string;
-\trestManifest?: ReturnType<
-\t\ttypeof import( '@wp-typia/block-runtime/metadata-core' ).defineEndpointManifest
-\t>;
-\tsecretFieldName?: string;
-\tsecretPreserveOnEmpty?: boolean;
-\tsecretStateFieldName?: string;
-\tslug: string;
-\ttypesFile: string;
-\tvalidatorsFile: string;
-}
-
-export interface GeneratedWorkspaceRestResourceConfig extends WorkspaceRestResourceBaseConfig {
-\tdataFile: string;
-\tmethods: Array< 'list' | 'read' | 'create' | 'update' | 'delete' >;
-\tmode?: 'generated';
-\tphpFile: string;
-\troutePattern?: string;
-}
-
-export interface ManualWorkspaceRestResourceConfig extends WorkspaceRestResourceBaseConfig {
-\tmethod: 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';
-\tmethods: [];
-\tmode: 'manual';
-\tpathPattern: string;
-\tqueryTypeName: string;
-\tresponseTypeName: string;
-}
-
-export type WorkspaceRestResourceConfig =
-\t| GeneratedWorkspaceRestResourceConfig
-\t| ManualWorkspaceRestResourceConfig;
-`;
-export const REST_RESOURCES_CONST_SECTION = `
-
-export const REST_RESOURCES: WorkspaceRestResourceConfig[] = [
-\t// wp-typia add rest-resource entries
-];
-`;
-/**
- * Template inserted when repairing `WorkspacePostMetaConfig` in block-config.
- */
-export const POST_META_INTERFACE_SECTION = `
-
-export interface WorkspacePostMetaConfig {
-\tmetaKey: string;
-\tphpFile: string;
-\tpostType: string;
-\tschemaFile: string;
-\tshowInRest: boolean;
-\tslug: string;
-\tsourceTypeName: string;
-\ttypesFile: string;
-}
-`;
-/**
- * Template inserted when repairing the `POST_META` inventory array.
- */
-export const POST_META_CONST_SECTION = `
-
-export const POST_META: WorkspacePostMetaConfig[] = [
-\t// wp-typia add post-meta entries
-];
-`;
-export const WORKSPACE_COMPATIBILITY_CONFIG_FIELD = `\tcompatibility?: {
-\t\thardMinimums: {
-\t\t\tphp?: string;
-\t\t\twordpress?: string;
-\t\t};
-\t\tmode: 'baseline' | 'optional' | 'required';
-\t\toptionalFeatureIds: string[];
-\t\toptionalFeatures: string[];
-\t\trequiredFeatureIds: string[];
-\t\trequiredFeatures: string[];
-\t\truntimeGates: string[];
-\t};
-`;
-export const ABILITIES_INTERFACE_SECTION = `
-
-export interface WorkspaceAbilityConfig {
-\tclientFile: string;
-${WORKSPACE_COMPATIBILITY_CONFIG_FIELD}\tconfigFile: string;
-\tdataFile: string;
-\tinputSchemaFile: string;
-\tinputTypeName: string;
-\toutputSchemaFile: string;
-\toutputTypeName: string;
-\tphpFile: string;
-\tslug: string;
-\ttypesFile: string;
-}
-`;
-export const ABILITIES_CONST_SECTION = `
-
-export const ABILITIES: WorkspaceAbilityConfig[] = [
-\t// wp-typia add ability entries
-];
-`;
-export const AI_FEATURES_INTERFACE_SECTION = `
-
-export interface WorkspaceAiFeatureConfig {
-\taiSchemaFile: string;
-\tapiFile: string;
-\tclientFile: string;
-${WORKSPACE_COMPATIBILITY_CONFIG_FIELD}\tdataFile: string;
-\tnamespace: string;
-\topenApiFile: string;
-\tphpFile: string;
-\trestManifest?: ReturnType<
-\t\ttypeof import( '@wp-typia/block-runtime/metadata-core' ).defineEndpointManifest
-\t>;
-\tslug: string;
-\ttypesFile: string;
-\tvalidatorsFile: string;
-}
-`;
-export const AI_FEATURES_CONST_SECTION = `
-
-export const AI_FEATURES: WorkspaceAiFeatureConfig[] = [
-\t// wp-typia add ai-feature entries
-];
-`;
-export const ADMIN_VIEWS_INTERFACE_SECTION = `
-
-export interface WorkspaceAdminViewConfig {
-\tfile: string;
-\tphpFile: string;
-\tslug: string;
-\tsource?: string;
-}
-`;
-export const ADMIN_VIEWS_CONST_SECTION = `
-
-export const ADMIN_VIEWS: WorkspaceAdminViewConfig[] = [
-\t// wp-typia add admin-view entries
-];
-`;
-export const EDITOR_PLUGINS_INTERFACE_SECTION = `
-
-export interface WorkspaceEditorPluginConfig {
-\tfile: string;
-\tslug: string;
-\tslot: string;
-}
-`;
-export const EDITOR_PLUGINS_CONST_SECTION = `
-
-export const EDITOR_PLUGINS: WorkspaceEditorPluginConfig[] = [
-\t// wp-typia add editor-plugin entries
-];
-`;
+export * from "./workspace/workspace-inventory-templates.js";

package/dist/runtime/workspace-inventory-types.d.ts

@@ -1,229 +1 @@
-export interface WorkspaceBlockInventoryEntry {
-    apiTypesFile?: string;
-    attributeTypeName?: string;
-    openApiFile?: string;
-    slug: string;
-    typesFile: string;
-}
-export interface WorkspaceVariationInventoryEntry {
-    block: string;
-    file: string;
-    slug: string;
-}
-export interface WorkspaceBlockStyleInventoryEntry {
-    block: string;
-    file: string;
-    slug: string;
-}
-export interface WorkspaceBlockTransformInventoryEntry {
-    block: string;
-    file: string;
-    from: string;
-    slug: string;
-    to: string;
-}
-export interface WorkspacePatternInventoryEntry {
-    contentFile?: string;
-    file?: string;
-    scope?: string;
-    sectionRole?: string;
-    slug: string;
-    tags?: string[];
-    thumbnailUrl?: string;
-    title?: string;
-}
-export interface WorkspaceBindingSourceInventoryEntry {
-    attribute?: string;
-    block?: string;
-    editorFile: string;
-    metaPath?: string;
-    postMeta?: string;
-    serverFile: string;
-    slug: string;
-}
-/**
- * Standalone TypeScript contract entry parsed from `scripts/block-config.ts`.
- *
- * These contracts generate JSON Schema artifacts without owning a WordPress REST
- * route, so smoke tests and external integrations can reference stable schema
- * names from the workspace inventory.
- */
-export interface WorkspaceContractInventoryEntry {
-    schemaFile: string;
-    slug: string;
-    sourceTypeName: string;
-    typesFile: string;
-}
-/**
- * REST-resource entry parsed from `scripts/block-config.ts`.
- *
- * Each file path is stored relative to the workspace root so doctor checks and
- * workspace mutation helpers can resolve the generated TypeScript, OpenAPI, and
- * PHP route artifacts without guessing their locations.
- */
-export interface WorkspaceRestResourceInventoryEntry {
-    apiFile: string;
-    auth?: string;
-    bodyTypeName?: string;
-    clientFile: string;
-    controllerClass?: string;
-    controllerExtends?: string;
-    dataFile?: string;
-    method?: string;
-    methods: string[];
-    mode?: "generated" | "manual";
-    namespace: string;
-    openApiFile: string;
-    pathPattern?: string;
-    permissionCallback?: string;
-    phpFile?: string;
-    queryTypeName?: string;
-    responseTypeName?: string;
-    routePattern?: string;
-    secretFieldName?: string;
-    secretPreserveOnEmpty?: boolean;
-    secretStateFieldName?: string;
-    slug: string;
-    typesFile: string;
-    validatorsFile: string;
-}
-/**
- * Post-meta contract entry parsed from `scripts/block-config.ts`.
- *
- * The TypeScript source and schema artifact define the persisted meta value
- * shape, while the PHP file registers the matching WordPress post-meta key for
- * the declared post type scope.
- */
-export interface WorkspacePostMetaInventoryEntry {
-    metaKey: string;
-    phpFile: string;
-    postType: string;
-    schemaFile: string;
-    showInRest: boolean;
-    slug: string;
-    sourceTypeName: string;
-    typesFile: string;
-}
-/**
- * Ability entry parsed from `scripts/block-config.ts`.
- *
- * Each file path stays relative to the workspace root so doctor checks, schema
- * sync scripts, and generated admin/editor helpers can resolve typed workflow
- * artifacts without guessing their locations.
- */
-export interface WorkspaceAbilityInventoryEntry {
-    clientFile: string;
-    configFile: string;
-    dataFile: string;
-    inputSchemaFile: string;
-    inputTypeName: string;
-    outputSchemaFile: string;
-    outputTypeName: string;
-    phpFile: string;
-    slug: string;
-    typesFile: string;
-}
-/**
- * AI-feature entry parsed from `scripts/block-config.ts`.
- *
- * Each file path stays relative to the workspace root so doctor checks, add
- * workflows, and split sync scripts can reason about the REST and AI-safe
- * artifacts without guessing their locations.
- */
-export interface WorkspaceAiFeatureInventoryEntry {
-    aiSchemaFile: string;
-    apiFile: string;
-    clientFile: string;
-    dataFile: string;
-    namespace: string;
-    openApiFile: string;
-    phpFile: string;
-    slug: string;
-    typesFile: string;
-    validatorsFile: string;
-}
-/**
- * DataViews admin-screen entry parsed from `scripts/block-config.ts`.
- *
- * @property file Relative path to the generated admin view shared entry file.
- * @property phpFile Relative path to the generated WordPress admin page glue.
- * @property slug Normalized admin view slug.
- * @property source Optional source locator such as `rest-resource:products` or
- * `core-data:postType/post`.
- */
-export interface WorkspaceAdminViewInventoryEntry {
-    file: string;
-    phpFile: string;
-    slug: string;
-    source?: string;
-}
-/**
- * Editor-plugin entry parsed from `scripts/block-config.ts`.
- *
- * @property file Relative path to the generated editor plugin entry file.
- * @property slug Normalized editor plugin slug.
- * @property slot Canonical editor shell slot for the plugin scaffold.
- */
-export interface WorkspaceEditorPluginInventoryEntry {
-    file: string;
-    slug: string;
-    slot: string;
-}
-export interface WorkspaceInventory {
-    adminViews: WorkspaceAdminViewInventoryEntry[];
-    bindingSources: WorkspaceBindingSourceInventoryEntry[];
-    blockConfigPath: string;
-    blocks: WorkspaceBlockInventoryEntry[];
-    blockStyles: WorkspaceBlockStyleInventoryEntry[];
-    blockTransforms: WorkspaceBlockTransformInventoryEntry[];
-    contracts: WorkspaceContractInventoryEntry[];
-    abilities: WorkspaceAbilityInventoryEntry[];
-    aiFeatures: WorkspaceAiFeatureInventoryEntry[];
-    hasAbilitiesSection: boolean;
-    hasAdminViewsSection: boolean;
-    hasBindingSourcesSection: boolean;
-    hasAiFeaturesSection: boolean;
-    hasBlockStylesSection: boolean;
-    hasBlockTransformsSection: boolean;
-    hasContractsSection: boolean;
-    hasEditorPluginsSection: boolean;
-    hasPatternsSection: boolean;
-    hasPostMetaSection: boolean;
-    hasRestResourcesSection: boolean;
-    hasVariationsSection: boolean;
-    editorPlugins: WorkspaceEditorPluginInventoryEntry[];
-    patterns: WorkspacePatternInventoryEntry[];
-    postMeta: WorkspacePostMetaInventoryEntry[];
-    restResources: WorkspaceRestResourceInventoryEntry[];
-    source: string;
-    variations: WorkspaceVariationInventoryEntry[];
-}
-export type WorkspaceBlockSelectOption = {
-    description: string;
-    name: string;
-    value: string;
-};
-export type WorkspaceInventoryParseResult = Omit<WorkspaceInventory, "blockConfigPath">;
-export type WorkspaceInventoryEntriesKey = {
-    [Key in keyof WorkspaceInventoryParseResult]: WorkspaceInventoryParseResult[Key] extends unknown[] ? Key : never;
-}[keyof WorkspaceInventoryParseResult];
-export type WorkspaceInventorySectionFlagKey = {
-    [Key in keyof WorkspaceInventoryParseResult]: WorkspaceInventoryParseResult[Key] extends boolean ? Key : never;
-}[keyof WorkspaceInventoryParseResult];
-export type WorkspaceInventoryUpdateOptions = {
-    abilityEntries?: string[];
-    adminViewEntries?: string[];
-    aiFeatureEntries?: string[];
-    blockEntries?: string[];
-    blockStyleEntries?: string[];
-    blockTransformEntries?: string[];
-    bindingSourceEntries?: string[];
-    contractEntries?: string[];
-    editorPluginEntries?: string[];
-    patternEntries?: string[];
-    postMetaEntries?: string[];
-    restResourceEntries?: string[];
-    transformSource?: (source: string) => string;
-    variationEntries?: string[];
-};
-export type WorkspaceInventoryAppendOptionKey = Exclude<keyof WorkspaceInventoryUpdateOptions, "transformSource">;
+export * from "./workspace/workspace-inventory-types.js";

package/dist/runtime/workspace-inventory-types.js

@@ -1 +1 @@
-export {};
+export * from "./workspace/workspace-inventory-types.js";

package/dist/runtime/workspace-inventory.d.ts

@@ -1,5 +1 @@
-export { ABILITY_CONFIG_ENTRY_MARKER, ADMIN_VIEW_CONFIG_ENTRY_MARKER, AI_FEATURE_CONFIG_ENTRY_MARKER, BINDING_SOURCE_CONFIG_ENTRY_MARKER, BLOCK_CONFIG_ENTRY_MARKER, BLOCK_STYLE_CONFIG_ENTRY_MARKER, BLOCK_TRANSFORM_CONFIG_ENTRY_MARKER, CONTRACT_CONFIG_ENTRY_MARKER, EDITOR_PLUGIN_CONFIG_ENTRY_MARKER, PATTERN_CONFIG_ENTRY_MARKER, POST_META_CONFIG_ENTRY_MARKER, REST_RESOURCE_CONFIG_ENTRY_MARKER, VARIATION_CONFIG_ENTRY_MARKER, } from "./workspace-inventory-templates.js";
-export { parseWorkspaceInventorySource } from "./workspace-inventory-parser.js";
-export { getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, readWorkspaceInventory, readWorkspaceInventoryAsync, } from "./workspace-inventory-read.js";
-export { appendWorkspaceInventoryEntries, updateWorkspaceInventorySource, } from "./workspace-inventory-mutations.js";
-export type { WorkspaceAbilityInventoryEntry, WorkspaceAdminViewInventoryEntry, WorkspaceAiFeatureInventoryEntry, WorkspaceBindingSourceInventoryEntry, WorkspaceBlockInventoryEntry, WorkspaceBlockSelectOption, WorkspaceBlockStyleInventoryEntry, WorkspaceBlockTransformInventoryEntry, WorkspaceContractInventoryEntry, WorkspaceEditorPluginInventoryEntry, WorkspaceInventory, WorkspacePatternInventoryEntry, WorkspacePostMetaInventoryEntry, WorkspaceRestResourceInventoryEntry, WorkspaceVariationInventoryEntry, } from "./workspace-inventory-types.js";
+export * from "./workspace/workspace-inventory.js";

package/dist/runtime/workspace-inventory.js

@@ -1,4 +1 @@
-export { ABILITY_CONFIG_ENTRY_MARKER, ADMIN_VIEW_CONFIG_ENTRY_MARKER, AI_FEATURE_CONFIG_ENTRY_MARKER, BINDING_SOURCE_CONFIG_ENTRY_MARKER, BLOCK_CONFIG_ENTRY_MARKER, BLOCK_STYLE_CONFIG_ENTRY_MARKER, BLOCK_TRANSFORM_CONFIG_ENTRY_MARKER, CONTRACT_CONFIG_ENTRY_MARKER, EDITOR_PLUGIN_CONFIG_ENTRY_MARKER, PATTERN_CONFIG_ENTRY_MARKER, POST_META_CONFIG_ENTRY_MARKER, REST_RESOURCE_CONFIG_ENTRY_MARKER, VARIATION_CONFIG_ENTRY_MARKER, } from "./workspace-inventory-templates.js";
-export { parseWorkspaceInventorySource } from "./workspace-inventory-parser.js";
-export { getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, readWorkspaceInventory, readWorkspaceInventoryAsync, } from "./workspace-inventory-read.js";
-export { appendWorkspaceInventoryEntries, updateWorkspaceInventorySource, } from "./workspace-inventory-mutations.js";
+export * from "./workspace/workspace-inventory.js";

package/dist/runtime/workspace-project.d.ts

@@ -1,66 +1 @@
-import { type PackageManagerId } from "./package-managers.js";
-export declare const WORKSPACE_TEMPLATE_PACKAGE = "@wp-typia/create-workspace-template";
-export interface WorkspacePackageJson {
-    author?: string;
-    name?: string;
-    packageManager?: string;
-    scripts?: Record<string, string>;
-    wpTypia?: {
-        namespace?: string;
-        phpPrefix?: string;
-        projectType?: string;
-        templatePackage?: string;
-        textDomain?: string;
-    };
-}
-export interface WorkspaceProject {
-    author: string;
-    packageManager: PackageManagerId;
-    packageName: string;
-    projectDir: string;
-    workspace: Required<NonNullable<WorkspacePackageJson["wpTypia"]>>;
-}
-/**
- * Parse a workspace package manifest from a project directory or `package.json` path.
- *
- * @param projectDirOrManifestPath Absolute or relative project directory, or a direct
- * path to `package.json`.
- * @returns The parsed workspace package manifest.
- * @throws {Error} When the manifest cannot be parsed.
- */
-export declare function parseWorkspacePackageJson(projectDirOrManifestPath: string): WorkspacePackageJson;
-/**
- * Explain why a nearby wp-typia workspace cannot be resolved from `startDir`.
- *
- * @param startDir Directory to begin walking upward from.
- * @returns A human-readable validation error when a candidate workspace package
- * manifest is found but its `wpTypia` metadata is invalid, or `null` when no
- * invalid workspace candidate is discovered.
- * @throws {Error} When a discovered `package.json` cannot be parsed.
- */
-export declare function getInvalidWorkspaceProjectReason(startDir: string): string | null;
-/**
- * Parse a package-manager identifier from a `packageManager` field.
- *
- * @param packageManagerField Raw package-manager field such as `bun@1.3.11`.
- * @returns A normalized `PackageManagerId`, defaulting to `"npm"` when the
- * field is missing or unsupported.
- */
-export declare function parseWorkspacePackageManagerId(packageManagerField: string | undefined): PackageManagerId;
-/**
- * Try to resolve the nearest official wp-typia workspace from `startDir`.
- *
- * @param startDir Directory to begin walking upward from.
- * @returns The resolved `WorkspaceProject`, or `null` when no
- * `WORKSPACE_TEMPLATE_PACKAGE` workspace is found.
- * @throws {Error} When a discovered `package.json` cannot be parsed.
- */
-export declare function tryResolveWorkspaceProject(startDir: string): WorkspaceProject | null;
-/**
- * Resolve the nearest official wp-typia workspace from `startDir`.
- *
- * @param startDir Directory to begin walking upward from.
- * @returns The resolved `WorkspaceProject`.
- * @throws {Error} When no `WORKSPACE_TEMPLATE_PACKAGE` workspace can be found.
- */
-export declare function resolveWorkspaceProject(startDir: string): WorkspaceProject;
+export * from "./workspace/workspace-project.js";