@wp-typia/project-tools 0.24.4 → 0.24.6

package/dist/runtime/templates/scaffold-template-variable-groups.d.ts

@@ -0,0 +1,158 @@
+import type { ScaffoldPluginHeaderCompatibility } from "./scaffold-compatibility.js";
+export declare const SCAFFOLD_TEMPLATE_VARIABLE_GROUPS: unique symbol;
+export type ScaffoldTemplateFamily = "basic" | "interactivity" | "persistence" | "compound" | "query-loop" | "external";
+export interface ScaffoldSharedTemplateVariableGroup {
+    author: string;
+    blockMetadataVersion: string;
+    category: string;
+    compatibility: ScaffoldPluginHeaderCompatibility;
+    cssClassName: string;
+    description: string;
+    descriptionJson: string;
+    frontendCssClassName: string;
+    icon: string;
+    keyword: string;
+    namespace: string;
+    pascalCase: string;
+    phpPrefix: string;
+    phpPrefixUpper: string;
+    slug: string;
+    slugCamelCase: string;
+    slugKebabCase: string;
+    slugSnakeCase: string;
+    textDomain: string;
+    title: string;
+    titleCase: string;
+    titleJson: string;
+    versions: {
+        apiClient: string;
+        blockRuntime: string;
+        blockTypes: string;
+        projectTools: string;
+        rest: string;
+    };
+}
+export interface ScaffoldAlternateRenderTargetVariableGroup {
+    csv: string;
+    enabled: boolean;
+    hasEmail: boolean;
+    hasMjml: boolean;
+    hasPlainText: boolean;
+    json: string;
+    targets: readonly string[];
+}
+export interface DisabledScaffoldCompoundVariableGroup {
+    enabled: false;
+    persistenceEnabled: false;
+}
+export interface EnabledScaffoldCompoundVariableGroup {
+    child: {
+        category: string;
+        cssClassName: string;
+        icon: string;
+        title: string;
+        titleJson: string;
+    };
+    enabled: true;
+    innerBlocks: {
+        description: string;
+        directInsert: boolean;
+        label: string;
+        orientation: "" | "horizontal" | "vertical";
+        orientationExpression: string;
+        preset: string;
+        templateLockExpression: string;
+    };
+    persistenceEnabled: boolean;
+}
+export type ScaffoldCompoundVariableGroup = DisabledScaffoldCompoundVariableGroup | EnabledScaffoldCompoundVariableGroup;
+export interface DisabledScaffoldPersistenceVariableGroup {
+    enabled: false;
+    scope: "none";
+}
+export interface EnabledScaffoldPersistenceVariableGroup {
+    auth: {
+        bootstrapCredentialDeclarations: string;
+        descriptionJson: string;
+        intent: "authenticated" | "public-write-protected";
+        isAuthenticated: boolean;
+        isPublic: boolean;
+        mechanism: "public-signed-token" | "rest-nonce";
+        mode: "authenticated-rest-nonce" | "public-signed-token";
+        publicWriteRequestIdDeclaration: string;
+    };
+    dataStorageMode: "custom-table" | "post-meta";
+    enabled: true;
+    policy: "authenticated" | "public";
+    scope: "compound-parent" | "single";
+}
+export type ScaffoldPersistenceVariableGroup = DisabledScaffoldPersistenceVariableGroup | EnabledScaffoldPersistenceVariableGroup;
+export interface DisabledScaffoldQueryLoopVariableGroup {
+    enabled: false;
+}
+export interface EnabledScaffoldQueryLoopVariableGroup {
+    allowedControls: readonly string[];
+    allowedControlsJson: string;
+    enabled: true;
+    postType: string;
+    postTypeJson: string;
+    variationNamespace: string;
+    variationNamespaceJson: string;
+}
+export type ScaffoldQueryLoopVariableGroup = DisabledScaffoldQueryLoopVariableGroup | EnabledScaffoldQueryLoopVariableGroup;
+interface ScaffoldTemplateVariableGroupsBase {
+    alternateRenderTargets: ScaffoldAlternateRenderTargetVariableGroup;
+    shared: ScaffoldSharedTemplateVariableGroup;
+    template: {
+        description: string;
+    };
+}
+type DisabledTemplateFamilyGroups<TFamily extends "basic" | "interactivity" | "external"> = ScaffoldTemplateVariableGroupsBase & {
+    compound: DisabledScaffoldCompoundVariableGroup;
+    persistence: DisabledScaffoldPersistenceVariableGroup;
+    queryLoop: DisabledScaffoldQueryLoopVariableGroup;
+    templateFamily: TFamily;
+};
+export type BasicScaffoldTemplateVariableGroups = DisabledTemplateFamilyGroups<"basic">;
+export type InteractivityScaffoldTemplateVariableGroups = DisabledTemplateFamilyGroups<"interactivity">;
+export interface PersistenceScaffoldTemplateVariableGroups extends ScaffoldTemplateVariableGroupsBase {
+    compound: DisabledScaffoldCompoundVariableGroup;
+    persistence: EnabledScaffoldPersistenceVariableGroup & {
+        scope: "single";
+    };
+    queryLoop: DisabledScaffoldQueryLoopVariableGroup;
+    templateFamily: "persistence";
+}
+export interface CompoundScaffoldTemplateVariableGroups extends ScaffoldTemplateVariableGroupsBase {
+    compound: EnabledScaffoldCompoundVariableGroup;
+    persistence: DisabledScaffoldPersistenceVariableGroup | (EnabledScaffoldPersistenceVariableGroup & {
+        scope: "compound-parent";
+    });
+    queryLoop: DisabledScaffoldQueryLoopVariableGroup;
+    templateFamily: "compound";
+}
+export interface QueryLoopScaffoldTemplateVariableGroups extends ScaffoldTemplateVariableGroupsBase {
+    compound: DisabledScaffoldCompoundVariableGroup;
+    persistence: DisabledScaffoldPersistenceVariableGroup;
+    queryLoop: EnabledScaffoldQueryLoopVariableGroup;
+    templateFamily: "query-loop";
+}
+export type ExternalScaffoldTemplateVariableGroups = DisabledTemplateFamilyGroups<"external">;
+export type ScaffoldTemplateVariableGroups = BasicScaffoldTemplateVariableGroups | InteractivityScaffoldTemplateVariableGroups | PersistenceScaffoldTemplateVariableGroups | CompoundScaffoldTemplateVariableGroups | QueryLoopScaffoldTemplateVariableGroups | ExternalScaffoldTemplateVariableGroups;
+export interface ScaffoldTemplateVariableGroupsCarrier {
+    readonly [SCAFFOLD_TEMPLATE_VARIABLE_GROUPS]: ScaffoldTemplateVariableGroups;
+}
+export type CompoundScaffoldTemplateVariablesLike = ScaffoldTemplateVariableGroupsCarrier & {
+    slugKebabCase: string;
+};
+export type PersistenceScaffoldTemplateVariablesLike = ScaffoldTemplateVariableGroupsCarrier & {
+    namespace: string;
+    pascalCase: string;
+    slugKebabCase: string;
+    title: string;
+};
+export declare function attachScaffoldTemplateVariableGroups<TVariables extends Record<string, string>>(variables: TVariables, groups: ScaffoldTemplateVariableGroups): TVariables & ScaffoldTemplateVariableGroupsCarrier;
+export declare function getScaffoldTemplateVariableGroups(variables: ScaffoldTemplateVariableGroupsCarrier): ScaffoldTemplateVariableGroups;
+export declare function isCompoundPersistenceEnabled(variables: ScaffoldTemplateVariableGroupsCarrier): boolean;
+export declare function getScaffoldAlternateRenderTargets(variables: ScaffoldTemplateVariableGroupsCarrier): ScaffoldAlternateRenderTargetVariableGroup;
+export {};

package/dist/runtime/templates/scaffold-template-variable-groups.js

@@ -0,0 +1,20 @@
+export const SCAFFOLD_TEMPLATE_VARIABLE_GROUPS = Symbol("wp-typia.scaffold-template-variable-groups");
+export function attachScaffoldTemplateVariableGroups(variables, groups) {
+    Object.defineProperty(variables, SCAFFOLD_TEMPLATE_VARIABLE_GROUPS, {
+        configurable: false,
+        enumerable: false,
+        value: groups,
+        writable: false,
+    });
+    return variables;
+}
+export function getScaffoldTemplateVariableGroups(variables) {
+    return variables[SCAFFOLD_TEMPLATE_VARIABLE_GROUPS];
+}
+export function isCompoundPersistenceEnabled(variables) {
+    const compound = getScaffoldTemplateVariableGroups(variables).compound;
+    return compound.enabled && compound.persistenceEnabled;
+}
+export function getScaffoldAlternateRenderTargets(variables) {
+    return getScaffoldTemplateVariableGroups(variables).alternateRenderTargets;
+}

package/dist/runtime/templates/scaffold-template-variables.d.ts

@@ -0,0 +1,9 @@
+import type { ScaffoldAnswers, ScaffoldTemplateVariables } from './scaffold.js';
+/**
+ * Build the normalized template variables used by scaffold rendering.
+ *
+ * @param templateId Selected scaffold template identifier.
+ * @param answers Normalized scaffold answers collected from defaults, flags, and prompts.
+ * @returns Template variables ready for file interpolation and generated artifacts.
+ */
+export declare function getTemplateVariables(templateId: string, answers: ScaffoldAnswers): ScaffoldTemplateVariables;

package/dist/runtime/templates/scaffold-template-variables.js

@@ -0,0 +1,203 @@
+import { buildTemplateVariablesFromBlockSpec, createBuiltInBlockSpec, } from './block-generator-service.js';
+import { getPackageVersions } from '../shared/package-versions.js';
+import { buildBlockCssClassName, buildFrontendCssClassName, resolveScaffoldIdentifiers, } from './scaffold-identifiers.js';
+import { BUILTIN_BLOCK_METADATA_VERSION, COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS, getBuiltInTemplateMetadataDefaults, } from './template-defaults.js';
+import { DEFAULT_COMPOUND_INNER_BLOCKS_PRESET_ID, getCompoundInnerBlocksPresetDefinition, } from '../add/compound-inner-blocks.js';
+import { getTemplateById, isBuiltInTemplateId, } from './template-registry.js';
+import { toPascalCase, toSnakeCase, } from '../shared/string-case.js';
+import { attachScaffoldTemplateVariableGroups } from "./scaffold-template-variable-groups.js";
+import { resolveScaffoldCompatibilityPolicy } from "./scaffold-compatibility.js";
+/**
+ * Build the normalized template variables used by scaffold rendering.
+ *
+ * @param templateId Selected scaffold template identifier.
+ * @param answers Normalized scaffold answers collected from defaults, flags, and prompts.
+ * @returns Template variables ready for file interpolation and generated artifacts.
+ */
+export function getTemplateVariables(templateId, answers) {
+    if (isBuiltInTemplateId(templateId)) {
+        return buildTemplateVariablesFromBlockSpec(createBuiltInBlockSpec({
+            answers,
+            dataStorageMode: answers.dataStorageMode,
+            persistencePolicy: answers.persistencePolicy,
+            templateId,
+        }));
+    }
+    const { apiClientPackageVersion, blockRuntimePackageVersion, blockTypesPackageVersion, projectToolsPackageVersion, restPackageVersion, wpTypiaPackageVersion, } = getPackageVersions();
+    const template = isBuiltInTemplateId(templateId) ? getTemplateById(templateId) : null;
+    const metadataDefaults = isBuiltInTemplateId(templateId)
+        ? getBuiltInTemplateMetadataDefaults(templateId)
+        : null;
+    const identifiers = resolveScaffoldIdentifiers({
+        namespace: answers.namespace,
+        phpPrefix: answers.phpPrefix,
+        slug: answers.slug,
+        textDomain: answers.textDomain,
+    });
+    const slug = identifiers.slug;
+    const slugSnakeCase = toSnakeCase(slug);
+    const pascalCase = toPascalCase(slug);
+    const title = answers.title.trim();
+    const namespace = identifiers.namespace;
+    const description = answers.description.trim();
+    const textDomain = identifiers.textDomain;
+    const phpPrefix = identifiers.phpPrefix;
+    const phpPrefixUpper = phpPrefix.toUpperCase();
+    const compoundChildTitle = `${title} Item`;
+    const cssClassName = buildBlockCssClassName(namespace, slug);
+    const compoundChildCssClassName = buildBlockCssClassName(namespace, `${slug}-item`);
+    const compoundInnerBlocksPreset = answers.compoundInnerBlocksPreset ?? DEFAULT_COMPOUND_INNER_BLOCKS_PRESET_ID;
+    const compoundInnerBlocksPresetDefinition = getCompoundInnerBlocksPresetDefinition(compoundInnerBlocksPreset);
+    const compoundPersistenceEnabled = templateId === 'persistence'
+        ? true
+        : templateId === 'compound'
+            ? Boolean(answers.dataStorageMode || answers.persistencePolicy)
+            : false;
+    const dataStorageMode = templateId === 'persistence' || compoundPersistenceEnabled
+        ? answers.dataStorageMode ?? 'custom-table'
+        : 'custom-table';
+    const persistencePolicy = templateId === 'persistence' || compoundPersistenceEnabled
+        ? answers.persistencePolicy ?? 'authenticated'
+        : 'authenticated';
+    const compatibility = resolveScaffoldCompatibilityPolicy([]);
+    const flatVariables = {
+        alternateRenderTargetsCsv: '',
+        alternateRenderTargetsJson: '[]',
+        apiClientPackageVersion,
+        author: answers.author.trim(),
+        blockRuntimePackageVersion,
+        blockMetadataVersion: BUILTIN_BLOCK_METADATA_VERSION,
+        blockTypesPackageVersion,
+        category: metadataDefaults?.category ?? template?.defaultCategory ?? 'widgets',
+        icon: metadataDefaults?.icon ?? 'smiley',
+        compoundChildTitle,
+        compoundChildCategory: COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS.category,
+        compoundChildCssClassName,
+        compoundChildIcon: COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS.icon,
+        compoundChildTitleJson: JSON.stringify(compoundChildTitle),
+        compoundPersistenceEnabled: compoundPersistenceEnabled ? 'true' : 'false',
+        compoundInnerBlocksDirectInsert: compoundInnerBlocksPresetDefinition.directInsert
+            ? 'true'
+            : 'false',
+        compoundInnerBlocksOrientation: compoundInnerBlocksPresetDefinition.orientation ?? '',
+        compoundInnerBlocksOrientationExpression: compoundInnerBlocksPresetDefinition.orientation
+            ? `'${compoundInnerBlocksPresetDefinition.orientation}'`
+            : 'undefined',
+        compoundInnerBlocksPreset,
+        compoundInnerBlocksPresetDescription: compoundInnerBlocksPresetDefinition.description,
+        compoundInnerBlocksPresetLabel: compoundInnerBlocksPresetDefinition.label,
+        compoundInnerBlocksTemplateLockExpression: compoundInnerBlocksPresetDefinition.templateLock === false
+            ? 'false'
+            : `'${compoundInnerBlocksPresetDefinition.templateLock}'`,
+        hasAlternateEmailRenderTarget: 'false',
+        hasAlternateMjmlRenderTarget: 'false',
+        hasAlternatePlainTextRenderTarget: 'false',
+        hasAlternateRenderTargets: 'false',
+        projectToolsPackageVersion,
+        wpTypiaPackageVersion,
+        requiresAtLeast: compatibility.pluginHeader.requiresAtLeast,
+        requiresPhp: compatibility.pluginHeader.requiresPhp,
+        cssClassName,
+        dataStorageMode,
+        dashCase: slug,
+        description,
+        descriptionJson: JSON.stringify(description),
+        frontendCssClassName: buildFrontendCssClassName(cssClassName),
+        queryAllowedControlsJson: JSON.stringify([], null, 2),
+        queryPostType: answers.queryPostType?.trim() || 'post',
+        queryPostTypeJson: JSON.stringify(answers.queryPostType?.trim() || 'post'),
+        queryVariationNamespace: `${namespace}/${slug}`,
+        queryVariationNamespaceJson: JSON.stringify(`${namespace}/${slug}`),
+        isAuthenticatedPersistencePolicy: persistencePolicy === 'authenticated' ? 'true' : 'false',
+        isPublicPersistencePolicy: persistencePolicy === 'public' ? 'true' : 'false',
+        bootstrapCredentialDeclarations: persistencePolicy === 'public'
+            ? "publicWriteExpiresAt?: number & tags.Type< 'uint32' >;\n\tpublicWriteToken?: string & tags.MinLength< 1 > & tags.MaxLength< 512 >;"
+            : "restNonce?: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;",
+        persistencePolicyDescriptionJson: JSON.stringify(persistencePolicy === 'authenticated'
+            ? 'Writes require a logged-in user and a valid REST nonce.'
+            : 'Anonymous writes use signed short-lived public tokens, per-request ids, and coarse rate limiting.'),
+        keyword: slug.replace(/-/g, ' '),
+        namespace,
+        needsMigration: '{{needsMigration}}',
+        pascalCase,
+        phpPrefix,
+        phpPrefixUpper,
+        restPackageVersion,
+        testedUpTo: compatibility.pluginHeader.testedUpTo,
+        publicWriteRequestIdDeclaration: persistencePolicy === 'public'
+            ? "publicWriteRequestId: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;"
+            : "publicWriteRequestId?: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;",
+        restWriteAuthIntent: persistencePolicy === 'public'
+            ? 'public-write-protected'
+            : 'authenticated',
+        restWriteAuthMechanism: persistencePolicy === 'public' ? 'public-signed-token' : 'rest-nonce',
+        restWriteAuthMode: persistencePolicy === 'public' ? 'public-signed-token' : 'authenticated-rest-nonce',
+        slug,
+        slugCamelCase: pascalCase.charAt(0).toLowerCase() + pascalCase.slice(1),
+        slugKebabCase: slug,
+        slugSnakeCase,
+        textDomain,
+        textdomain: textDomain,
+        title,
+        titleJson: JSON.stringify(title),
+        titleCase: pascalCase,
+        persistencePolicy,
+    };
+    return attachScaffoldTemplateVariableGroups(flatVariables, {
+        alternateRenderTargets: {
+            csv: '',
+            enabled: false,
+            hasEmail: false,
+            hasMjml: false,
+            hasPlainText: false,
+            json: '[]',
+            targets: [],
+        },
+        compound: {
+            enabled: false,
+            persistenceEnabled: false,
+        },
+        persistence: {
+            enabled: false,
+            scope: 'none',
+        },
+        queryLoop: {
+            enabled: false,
+        },
+        shared: {
+            author: answers.author.trim(),
+            blockMetadataVersion: BUILTIN_BLOCK_METADATA_VERSION,
+            category: metadataDefaults?.category ?? template?.defaultCategory ?? 'widgets',
+            compatibility: compatibility.pluginHeader,
+            cssClassName,
+            description,
+            descriptionJson: JSON.stringify(description),
+            frontendCssClassName: buildFrontendCssClassName(cssClassName),
+            icon: metadataDefaults?.icon ?? 'smiley',
+            keyword: slug.replace(/-/g, ' '),
+            namespace,
+            pascalCase,
+            phpPrefix,
+            phpPrefixUpper,
+            slug,
+            slugCamelCase: pascalCase.charAt(0).toLowerCase() + pascalCase.slice(1),
+            slugKebabCase: slug,
+            slugSnakeCase,
+            textDomain,
+            title,
+            titleCase: pascalCase,
+            titleJson: JSON.stringify(title),
+            versions: {
+                apiClient: apiClientPackageVersion,
+                blockRuntime: blockRuntimePackageVersion,
+                blockTypes: blockTypesPackageVersion,
+                projectTools: projectToolsPackageVersion,
+                rest: restPackageVersion,
+            },
+        },
+        template: {
+            description: template?.description ?? 'External scaffold template variables',
+        },
+        templateFamily: 'external',
+    });
+}

package/dist/runtime/templates/scaffold.d.ts

@@ -0,0 +1,205 @@
+import type { PackageManagerId } from "../shared/package-managers.js";
+import type { ScaffoldTemplateVariableGroupsCarrier } from "./scaffold-template-variable-groups.js";
+/**
+ * User-facing scaffold answers before template rendering.
+ *
+ * `namespace`, `textDomain`, and `phpPrefix` are normalized before use so
+ * callers can pass human-entered values while generated output stays
+ * predictable.
+ */
+export interface ScaffoldAnswers {
+    author: string;
+    compoundInnerBlocksPreset?: import("../add/compound-inner-blocks.js").CompoundInnerBlocksPresetId;
+    dataStorageMode?: DataStorageMode;
+    description: string;
+    /** Block namespace used in generated block names such as `namespace/slug`. */
+    namespace: string;
+    persistencePolicy?: PersistencePolicy;
+    /** Snake_case PHP symbol prefix used for generated functions, constants, and keys. */
+    phpPrefix?: string;
+    queryPostType?: string;
+    slug: string;
+    /** Kebab-case WordPress text domain used in block metadata and i18n strings. */
+    textDomain?: string;
+    title: string;
+}
+export declare const DATA_STORAGE_MODES: readonly ["post-meta", "custom-table"];
+export type DataStorageMode = (typeof DATA_STORAGE_MODES)[number];
+export declare const PERSISTENCE_POLICIES: readonly ["authenticated", "public"];
+export type PersistencePolicy = (typeof PERSISTENCE_POLICIES)[number];
+/** Supported create profile ids for opt-in workspace scaffold presets. */
+export declare const CREATE_PROFILE_IDS: readonly ["plugin-qa"];
+/** Union of supported `wp-typia create --profile` id strings. */
+export type CreateProfileId = (typeof CREATE_PROFILE_IDS)[number];
+/**
+ * Normalized template variables shared by built-in and remote scaffold flows.
+ */
+export interface FlatScaffoldTemplateVariables extends Record<string, string> {
+    alternateRenderTargetsCsv: string;
+    alternateRenderTargetsJson: string;
+    apiClientPackageVersion: string;
+    author: string;
+    blockRuntimePackageVersion: string;
+    blockMetadataVersion: string;
+    blockTypesPackageVersion: string;
+    category: string;
+    icon: string;
+    compoundChildTitle: string;
+    compoundChildCategory: string;
+    compoundChildCssClassName: string;
+    compoundChildIcon: string;
+    compoundChildTitleJson: string;
+    compoundPersistenceEnabled: "false" | "true";
+    compoundInnerBlocksDirectInsert: "false" | "true";
+    compoundInnerBlocksOrientation: "" | "horizontal" | "vertical";
+    compoundInnerBlocksOrientationExpression: string;
+    compoundInnerBlocksPreset: string;
+    compoundInnerBlocksPresetDescription: string;
+    compoundInnerBlocksPresetLabel: string;
+    compoundInnerBlocksTemplateLockExpression: string;
+    hasAlternateEmailRenderTarget: "false" | "true";
+    hasAlternateMjmlRenderTarget: "false" | "true";
+    hasAlternatePlainTextRenderTarget: "false" | "true";
+    hasAlternateRenderTargets: "false" | "true";
+    projectToolsPackageVersion: string;
+    wpTypiaPackageVersion: string;
+    requiresAtLeast: string;
+    requiresPhp: string;
+    cssClassName: string;
+    dashCase: string;
+    dataStorageMode: DataStorageMode;
+    description: string;
+    descriptionJson: string;
+    frontendCssClassName: string;
+    keyword: string;
+    namespace: string;
+    needsMigration: string;
+    pascalCase: string;
+    phpPrefix: string;
+    phpPrefixUpper: string;
+    queryAllowedControlsJson: string;
+    queryPostTypeJson: string;
+    queryPostType: string;
+    queryVariationNamespace: string;
+    queryVariationNamespaceJson: string;
+    isAuthenticatedPersistencePolicy: "false" | "true";
+    isPublicPersistencePolicy: "false" | "true";
+    bootstrapCredentialDeclarations: string;
+    persistencePolicyDescriptionJson: string;
+    publicWriteRequestIdDeclaration: string;
+    restPackageVersion: string;
+    restWriteAuthIntent: "authenticated" | "public-write-protected";
+    restWriteAuthMechanism: "public-signed-token" | "rest-nonce";
+    restWriteAuthMode: "authenticated-rest-nonce" | "public-signed-token";
+    slug: string;
+    slugCamelCase: string;
+    slugKebabCase: string;
+    slugSnakeCase: string;
+    textDomain: string;
+    textdomain: string;
+    testedUpTo: string;
+    title: string;
+    titleJson: string;
+    titleCase: string;
+    persistencePolicy: PersistencePolicy;
+}
+export interface ScaffoldTemplateVariables extends FlatScaffoldTemplateVariables, ScaffoldTemplateVariableGroupsCarrier {
+}
+/**
+ * Resolve scaffold template input from either built-in template ids or custom
+ * template identifiers such as local paths, GitHub refs, and npm packages.
+ *
+ * The callback returns `Promise<string>` on purpose so interactive selection
+ * can surface custom ids. Downstream code uses `isBuiltInTemplateId()` to
+ * distinguish built-in templates from custom sources.
+ */
+export interface ResolveTemplateOptions {
+    isInteractive?: boolean;
+    selectTemplate?: () => Promise<string>;
+    templateId?: string;
+    yes?: boolean;
+}
+/**
+ * Options for resolving the package manager in CLI and interactive scaffold flows.
+ */
+export interface ResolvePackageManagerOptions {
+    isInteractive?: boolean;
+    packageManager?: string;
+    selectPackageManager?: () => Promise<PackageManagerId>;
+    yes?: boolean;
+}
+/**
+ * Options for collecting scaffold answers from defaults, overrides, and prompts.
+ */
+export interface CollectScaffoldAnswersOptions {
+    dataStorageMode?: DataStorageMode;
+    namespace?: string;
+    phpPrefix?: string;
+    projectName: string;
+    promptText?: (message: string, defaultValue: string, validate?: (value: string) => true | string) => Promise<string>;
+    persistencePolicy?: PersistencePolicy;
+    queryPostType?: string;
+    textDomain?: string;
+    templateId: string;
+    withTestPreset?: boolean;
+    withWpEnv?: boolean;
+    yes?: boolean;
+}
+interface InstallDependenciesOptions {
+    packageManager: PackageManagerId;
+    projectDir: string;
+}
+export interface ScaffoldProgressEvent {
+    detail: string;
+    phase: "finalize-project" | "generate-files" | "install-dependencies" | "resolve-template" | "seed-artifacts";
+    title: string;
+}
+interface ScaffoldProjectOptions {
+    allowExistingDir?: boolean;
+    alternateRenderTargets?: string;
+    answers: ScaffoldAnswers;
+    cwd?: string;
+    dataStorageMode?: DataStorageMode;
+    externalLayerId?: string;
+    externalLayerSource?: string;
+    externalLayerSourceLabel?: string;
+    installDependencies?: ((options: InstallDependenciesOptions) => Promise<void>) | undefined;
+    noInstall?: boolean;
+    onProgress?: ((event: ScaffoldProgressEvent) => void | Promise<void>) | undefined;
+    packageManager: PackageManagerId;
+    persistencePolicy?: PersistencePolicy;
+    profile?: CreateProfileId;
+    projectDir: string;
+    repositoryReference?: string;
+    templateId: string;
+    variant?: string;
+    withMigrationUi?: boolean;
+    withTestPreset?: boolean;
+    withWpEnv?: boolean;
+}
+export interface ScaffoldProjectResult {
+    packageManager: PackageManagerId;
+    projectDir: string;
+    selectedVariant: string | null;
+    templateId: string;
+    variables: ScaffoldTemplateVariables;
+    warnings: string[];
+}
+export { buildBlockCssClassName } from "./scaffold-identifiers.js";
+export { collectScaffoldAnswers, detectAuthor, getDefaultAnswers, resolvePackageManagerId, resolveTemplateId, } from "./scaffold-answer-resolution.js";
+export { getTemplateVariables } from "./scaffold-template-variables.js";
+export { getScaffoldTemplateVariableGroups, type BasicScaffoldTemplateVariableGroups, type CompoundScaffoldTemplateVariableGroups, type ExternalScaffoldTemplateVariableGroups, type InteractivityScaffoldTemplateVariableGroups, type PersistenceScaffoldTemplateVariableGroups, type QueryLoopScaffoldTemplateVariableGroups, type ScaffoldTemplateFamily, type ScaffoldTemplateVariableGroups, type ScaffoldTemplateVariableGroupsCarrier, } from "./scaffold-template-variable-groups.js";
+export declare function isDataStorageMode(value: string): value is DataStorageMode;
+export declare function isPersistencePolicy(value: string): value is PersistencePolicy;
+/**
+ * Return whether a raw string is a supported create profile id.
+ */
+export declare function isCreateProfileId(value: string): value is CreateProfileId;
+/**
+ * Resolve an optional create profile flag into a validated profile id.
+ *
+ * Empty input disables profile application; unknown ids throw with the allowed
+ * profile list for CLI diagnostics.
+ */
+export declare function resolveCreateProfileId(profile?: string): CreateProfileId | undefined;
+export declare function scaffoldProject({ projectDir, templateId, answers, alternateRenderTargets, dataStorageMode, persistencePolicy, packageManager, externalLayerId, externalLayerSource, externalLayerSourceLabel, profile, repositoryReference, cwd, allowExistingDir, noInstall, installDependencies, onProgress, variant, withMigrationUi, withTestPreset, withWpEnv, }: ScaffoldProjectOptions): Promise<ScaffoldProjectResult>;