@wp-typia/project-tools 0.24.3 → 0.24.5

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

@@ -0,0 +1,71 @@
+import type { JsonValue, ManifestAttribute, ManifestConstraints, ManifestDocument } from "../migration/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/templates/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/templates/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/templates/built-in-block-attribute-specs.js

@@ -0,0 +1,359 @@
+import { isCompoundPersistenceEnabled } from "./scaffold-template-variable-groups.js";
+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(isCompoundPersistenceEnabled(variables)
+        ? [
+            ...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/templates/built-in-block-code-artifacts.d.ts

@@ -0,0 +1,31 @@
+import type { ScaffoldTemplateVariables } from "./scaffold.js";
+import type { BuiltInTemplateId } from "./template-registry.js";
+/**
+ * Emits built-in scaffold source files from typed block generation inputs.
+ *
+ * This module is intentionally internal to the runtime boundary: built-in
+ * scaffold bodies and adjacent emitted source files are now derived from
+ * `ScaffoldTemplateVariables`, but the emitter helpers themselves are not part
+ * of the public root export surface.
+ */
+export interface BuiltInCodeArtifact {
+    /**
+     * File path relative to the generated project root.
+     */
+    relativePath: string;
+    /**
+     * Fully rendered file contents with a trailing newline.
+     */
+    source: string;
+}
+/**
+ * Build the emitter-owned scaffold files for a built-in template family.
+ *
+ * These artifacts are written after template copy so built-in structural,
+ * source, and adjacent generated files always come from the typed generator
+ * boundary rather than stale Mustache sources.
+ */
+export declare function buildBuiltInCodeArtifacts({ templateId, variables, }: {
+    templateId: BuiltInTemplateId;
+    variables: ScaffoldTemplateVariables;
+}): BuiltInCodeArtifact[];