@wp-typia/project-tools 0.16.11 → 0.16.12

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

@@ -0,0 +1,71 @@
+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 {};

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

@@ -0,0 +1,176 @@
+/**
+ * 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),
+    ]));
+}

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

@@ -0,0 +1,38 @@
+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[];

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

@@ -0,0 +1,358 @@
+import { DEFAULT_COMPOUND_CHILD_BODY_PLACEHOLDER, buildAttributesFromSpecs, describe, } from "./built-in-block-attribute-emitters.js";
+const ALIGNMENT_VALUES = ["left", "center", "right"];
+const BASIC_ALIGNMENT_VALUES = ["left", "center", "right", "justify"];
+const INTERACTIVE_MODE_VALUES = ["click", "hover"];
+const ANIMATION_VALUES = ["none", "bounce", "pulse", "shake", "flip"];
+const BASIC_ATTRIBUTE_SPECS = [
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 1000,
+        },
+        defaultValue: "",
+        description: describe("Main block content"),
+        name: "content",
+        optional: false,
+        typeExpression: 'string & tags.MaxLength<1000> & tags.Default<"">',
+    },
+    {
+        attributeType: "string",
+        defaultValue: "left",
+        description: describe("Alignment"),
+        enumValues: [...BASIC_ALIGNMENT_VALUES],
+        name: "alignment",
+        optional: true,
+        typeExpression: 'TextAlignment & tags.Default<"left">',
+    },
+    {
+        attributeType: "boolean",
+        defaultValue: true,
+        description: describe("Visibility toggle"),
+        name: "isVisible",
+        optional: true,
+        typeExpression: "boolean & tags.Default<true>",
+    },
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 100,
+        },
+        defaultValue: "",
+        description: describe("Custom CSS class"),
+        name: "className",
+        optional: true,
+        typeExpression: 'string & tags.MaxLength<100> & tags.Default<"">',
+    },
+    {
+        attributeType: "string",
+        constraints: {
+            format: "uuid",
+        },
+        description: describe("Generated runtime ID"),
+        name: "id",
+        optional: true,
+        typeExpression: 'string & tags.Format<"uuid">',
+    },
+    {
+        attributeType: "number",
+        constraints: {
+            typeTag: "uint32",
+        },
+        defaultValue: 1,
+        description: describe("Block version for migrations"),
+        name: "schemaVersion",
+        optional: true,
+        typeExpression: 'number & tags.Type<"uint32"> & tags.Default<1>',
+    },
+];
+const INTERACTIVITY_ATTRIBUTE_SPECS = [
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 1000,
+        },
+        defaultValue: "",
+        name: "content",
+        optional: false,
+        selector: (variables) => `.${variables.cssClassName}__content`,
+        source: "html",
+        typeExpression: 'string & tags.MaxLength<1000> & tags.Default<"">',
+    },
+    {
+        attributeType: "string",
+        defaultValue: "left",
+        enumValues: [...ALIGNMENT_VALUES],
+        name: "alignment",
+        optional: true,
+        typeExpression: 'TextAlignment & tags.Default<"left">',
+    },
+    {
+        attributeType: "boolean",
+        defaultValue: true,
+        name: "isVisible",
+        optional: true,
+        typeExpression: "boolean & tags.Default<true>",
+    },
+    {
+        attributeType: "string",
+        defaultValue: "click",
+        enumValues: [...INTERACTIVE_MODE_VALUES],
+        name: "interactiveMode",
+        optional: true,
+        typeExpression: '("click" | "hover") & tags.Default<"click">',
+    },
+    {
+        attributeType: "string",
+        defaultValue: "none",
+        enumValues: [...ANIMATION_VALUES],
+        name: "animation",
+        optional: true,
+        typeExpression: '("none" | "bounce" | "pulse" | "shake" | "flip") & tags.Default<"none">',
+    },
+    {
+        attributeType: "number",
+        constraints: {
+            minimum: 0,
+            typeTag: "uint32",
+        },
+        defaultValue: 0,
+        name: "clickCount",
+        optional: true,
+        typeExpression: 'number & tags.Minimum<0> & tags.Type<"uint32"> & tags.Default<0>',
+    },
+    {
+        attributeType: "boolean",
+        defaultValue: false,
+        name: "isAnimating",
+        optional: true,
+        typeExpression: "boolean & tags.Default<false>",
+    },
+    {
+        attributeType: "boolean",
+        defaultValue: true,
+        name: "showCounter",
+        optional: true,
+        typeExpression: "boolean & tags.Default<true>",
+    },
+    {
+        attributeType: "number",
+        constraints: {
+            minimum: 0,
+            typeTag: "uint32",
+        },
+        defaultValue: 10,
+        name: "maxClicks",
+        optional: true,
+        typeExpression: 'number & tags.Minimum<0> & tags.Type<"uint32"> & tags.Default<10>',
+    },
+];
+const PERSISTENCE_ATTRIBUTE_SPECS = [
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 250,
+            minLength: 1,
+        },
+        defaultValue: (variables) => `${variables.title} persistence block`,
+        name: "content",
+        optional: false,
+        selector: (variables) => `.${variables.cssClassName}__content`,
+        source: "html",
+        typeExpression: (variables) => `string & tags.MinLength<1> & tags.MaxLength<250> & tags.Default<${JSON.stringify(`${variables.title} persistence block`)}>`,
+    },
+    {
+        attributeType: "string",
+        defaultValue: "left",
+        enumValues: [...ALIGNMENT_VALUES],
+        name: "alignment",
+        optional: true,
+        typeExpression: 'TextAlignment & tags.Default<"left">',
+    },
+    {
+        attributeType: "boolean",
+        defaultValue: true,
+        name: "isVisible",
+        optional: true,
+        typeExpression: "boolean & tags.Default<true>",
+    },
+    {
+        attributeType: "boolean",
+        defaultValue: true,
+        name: "showCount",
+        optional: true,
+        typeExpression: "boolean & tags.Default<true>",
+    },
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 40,
+            minLength: 1,
+        },
+        defaultValue: "Persist Count",
+        name: "buttonLabel",
+        optional: true,
+        typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<40> & tags.Default<"Persist Count">',
+    },
+    {
+        attributeType: "string",
+        blockJsonDefaultValue: "",
+        constraints: {
+            maxLength: 100,
+            minLength: 1,
+        },
+        manifestDefaultValue: "primary",
+        name: "resourceKey",
+        optional: true,
+        typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<100> & tags.Default<"primary">',
+    },
+];
+const COMPOUND_PARENT_BASE_ATTRIBUTE_SPECS = [
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 80,
+            minLength: 1,
+        },
+        defaultValue: (variables) => variables.title,
+        name: "heading",
+        optional: false,
+        selector: (variables) => `.${variables.cssClassName}__heading`,
+        source: "html",
+        typeExpression: (variables) => `string & tags.MinLength<1> & tags.MaxLength<80> & tags.Default<${JSON.stringify(variables.title)}>`,
+    },
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 180,
+            minLength: 1,
+        },
+        defaultValue: "Add and reorder internal items inside this compound block.",
+        name: "intro",
+        optional: true,
+        selector: (variables) => `.${variables.cssClassName}__intro`,
+        source: "html",
+        typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<180> & tags.Default<"Add and reorder internal items inside this compound block.">',
+    },
+    {
+        attributeType: "boolean",
+        defaultValue: true,
+        name: "showDividers",
+        optional: true,
+        typeExpression: "boolean & tags.Default<true>",
+    },
+];
+const COMPOUND_PARENT_PERSISTENCE_ATTRIBUTE_SPECS = [
+    {
+        attributeType: "boolean",
+        defaultValue: true,
+        name: "showCount",
+        optional: true,
+        typeExpression: "boolean & tags.Default<true>",
+    },
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 40,
+            minLength: 1,
+        },
+        defaultValue: "Persist Count",
+        name: "buttonLabel",
+        optional: true,
+        typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<40> & tags.Default<"Persist Count">',
+    },
+    {
+        attributeType: "string",
+        blockJsonDefaultValue: "",
+        constraints: {
+            maxLength: 100,
+            minLength: 1,
+        },
+        manifestDefaultValue: "primary",
+        name: "resourceKey",
+        optional: true,
+        typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<100> & tags.Default<"primary">',
+    },
+];
+const COMPOUND_CHILD_ATTRIBUTE_SPECS = [
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 80,
+            minLength: 1,
+        },
+        defaultValue: ({ childTitle }) => childTitle,
+        name: "title",
+        optional: false,
+        selector: ({ childCssClassName }) => childCssClassName ? `.${childCssClassName}__title` : null,
+        source: ({ childCssClassName }) => childCssClassName ? "html" : null,
+        typeExpression: ({ childTitle }) => `string & tags.MinLength<1> & tags.MaxLength<80> & tags.Default<${JSON.stringify(childTitle)}>`,
+    },
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 280,
+            minLength: 1,
+        },
+        defaultValue: ({ bodyPlaceholder }) => bodyPlaceholder,
+        name: "body",
+        optional: false,
+        selector: ({ childCssClassName }) => childCssClassName ? `.${childCssClassName}__body` : null,
+        source: ({ childCssClassName }) => childCssClassName ? "html" : null,
+        typeExpression: ({ bodyPlaceholder }) => `string & tags.MinLength<1> & tags.MaxLength<280> & tags.Default<${JSON.stringify(bodyPlaceholder)}>`,
+    },
+];
+/**
+ * Builds the emitted attribute set for the basic built-in block family.
+ *
+ * @returns Emitted attribute definitions for the basic template family.
+ */
+export function buildBasicAttributes() {
+    return buildAttributesFromSpecs(BASIC_ATTRIBUTE_SPECS, undefined);
+}
+/**
+ * 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 function buildInteractivityAttributes(variables) {
+    return buildAttributesFromSpecs(INTERACTIVITY_ATTRIBUTE_SPECS, variables);
+}
+/**
+ * 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 function buildPersistenceAttributes(variables) {
+    return buildAttributesFromSpecs(PERSISTENCE_ATTRIBUTE_SPECS, variables);
+}
+/**
+ * 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 function buildCompoundParentAttributes(variables) {
+    return buildAttributesFromSpecs(variables.compoundPersistenceEnabled === "true"
+        ? [
+            ...COMPOUND_PARENT_BASE_ATTRIBUTE_SPECS,
+            ...COMPOUND_PARENT_PERSISTENCE_ATTRIBUTE_SPECS,
+        ]
+        : COMPOUND_PARENT_BASE_ATTRIBUTE_SPECS, variables);
+}
+/**
+ * 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 function buildCompoundChildAttributes(childTitle, childCssClassName, bodyPlaceholder = DEFAULT_COMPOUND_CHILD_BODY_PLACEHOLDER) {
+    return buildAttributesFromSpecs(COMPOUND_CHILD_ATTRIBUTE_SPECS, {
+        bodyPlaceholder,
+        childCssClassName,
+        childTitle,
+    });
+}

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

@@ -0,0 +1,4 @@
+export declare const BASIC_EDIT_TEMPLATE = "/**\n * Editor component for {{title}} Block\n */\n\nimport type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';\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 './manifest-document';\nimport {\n  InspectorFromManifest,\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, {\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                \u2022 {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";
+export declare const BASIC_SAVE_TEMPLATE = "/**\n * Save/Frontend component for {{title}} Block\n */\n\nimport { RichText, useBlockProps } from '@wordpress/block-editor';\nimport { {{pascalCase}}Attributes } from './types';\n\ninterface SaveProps {\n  attributes: {{pascalCase}}Attributes;\n}\n\nexport default function Save({ attributes }: SaveProps) {\n  const isVisible = attributes.isVisible !== false;\n  const blockProps = useBlockProps.save({\n    className: `{{cssClassName}}${isVisible ? '' : ' is-hidden'}`,\n    hidden: isVisible ? undefined : true,\n    'aria-hidden': isVisible ? undefined : 'true',\n  });\n\n  return (\n    <div {...blockProps}>\n      <div\n        className=\"{{cssClassName}}__content\"\n        data-align={attributes.alignment || 'left'}\n      >\n        <RichText.Content tagName=\"p\" value={attributes.content} />\n      </div>\n    </div>\n  );\n}\n";
+export declare const BASIC_INDEX_TEMPLATE = "/**\n * WordPress {{title}} Block\n *\n * Typia-powered type-safe block\n */\n\nimport {\n  registerScaffoldBlockType,\n  type BlockConfiguration,\n} from '@wp-typia/block-types/blocks/registration';\nimport type { BlockSupports } from '@wp-typia/block-types/blocks/supports';\nimport { __ } from '@wordpress/i18n';\nimport {\n  buildScaffoldBlockRegistration,\n  parseScaffoldBlockMetadata,\n} from '@wp-typia/block-runtime/blocks';\n\n// Import components\nimport Edit from './edit';\nimport Save from './save';\nimport metadata from './block-metadata';\nimport './editor.scss';\nimport './style.scss';\n\n// Import types\nimport { {{pascalCase}}Attributes } from './types';\nimport { validators } from './validators';\n\nconst scaffoldSupports = {\n  html: false,\n  multiple: true,\n  align: ['wide', 'full'],\n} satisfies BlockSupports;\n\n// Register the block\nconst registration = buildScaffoldBlockRegistration(\n  parseScaffoldBlockMetadata<BlockConfiguration<{{pascalCase}}Attributes>>(metadata),\n  {\n    supports: scaffoldSupports,\n    example: {\n      attributes: validators.random(),\n    },\n    edit: Edit,\n    save: Save,\n  }\n);\n\nregisterScaffoldBlockType(registration.name, registration.settings);\n";
+export declare const BASIC_VALIDATORS_TEMPLATE = "import typia from 'typia';\nimport currentManifest from \"./manifest-defaults-document\";\nimport { {{pascalCase}}Attributes, {{pascalCase}}ValidationResult } from \"./types\";\nimport { generateBlockId } from \"@wp-typia/block-runtime/identifiers\";\nimport { createTemplateValidatorToolkit } from \"./validator-toolkit\";\n\nconst scaffoldValidators = createTemplateValidatorToolkit<{{pascalCase}}Attributes>({\n  assert: typia.createAssert<{{pascalCase}}Attributes>(),\n  clone: typia.misc.createClone<{{pascalCase}}Attributes>() as (\n    value: {{pascalCase}}Attributes,\n  ) => {{pascalCase}}Attributes,\n  is: typia.createIs<{{pascalCase}}Attributes>(),\n  manifest: currentManifest,\n  prune: typia.misc.createPrune<{{pascalCase}}Attributes>(),\n  random: typia.createRandom<{{pascalCase}}Attributes>() as (\n    ...args: unknown[]\n  ) => {{pascalCase}}Attributes,\n  finalize: (normalized) => ({\n    ...normalized,\n    id: normalized.id && normalized.id.length > 0 ? normalized.id : generateBlockId(),\n  }),\n  validate: typia.createValidate<{{pascalCase}}Attributes>(),\n});\n\nexport const validate{{pascalCase}}Attributes =\n  scaffoldValidators.validateAttributes as (\n    attributes: unknown,\n  ) => {{pascalCase}}ValidationResult;\n\nexport const validators = scaffoldValidators.validators;\n\nexport const sanitize{{pascalCase}}Attributes =\n  scaffoldValidators.sanitizeAttributes as (\n    attributes: Partial<{{pascalCase}}Attributes>,\n  ) => {{pascalCase}}Attributes;\n\nexport const createAttributeUpdater = scaffoldValidators.createAttributeUpdater;\n";