@wp-typia/project-tools 0.24.4 → 0.24.5

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

@@ -1,37 +1 @@
-import type { ManifestDocument } from "./migration-types.js";
-import type { ScaffoldTemplateVariables } from "./scaffold.js";
-import type { BuiltInTemplateId } from "./template-registry.js";
-export interface BuiltInBlockArtifact {
-    blockJsonDocument: Record<string, unknown>;
-    manifestDocument: ManifestDocument;
-    relativeDir: string;
-    typesSource: string;
-}
-/**
- * Builds a starter manifest document for a generated compound child block.
- *
- * @param childTypeName TypeScript source type name for the child manifest.
- * @param childTitle Default title used by the child block.
- * @param bodyPlaceholder Optional placeholder used for the child body field.
- * @returns Starter manifest metadata for the compound child block.
- */
-export declare function buildCompoundChildStarterManifestDocument(childTypeName: string, childTitle: string, bodyPlaceholder?: string): ManifestDocument;
-/**
- * Generates typed structural artifacts for a built-in block scaffold.
- *
- * @param options.templateId Built-in template family to emit.
- * @param options.variables Resolved scaffold template variables.
- * @returns Structural artifacts for the built-in block, including compound
- * parent and child outputs when applicable.
- */
-export declare function buildBuiltInBlockArtifacts({ templateId, variables, }: {
-    templateId: BuiltInTemplateId;
-    variables: ScaffoldTemplateVariables;
-}): BuiltInBlockArtifact[];
-/**
- * Serializes a generated `block.json` document using scaffold formatting.
- *
- * @param document Structured `block.json` document.
- * @returns Pretty-printed JSON with a trailing newline.
- */
-export declare function stringifyBuiltInBlockJsonDocument(document: Record<string, unknown>): string;
+export * from "./templates/built-in-block-artifacts.js";

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

@@ -1,223 +1 @@
-import { buildBasicAttributes, buildBlockJsonAttributes, buildCompoundChildAttributes, buildCompoundParentAttributes, buildInteractivityAttributes, buildManifestDocument, buildPersistenceAttributes, DEFAULT_COMPOUND_CHILD_BODY_PLACEHOLDER, } from "./built-in-block-artifact-documents.js";
-import { buildBasicTypesSource, buildCompoundChildTypesSource, buildCompoundTypesSource, buildInteractivityTypesSource, buildPersistenceTypesSource, } from "./built-in-block-artifact-types.js";
-import { getScaffoldTemplateVariableGroups } from "./scaffold-template-variable-groups.js";
-function stringifyBlockJsonDocument(document) {
-    return `${JSON.stringify(document, null, "\t")}\n`;
-}
-function buildBasicArtifact(variables) {
-    const attributes = buildBasicAttributes();
-    return {
-        blockJsonDocument: {
-            $schema: "https://schemas.wp.org/trunk/block.json",
-            apiVersion: 3,
-            name: `${variables.namespace}/${variables.slug}`,
-            version: variables.blockMetadataVersion,
-            title: variables.title,
-            category: variables.category,
-            icon: variables.icon,
-            description: variables.description,
-            keywords: [variables.keyword, "typia", "block"],
-            example: {
-                attributes: {
-                    content: "Example content",
-                    alignment: "center",
-                    isVisible: true,
-                },
-            },
-            supports: {
-                html: false,
-            },
-            textdomain: variables.textDomain,
-            editorScript: "file:./index.js",
-            editorStyle: "file:./index.css",
-            style: "file:./style-index.css",
-            attributes: buildBlockJsonAttributes(attributes),
-        },
-        manifestDocument: buildManifestDocument(`${variables.pascalCase}Attributes`, attributes),
-        relativeDir: "src",
-        typesSource: buildBasicTypesSource(variables, attributes),
-    };
-}
-function buildInteractivityArtifact(variables) {
-    const attributes = buildInteractivityAttributes(variables);
-    return {
-        blockJsonDocument: {
-            $schema: "https://schemas.wp.org/trunk/block.json",
-            apiVersion: 3,
-            name: `${variables.namespace}/${variables.slugKebabCase}`,
-            version: variables.blockMetadataVersion,
-            title: variables.title,
-            category: variables.category,
-            icon: variables.icon,
-            description: variables.description,
-            example: {},
-            supports: {
-                html: false,
-                align: true,
-                anchor: true,
-                className: true,
-                interactivity: true,
-            },
-            attributes: buildBlockJsonAttributes(attributes),
-            textdomain: variables.textDomain,
-            editorScript: "file:./index.js",
-            editorStyle: "file:./index.css",
-            style: "file:./style-index.css",
-            viewScriptModule: "file:./interactivity.js",
-        },
-        manifestDocument: buildManifestDocument(`${variables.pascalCase}Attributes`, attributes),
-        relativeDir: "src",
-        typesSource: buildInteractivityTypesSource(variables, attributes),
-    };
-}
-function buildPersistenceArtifact(variables) {
-    const attributes = buildPersistenceAttributes(variables);
-    return {
-        blockJsonDocument: {
-            $schema: "https://schemas.wp.org/trunk/block.json",
-            apiVersion: 3,
-            name: `${variables.namespace}/${variables.slugKebabCase}`,
-            version: variables.blockMetadataVersion,
-            title: variables.title,
-            category: variables.category,
-            icon: variables.icon,
-            description: variables.description,
-            example: {},
-            supports: {
-                html: false,
-                align: true,
-                anchor: true,
-                className: true,
-                interactivity: true,
-            },
-            attributes: buildBlockJsonAttributes(attributes),
-            textdomain: variables.textDomain,
-            editorScript: "file:./index.js",
-            style: "file:./style-index.css",
-            viewScriptModule: "file:./interactivity.js",
-            render: "file:./render.php",
-        },
-        manifestDocument: buildManifestDocument(`${variables.pascalCase}Attributes`, attributes),
-        relativeDir: "src",
-        typesSource: buildPersistenceTypesSource(variables, attributes),
-    };
-}
-function buildCompoundParentArtifact(variables) {
-    const attributes = buildCompoundParentAttributes(variables);
-    const compoundGroup = getScaffoldTemplateVariableGroups(variables).compound;
-    const persistenceEnabled = compoundGroup.enabled && compoundGroup.persistenceEnabled;
-    return {
-        blockJsonDocument: {
-            $schema: "https://schemas.wp.org/trunk/block.json",
-            apiVersion: 3,
-            name: `${variables.namespace}/${variables.slugKebabCase}`,
-            version: variables.blockMetadataVersion,
-            title: variables.title,
-            category: variables.category,
-            icon: variables.icon,
-            description: variables.description,
-            example: {},
-            allowedBlocks: [`${variables.namespace}/${variables.slugKebabCase}-item`],
-            supports: persistenceEnabled
-                ? {
-                    html: false,
-                    anchor: true,
-                    className: true,
-                    interactivity: true,
-                }
-                : {
-                    html: false,
-                    anchor: true,
-                    className: true,
-                },
-            attributes: buildBlockJsonAttributes(attributes),
-            textdomain: variables.textDomain,
-            editorScript: "file:./index.js",
-            style: "file:./style-index.css",
-            ...(persistenceEnabled
-                ? {
-                    viewScriptModule: "file:./interactivity.js",
-                    render: "file:./render.php",
-                }
-                : {}),
-        },
-        manifestDocument: buildManifestDocument(`${variables.pascalCase}Attributes`, attributes),
-        relativeDir: `src/blocks/${variables.slugKebabCase}`,
-        typesSource: buildCompoundTypesSource(variables, attributes),
-    };
-}
-function buildCompoundChildArtifact(variables, bodyPlaceholder = DEFAULT_COMPOUND_CHILD_BODY_PLACEHOLDER) {
-    const attributes = buildCompoundChildAttributes(variables.compoundChildTitle, variables.compoundChildCssClassName, bodyPlaceholder);
-    return {
-        blockJsonDocument: {
-            $schema: "https://schemas.wp.org/trunk/block.json",
-            apiVersion: 3,
-            name: `${variables.namespace}/${variables.slugKebabCase}-item`,
-            version: variables.blockMetadataVersion,
-            title: variables.compoundChildTitle,
-            category: variables.compoundChildCategory,
-            icon: variables.compoundChildIcon,
-            description: `Internal item block used by ${variables.title}.`,
-            parent: [`${variables.namespace}/${variables.slugKebabCase}`],
-            example: {},
-            supports: {
-                html: false,
-                inserter: false,
-                reusable: false,
-            },
-            attributes: buildBlockJsonAttributes(attributes),
-            textdomain: variables.textDomain,
-            editorScript: "file:./index.js",
-        },
-        manifestDocument: buildManifestDocument(`${variables.pascalCase}ItemAttributes`, attributes),
-        relativeDir: `src/blocks/${variables.slugKebabCase}-item`,
-        typesSource: buildCompoundChildTypesSource(variables, attributes),
-    };
-}
-/**
- * Builds a starter manifest document for a generated compound child block.
- *
- * @param childTypeName TypeScript source type name for the child manifest.
- * @param childTitle Default title used by the child block.
- * @param bodyPlaceholder Optional placeholder used for the child body field.
- * @returns Starter manifest metadata for the compound child block.
- */
-export function buildCompoundChildStarterManifestDocument(childTypeName, childTitle, bodyPlaceholder = DEFAULT_COMPOUND_CHILD_BODY_PLACEHOLDER) {
-    const attributes = buildCompoundChildAttributes(childTitle, null, bodyPlaceholder);
-    return buildManifestDocument(childTypeName, attributes);
-}
-/**
- * Generates typed structural artifacts for a built-in block scaffold.
- *
- * @param options.templateId Built-in template family to emit.
- * @param options.variables Resolved scaffold template variables.
- * @returns Structural artifacts for the built-in block, including compound
- * parent and child outputs when applicable.
- */
-export function buildBuiltInBlockArtifacts({ templateId, variables, }) {
-    if (templateId === "basic") {
-        return [buildBasicArtifact(variables)];
-    }
-    if (templateId === "interactivity") {
-        return [buildInteractivityArtifact(variables)];
-    }
-    if (templateId === "persistence") {
-        return [buildPersistenceArtifact(variables)];
-    }
-    if (templateId === "compound") {
-        return [
-            buildCompoundParentArtifact(variables),
-            buildCompoundChildArtifact(variables),
-        ];
-    }
-    return [];
-}
-/**
- * Serializes a generated `block.json` document using scaffold formatting.
- *
- * @param document Structured `block.json` document.
- * @returns Pretty-printed JSON with a trailing newline.
- */
-export function stringifyBuiltInBlockJsonDocument(document) {
-    return stringifyBlockJsonDocument(document);
-}
+export * from "./templates/built-in-block-artifacts.js";

package/dist/runtime/built-in-block-attribute-emitters.d.ts

@@ -1,71 +1 @@
-import type { JsonValue, ManifestAttribute, ManifestConstraints, ManifestDocument } from "./migration-types.js";
-/**
- * Default placeholder copy used for generated compound child body fields.
- */
-export declare const DEFAULT_COMPOUND_CHILD_BODY_PLACEHOLDER = "Add supporting details for this internal item.";
-type StarterManifestSourceType = NonNullable<ManifestAttribute["wp"]["type"]>;
-type WordPressAttributeSource = NonNullable<ManifestAttribute["wp"]["source"]>;
-interface StarterManifestAttributeDefinition {
-    constraints?: Partial<ManifestConstraints>;
-    defaultValue?: JsonValue;
-    enumValues?: Array<string | number | boolean> | null;
-    kind: ManifestAttribute["ts"]["kind"];
-    required: boolean;
-    selector?: string | null;
-    source?: WordPressAttributeSource | null;
-    sourceType: StarterManifestSourceType;
-}
-interface BlockJsonAttributeDefinition {
-    defaultValue?: JsonValue;
-    enumValues?: Array<string | number | boolean> | null;
-    selector?: string;
-    source?: WordPressAttributeSource;
-    type: StarterManifestSourceType;
-}
-export interface AttributeDescription {
-    lines: string[];
-}
-/**
- * Emitted attribute metadata shared between block.json, manifest, and type emitters.
- */
-export interface EmittedAttributeDefinition {
-    blockJson: BlockJsonAttributeDefinition;
-    description?: AttributeDescription;
-    manifest: StarterManifestAttributeDefinition;
-    name: string;
-    optional: boolean;
-    typeExpression: string;
-}
-type BuiltInAttributeValueResolver<TContext, TValue> = TValue | ((context: TContext) => TValue);
-export interface BuiltInAttributeTemplateSpec<TContext> {
-    attributeType: "boolean" | "number" | "string";
-    blockJsonDefaultValue?: BuiltInAttributeValueResolver<TContext, JsonValue | undefined>;
-    constraints?: BuiltInAttributeValueResolver<TContext, Partial<ManifestConstraints> | undefined>;
-    defaultValue?: BuiltInAttributeValueResolver<TContext, JsonValue | undefined>;
-    description?: BuiltInAttributeValueResolver<TContext, AttributeDescription | undefined>;
-    enumValues?: BuiltInAttributeValueResolver<TContext, Array<string | number | boolean> | null | undefined>;
-    manifestDefaultValue?: BuiltInAttributeValueResolver<TContext, JsonValue | undefined>;
-    name: string;
-    optional: boolean;
-    selector?: BuiltInAttributeValueResolver<TContext, string | null | undefined>;
-    source?: BuiltInAttributeValueResolver<TContext, WordPressAttributeSource | null | undefined>;
-    typeExpression: BuiltInAttributeValueResolver<TContext, string>;
-}
-export declare function describe(...lines: string[]): AttributeDescription;
-export declare function buildAttributesFromSpecs<TContext>(specs: readonly BuiltInAttributeTemplateSpec<TContext>[], context: TContext): EmittedAttributeDefinition[];
-/**
- * Builds the manifest document for a generated built-in block artifact.
- *
- * @param sourceType Generated TypeScript source type name referenced by the manifest.
- * @param attributes Emitted attribute definitions used to populate the manifest.
- * @returns A starter manifest document for the generated block.
- */
-export declare function buildManifestDocument(sourceType: string, attributes: readonly EmittedAttributeDefinition[]): ManifestDocument;
-/**
- * Builds the block.json attributes object for a generated built-in block artifact.
- *
- * @param attributes Emitted attribute definitions used to populate block.json.
- * @returns A block.json-compatible attributes record.
- */
-export declare function buildBlockJsonAttributes(attributes: readonly EmittedAttributeDefinition[]): Record<string, Record<string, unknown>>;
-export {};
+export * from "./templates/built-in-block-attribute-emitters.js";

package/dist/runtime/built-in-block-attribute-emitters.js

@@ -1,176 +1 @@
-/**
- * Default placeholder copy used for generated compound child body fields.
- */
-export 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 createManifestAttribute({ constraints, defaultValue, enumValues = null, kind, required, selector = null, source = null, 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,
-            ...(selector ? { selector } : {}),
-            ...(source ? { source } : {}),
-            type: sourceType,
-        },
-    };
-}
-function createBlockJsonAttribute({ defaultValue, enumValues = null, selector, source, type, }) {
-    const attribute = {
-        type,
-    };
-    if (defaultValue !== undefined) {
-        attribute.default = defaultValue;
-    }
-    if (enumValues !== null && enumValues.length > 0) {
-        attribute.enum = enumValues;
-    }
-    if (source) {
-        attribute.source = source;
-    }
-    if (selector) {
-        attribute.selector = selector;
-    }
-    return attribute;
-}
-export function describe(...lines) {
-    return {
-        lines,
-    };
-}
-function defineAttribute({ blockJsonDefaultValue, constraints, defaultValue, description, enumValues = null, kind, manifestDefaultValue, name, optional, selector = null, source = null, sourceType, typeExpression, }) {
-    const resolvedBlockJsonDefaultValue = blockJsonDefaultValue !== undefined ? blockJsonDefaultValue : defaultValue;
-    const resolvedManifestDefaultValue = manifestDefaultValue !== undefined ? manifestDefaultValue : defaultValue;
-    return {
-        blockJson: {
-            defaultValue: resolvedBlockJsonDefaultValue,
-            enumValues,
-            ...(selector ? { selector } : {}),
-            ...(source ? { source } : {}),
-            type: sourceType,
-        },
-        description,
-        manifest: {
-            constraints,
-            defaultValue: resolvedManifestDefaultValue,
-            enumValues,
-            kind,
-            required: !optional,
-            selector,
-            source,
-            sourceType,
-        },
-        name,
-        optional,
-        typeExpression,
-    };
-}
-function defineStringAttribute(spec) {
-    return defineAttribute({
-        ...spec,
-        kind: "string",
-        sourceType: "string",
-    });
-}
-function defineBooleanAttribute(spec) {
-    return defineAttribute({
-        ...spec,
-        kind: "boolean",
-        sourceType: "boolean",
-    });
-}
-function defineNumberAttribute(spec) {
-    return defineAttribute({
-        ...spec,
-        kind: "number",
-        sourceType: "number",
-    });
-}
-function resolveBuiltInAttributeValue(value, context) {
-    if (typeof value === "function") {
-        return value(context);
-    }
-    return value;
-}
-export function buildAttributesFromSpecs(specs, context) {
-    return specs.map((spec) => {
-        const resolvedSpec = {
-            blockJsonDefaultValue: resolveBuiltInAttributeValue(spec.blockJsonDefaultValue, context),
-            constraints: resolveBuiltInAttributeValue(spec.constraints, context),
-            defaultValue: resolveBuiltInAttributeValue(spec.defaultValue, context),
-            description: resolveBuiltInAttributeValue(spec.description, context),
-            enumValues: resolveBuiltInAttributeValue(spec.enumValues, context),
-            manifestDefaultValue: resolveBuiltInAttributeValue(spec.manifestDefaultValue, context),
-            name: spec.name,
-            optional: spec.optional,
-            selector: resolveBuiltInAttributeValue(spec.selector, context),
-            source: resolveBuiltInAttributeValue(spec.source, context),
-            typeExpression: resolveBuiltInAttributeValue(spec.typeExpression, context) ?? "unknown",
-        };
-        if (spec.attributeType === "boolean") {
-            return defineBooleanAttribute(resolvedSpec);
-        }
-        if (spec.attributeType === "number") {
-            return defineNumberAttribute(resolvedSpec);
-        }
-        return defineStringAttribute(resolvedSpec);
-    });
-}
-/**
- * Builds the manifest document for a generated built-in block artifact.
- *
- * @param sourceType Generated TypeScript source type name referenced by the manifest.
- * @param attributes Emitted attribute definitions used to populate the manifest.
- * @returns A starter manifest document for the generated block.
- */
-export function buildManifestDocument(sourceType, attributes) {
-    return {
-        attributes: Object.fromEntries(attributes.map((attribute) => [
-            attribute.name,
-            createManifestAttribute(attribute.manifest),
-        ])),
-        manifestVersion: 2,
-        sourceType,
-    };
-}
-/**
- * Builds the block.json attributes object for a generated built-in block artifact.
- *
- * @param attributes Emitted attribute definitions used to populate block.json.
- * @returns A block.json-compatible attributes record.
- */
-export function buildBlockJsonAttributes(attributes) {
-    return Object.fromEntries(attributes.map((attribute) => [
-        attribute.name,
-        createBlockJsonAttribute(attribute.blockJson),
-    ]));
-}
+export * from "./templates/built-in-block-attribute-emitters.js";

package/dist/runtime/built-in-block-attribute-specs.d.ts

@@ -1,38 +1 @@
-import type { ScaffoldTemplateVariables } from "./scaffold.js";
-import type { EmittedAttributeDefinition } from "./built-in-block-attribute-emitters.js";
-/**
- * Builds the emitted attribute set for the basic built-in block family.
- *
- * @returns Emitted attribute definitions for the basic template family.
- */
-export declare function buildBasicAttributes(): EmittedAttributeDefinition[];
-/**
- * Builds the emitted attribute set for the interactivity built-in block family.
- *
- * @param variables Resolved scaffold template variables for the generated block.
- * @returns Emitted attribute definitions for the interactivity template family.
- */
-export declare function buildInteractivityAttributes(variables: ScaffoldTemplateVariables): EmittedAttributeDefinition[];
-/**
- * Builds the emitted attribute set for the persistence built-in block family.
- *
- * @param variables Resolved scaffold template variables for the generated block.
- * @returns Emitted attribute definitions for the persistence template family.
- */
-export declare function buildPersistenceAttributes(variables: ScaffoldTemplateVariables): EmittedAttributeDefinition[];
-/**
- * Builds the emitted attribute set for the compound parent built-in block family.
- *
- * @param variables Resolved scaffold template variables for the generated block.
- * @returns Emitted attribute definitions for the compound parent artifact.
- */
-export declare function buildCompoundParentAttributes(variables: ScaffoldTemplateVariables): EmittedAttributeDefinition[];
-/**
- * Builds the emitted attribute set for the compound child built-in block family.
- *
- * @param bodyPlaceholder Placeholder text for the child body field.
- * @param childTitle Default title used by the child block.
- * @param childCssClassName Optional CSS class used for HTML-backed selectors.
- * @returns Emitted attribute definitions for the compound child artifact.
- */
-export declare function buildCompoundChildAttributes(childTitle: string, childCssClassName?: string | null, bodyPlaceholder?: string): EmittedAttributeDefinition[];
+export * from "./templates/built-in-block-attribute-specs.js";