@wp-typia/project-tools 0.24.3 → 0.24.5

package/dist/runtime/templates/built-in-block-non-ts-persistence-templates.js

@@ -0,0 +1,395 @@
+/**
+ * SCSS template for persistence block editor and frontend styles.
+ *
+ * @remarks Consumed by `buildPersistenceArtifacts()` with
+ * `{{cssClassName}}` and `{{frontendCssClassName}}` scaffold placeholders.
+ */
+export const PERSISTENCE_STYLE_TEMPLATE = `.{{cssClassName}} {
+	border: 1px solid #dcdcde;
+	border-radius: 12px;
+	padding: 16px;
+	background: #fff;
+
+	&__meta {
+		color: #50575e;
+		font-size: 13px;
+		margin: 8px 0 0;
+	}
+}
+
+.{{frontendCssClassName}} {
+	display: grid;
+	gap: 12px;
+	border: 1px solid #dcdcde;
+	border-radius: 12px;
+	padding: 16px;
+	background: #f6f7f7;
+
+	&__count {
+		display: inline-flex;
+		min-width: 3rem;
+		justify-content: center;
+		font-weight: 700;
+	}
+
+	&__notice,
+	&__error {
+		margin: 0;
+		font-size: 13px;
+	}
+
+	&__notice {
+		color: #50575e;
+	}
+
+	&__error {
+		color: #b32d2e;
+	}
+
+	button {
+		width: fit-content;
+	}
+}
+`;
+/**
+ * Main PHP `render.php` template for the persistence block.
+ *
+ * @remarks Consumed by `buildPersistenceArtifacts()` with scaffold
+ * placeholders for block identity, namespace, text domain, storage mode,
+ * persistence policy, and frontend CSS class names.
+ */
+export const PERSISTENCE_RENDER_TEMPLATE = `<?php
+/**
+ * Dynamic render entry for the {{title}} block.
+ *
+ * @package {{pascalCase}}
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+$validator_path = __DIR__ . '/typia-validator.php';
+if ( ! file_exists( $validator_path ) ) {
+	return '';
+}
+
+$validator = require $validator_path;
+if ( ! is_object( $validator ) || ! method_exists( $validator, 'apply_defaults' ) || ! method_exists( $validator, 'validate' ) ) {
+	return '';
+}
+
+$normalized   = $validator->apply_defaults( is_array( $attributes ) ? $attributes : array() );
+$validation   = $validator->validate( $normalized );
+$resource_key = isset( $normalized['resourceKey'] ) ? (string) $normalized['resourceKey'] : '';
+
+if ( empty( $validation['valid'] ) || '' === $resource_key ) {
+	return '';
+}
+
+$alignment          = isset( $normalized['alignment'] ) ? (string) $normalized['alignment'] : 'left';
+$button_label       = isset( $normalized['buttonLabel'] ) ? (string) $normalized['buttonLabel'] : 'Persist Count';
+$content            = isset( $normalized['content'] ) ? (string) $normalized['content'] : '';
+$post_id            = is_object( $block ) && isset( $block->context['postId'] )
+	? (int) $block->context['postId']
+	: (int) get_queried_object_id();
+$storage_mode       = '{{dataStorageMode}}';
+$persistence_policy = '{{persistencePolicy}}';
+
+{{phpPrefix}}_record_rendered_block_instance(
+	(int) $post_id,
+	'{{namespace}}/{{slugKebabCase}}',
+	$resource_key
+);
+
+$notice_message     = 'authenticated' === $persistence_policy
+	? __( 'Sign in to persist this counter.', '{{textDomain}}' )
+	: __( 'Public writes are temporarily unavailable.', '{{textDomain}}' );
+$context            = array(
+	'bootstrapReady'       => false,
+	'buttonLabel'          => $button_label,
+	'canWrite'             => false,
+	'client'               => array(
+		'writeExpiry' => 0,
+		'writeNonce'  => '',
+		'writeToken'  => '',
+	),
+	'count'                => 0,
+	'error'                => '',
+	'isBootstrapping'      => false,
+	'isLoading'            => false,
+	'isSaving'             => false,
+	'isVisible'            => ! empty( $normalized['isVisible'] ),
+	'persistencePolicy'    => $persistence_policy,
+	'postId'               => (int) $post_id,
+	'resourceKey'          => $resource_key,
+	'storage'              => $storage_mode,
+);
+
+$wrapper_attributes = get_block_wrapper_attributes(
+	array(
+		'data-wp-context'       => wp_json_encode( $context ),
+		'data-wp-interactive'   => '{{slugKebabCase}}',
+		'data-wp-init'          => 'callbacks.init',
+		'data-wp-run--mounted' => 'callbacks.mounted',
+	)
+);
+?>
+
+<div <?php echo $wrapper_attributes; ?>>
+	<div class="{{frontendCssClassName}}">
+		<p class="{{frontendCssClassName}}__content" style="<?php echo esc_attr( 'text-align:' . $alignment ); ?>">
+			<?php echo esc_html( $content ); ?>
+		</p>
+		<p
+			class="{{frontendCssClassName}}__notice"
+			data-wp-bind--hidden="!context.bootstrapReady || context.canWrite"
+			hidden
+		>
+			<?php echo esc_html( $notice_message ); ?>
+		</p>
+		<p
+			class="{{frontendCssClassName}}__error"
+			role="status"
+			aria-live="polite"
+			aria-atomic="true"
+			data-wp-bind--hidden="!context.error"
+			data-wp-text="context.error"
+			hidden
+		></p>
+		<?php if ( ! empty( $normalized['showCount'] ) ) : ?>
+			<span
+				class="{{frontendCssClassName}}__count"
+				role="status"
+				aria-live="polite"
+				aria-atomic="true"
+				data-wp-text="context.count"
+			>
+				0
+			</span>
+		<?php endif; ?>
+		<button
+			type="button"
+			disabled
+			data-wp-bind--disabled="!context.canWrite"
+			data-wp-on--click="actions.increment"
+		>
+			<?php echo esc_html( $button_label ); ?>
+		</button>
+	</div>
+</div>
+`;
+/**
+ * PHP helper template for persistence alternate render targets.
+ *
+ * @remarks Consumed by `buildPersistenceArtifacts()` for email, MJML,
+ * plain-text, and web render entries with block identity, namespace, text
+ * domain, storage, policy, frontend class, and title placeholders.
+ */
+export const PERSISTENCE_RENDER_TARGETS_TEMPLATE = `<?php
+/**
+ * Alternate render target helpers for the {{title}} block.
+ *
+ * @package {{pascalCase}}
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+if ( ! function_exists( '{{phpPrefix}}_{{slugSnakeCase}}_build_render_context' ) ) {
+	function {{phpPrefix}}_{{slugSnakeCase}}_build_render_context( $attributes, $content, $block ) {
+		$validator_path = __DIR__ . '/typia-validator.php';
+		if ( ! file_exists( $validator_path ) ) {
+			return null;
+		}
+
+		$validator = require $validator_path;
+		if ( ! is_object( $validator ) || ! method_exists( $validator, 'apply_defaults' ) || ! method_exists( $validator, 'validate' ) ) {
+			return null;
+		}
+
+		$normalized   = $validator->apply_defaults( is_array( $attributes ) ? $attributes : array() );
+		$validation   = $validator->validate( $normalized );
+		$resource_key = isset( $normalized['resourceKey'] ) ? (string) $normalized['resourceKey'] : '';
+
+		if ( empty( $validation['valid'] ) || '' === $resource_key ) {
+			return null;
+		}
+
+		$alignment          = isset( $normalized['alignment'] ) ? (string) $normalized['alignment'] : 'left';
+		$button_label       = isset( $normalized['buttonLabel'] ) ? (string) $normalized['buttonLabel'] : 'Persist Count';
+		$rendered_content   = isset( $normalized['content'] ) ? (string) $normalized['content'] : '';
+		$post_id            = is_object( $block ) && isset( $block->context['postId'] )
+			? (int) $block->context['postId']
+			: (int) get_queried_object_id();
+		$storage_mode       = '{{dataStorageMode}}';
+		$persistence_policy = '{{persistencePolicy}}';
+
+		{{phpPrefix}}_record_rendered_block_instance(
+			(int) $post_id,
+			'{{namespace}}/{{slugKebabCase}}',
+			$resource_key
+		);
+
+		$notice_message = 'authenticated' === $persistence_policy
+			? __( 'Sign in to persist this counter.', '{{textDomain}}' )
+			: __( 'Public writes are temporarily unavailable.', '{{textDomain}}' );
+		$web_context = array(
+			'bootstrapReady'       => false,
+			'buttonLabel'          => $button_label,
+			'canWrite'             => false,
+			'client'               => array(
+				'writeExpiry' => 0,
+				'writeNonce'  => '',
+				'writeToken'  => '',
+			),
+			'count'                => 0,
+			'error'                => '',
+			'isBootstrapping'      => false,
+			'isLoading'            => false,
+			'isSaving'             => false,
+			'isVisible'            => ! empty( $normalized['isVisible'] ),
+			'persistencePolicy'    => $persistence_policy,
+			'postId'               => (int) $post_id,
+			'resourceKey'          => $resource_key,
+			'storage'              => $storage_mode,
+		);
+
+		return array(
+			'alignment'         => $alignment,
+			'buttonLabel'       => $button_label,
+			'content'           => $rendered_content,
+			'frontendClassName' => '{{frontendCssClassName}}',
+			'isVisible'         => ! empty( $normalized['isVisible'] ),
+			'normalized'        => $normalized,
+			'noticeMessage'     => $notice_message,
+			'postId'            => (int) $post_id,
+			'resourceKey'       => $resource_key,
+			'showCount'         => ! empty( $normalized['showCount'] ),
+			'title'             => {{titleJson}},
+			'webContext'        => $web_context,
+		);
+	}
+}
+
+if ( ! function_exists( '{{phpPrefix}}_{{slugSnakeCase}}_render_target' ) ) {
+	function {{phpPrefix}}_{{slugSnakeCase}}_render_target( string $target, $attributes, $content = '', $block = null ): string {
+		$context = {{phpPrefix}}_{{slugSnakeCase}}_build_render_context( $attributes, $content, $block );
+		if ( null === $context || empty( $context['isVisible'] ) ) {
+			return '';
+		}
+
+		$target_context = apply_filters(
+			'{{phpPrefix}}_{{slugSnakeCase}}_render_target_context',
+			$context,
+			$target,
+			$attributes,
+			$block
+		);
+
+		$markup = '';
+		switch ( $target ) {
+			case 'email':
+				$parts = array(
+					'<div class="' . esc_attr( $target_context['frontendClassName'] ) . '-email">',
+					'<p style="text-align:' . esc_attr( $target_context['alignment'] ) . ';">' . esc_html( $target_context['content'] ) . '</p>',
+				);
+				if ( ! empty( $target_context['showCount'] ) ) {
+					$parts[] = '<p><strong>' . esc_html__( 'Count', '{{textDomain}}' ) . ':</strong> ' . esc_html( (string) $target_context['webContext']['count'] ) . '</p>';
+				}
+				$parts[] = '<p>' . esc_html( $target_context['noticeMessage'] ) . '</p>';
+				$parts[] = '</div>';
+				$markup = implode( '', $parts );
+				break;
+			case 'mjml':
+				$markup = '<mjml><mj-body><mj-section><mj-column><mj-text align="' . esc_attr( $target_context['alignment'] ) . '">' . esc_html( $target_context['content'] ) . '</mj-text>';
+				if ( ! empty( $target_context['showCount'] ) ) {
+					$markup .= '<mj-text>' . esc_html__( 'Count', '{{textDomain}}' ) . ': ' . esc_html( (string) $target_context['webContext']['count'] ) . '</mj-text>';
+				}
+				$markup .= '<mj-text>' . esc_html( $target_context['noticeMessage'] ) . '</mj-text></mj-column></mj-section></mj-body></mjml>';
+				break;
+			case 'plain-text':
+				$markup = implode(
+					"\\n",
+					array_filter(
+						array(
+							$target_context['title'],
+							$target_context['content'],
+							! empty( $target_context['showCount'] )
+								? sprintf( '%s: %s', __( 'Count', '{{textDomain}}' ), (string) $target_context['webContext']['count'] )
+								: null,
+							$target_context['noticeMessage'],
+						),
+						static fn( $value ) => is_string( $value ) && '' !== $value
+					)
+				);
+				break;
+			case 'web':
+			default:
+				$wrapper_attributes = get_block_wrapper_attributes(
+					array(
+						'data-wp-context'      => wp_json_encode( $target_context['webContext'] ),
+						'data-wp-interactive'  => '{{slugKebabCase}}',
+						'data-wp-init'         => 'callbacks.init',
+						'data-wp-run--mounted' => 'callbacks.mounted',
+					)
+				);
+				ob_start();
+				?>
+<div <?php echo $wrapper_attributes; ?>>
+	<div class="{{frontendCssClassName}}">
+		<p class="{{frontendCssClassName}}__content" style="<?php echo esc_attr( 'text-align:' . $target_context['alignment'] ); ?>">
+			<?php echo esc_html( $target_context['content'] ); ?>
+		</p>
+		<p
+			class="{{frontendCssClassName}}__notice"
+			data-wp-bind--hidden="!context.bootstrapReady || context.canWrite"
+			hidden
+		>
+			<?php echo esc_html( $target_context['noticeMessage'] ); ?>
+		</p>
+		<p
+			class="{{frontendCssClassName}}__error"
+			role="status"
+			aria-live="polite"
+			aria-atomic="true"
+			data-wp-bind--hidden="!context.error"
+			data-wp-text="context.error"
+			hidden
+		></p>
+		<?php if ( ! empty( $target_context['showCount'] ) ) : ?>
+			<span
+				class="{{frontendCssClassName}}__count"
+				role="status"
+				aria-live="polite"
+				aria-atomic="true"
+				data-wp-text="context.count"
+			>
+				0
+			</span>
+		<?php endif; ?>
+		<button
+			type="button"
+			disabled
+			data-wp-bind--disabled="!context.canWrite"
+			data-wp-on--click="actions.increment"
+		>
+			<?php echo esc_html( $target_context['buttonLabel'] ); ?>
+		</button>
+	</div>
+</div>
+				<?php
+				$markup = (string) ob_get_clean();
+				break;
+		}
+
+		return apply_filters(
+			'{{phpPrefix}}_{{slugSnakeCase}}_render_target_markup',
+			$markup,
+			$target,
+			$target_context
+		);
+	}
+}
+`;

package/dist/runtime/templates/built-in-block-non-ts-render-utils.d.ts

@@ -0,0 +1,27 @@
+import type { BuiltInCodeArtifact } from "./built-in-block-code-artifacts.js";
+import type { ScaffoldTemplateVariables } from "./scaffold.js";
+/**
+ * Renders a non-TypeScript artifact and normalizes the output to a trailing newline.
+ *
+ * @param relativePath Relative output path for the generated artifact.
+ * @param template Mustache template source to render.
+ * @param view Template view data passed to the Mustache renderer.
+ * @returns A built-in code artifact with normalized source text.
+ */
+export declare function renderArtifact(relativePath: string, template: string, view: Record<string, unknown>): BuiltInCodeArtifact;
+/**
+ * Builds a PHP entrypoint for a specific alternate render target.
+ *
+ * @param relativePath Relative output path for the generated PHP file.
+ * @param target Alternate render target identifier to dispatch.
+ * @param variables Scaffold template variables used to render the entrypoint.
+ * @returns A built-in code artifact for the requested alternate render target.
+ */
+export declare function buildAlternateRenderEntryArtifact(relativePath: string, target: "email" | "mjml" | "plain-text" | "web", variables: ScaffoldTemplateVariables): BuiltInCodeArtifact;
+/**
+ * Escapes a string for safe embedding in a PHP single-quoted literal.
+ *
+ * @param value Source string to escape.
+ * @returns A PHP single-quoted string literal.
+ */
+export declare function toPhpSingleQuotedString(value: string): string;

package/dist/runtime/templates/built-in-block-non-ts-render-utils.js

@@ -0,0 +1,53 @@
+import { assertScaffoldTemplateCodeIdentifiers } from "./scaffold-template-assertions.js";
+import { renderMustacheTemplateString } from "./template-render.js";
+/**
+ * Renders a non-TypeScript artifact and normalizes the output to a trailing newline.
+ *
+ * @param relativePath Relative output path for the generated artifact.
+ * @param template Mustache template source to render.
+ * @param view Template view data passed to the Mustache renderer.
+ * @returns A built-in code artifact with normalized source text.
+ */
+export function renderArtifact(relativePath, template, view) {
+    assertScaffoldTemplateCodeIdentifiers(view);
+    const source = renderMustacheTemplateString(template, view);
+    return {
+        relativePath,
+        source: source.endsWith("\n") ? source : `${source}\n`,
+    };
+}
+/**
+ * Builds a PHP entrypoint for a specific alternate render target.
+ *
+ * @param relativePath Relative output path for the generated PHP file.
+ * @param target Alternate render target identifier to dispatch.
+ * @param variables Scaffold template variables used to render the entrypoint.
+ * @returns A built-in code artifact for the requested alternate render target.
+ */
+export function buildAlternateRenderEntryArtifact(relativePath, target, variables) {
+    const template = `<?php
+/**
+ * Alternate ${target} render entry for {{title}}.
+ *
+ * @package {{pascalCase}}
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+\texit;
+}
+
+require_once __DIR__ . '/render-targets.php';
+
+return {{phpPrefix}}_{{slugSnakeCase}}_render_target( '${target}', $attributes, $content ?? '', $block ?? null );
+`;
+    return renderArtifact(relativePath, template, variables);
+}
+/**
+ * Escapes a string for safe embedding in a PHP single-quoted literal.
+ *
+ * @param value Source string to escape.
+ * @returns A PHP single-quoted string literal.
+ */
+export function toPhpSingleQuotedString(value) {
+    return `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+}

package/dist/runtime/templates/cli-scaffold-emission.d.ts

@@ -0,0 +1,124 @@
+import { scaffoldProject } from "./scaffold.js";
+import type { PackageManagerId } from "../shared/package-managers.js";
+import type { ScaffoldProgressEvent } from "./scaffold.js";
+type ScaffoldProjectOptions = Parameters<typeof scaffoldProject>[0];
+/**
+ * Dependency installation hook accepted by scaffold emission.
+ */
+export type ScaffoldInstallDependencies = ScaffoldProjectOptions["installDependencies"];
+/**
+ * Dry-run metadata returned after rendering a scaffold into a preview directory.
+ */
+export interface ScaffoldDryRunPlan {
+    /**
+     * Whether dependency installation would run or is skipped by --no-install.
+     */
+    dependencyInstall: "skipped-by-flag" | "would-install";
+    /**
+     * Sorted project-relative paths that would be written by the scaffold.
+     */
+    files: string[];
+}
+/**
+ * Normalized scaffold emission options shared by real and dry-run flows.
+ */
+export interface ScaffoldEmissionOptions {
+    /**
+     * Whether an existing target directory may be reused.
+     */
+    allowExistingDir: boolean;
+    /**
+     * Optional alternate render target specification for supported templates.
+     */
+    alternateRenderTargets?: ScaffoldProjectOptions["alternateRenderTargets"];
+    /**
+     * Resolved scaffold answers used by template variable generation.
+     */
+    answers: ScaffoldProjectOptions["answers"];
+    /**
+     * Caller working directory used to resolve relative template inputs.
+     */
+    cwd: string;
+    /**
+     * Persistence storage mode for templates that support storage options.
+     */
+    dataStorageMode?: ScaffoldProjectOptions["dataStorageMode"];
+    /**
+     * Optional public root id selected from an external layer package.
+     */
+    externalLayerId?: string;
+    /**
+     * Optional external layer source package, path, or locator.
+     */
+    externalLayerSource?: string;
+    /**
+     * Display label for the external layer source before path resolution.
+     */
+    externalLayerSourceLabel?: string;
+    /**
+     * Optional dependency installer override used by tests and callers.
+     */
+    installDependencies?: ScaffoldProjectOptions["installDependencies"];
+    /**
+     * Whether generated projects should skip dependency installation.
+     */
+    noInstall: boolean;
+    /**
+     * Optional callback for scaffold progress events.
+     */
+    onProgress?: ((event: ScaffoldProgressEvent) => void | Promise<void>) | undefined;
+    /**
+     * Package manager used for generated metadata and follow-up commands.
+     */
+    packageManager: PackageManagerId;
+    /**
+     * Persistence access policy for templates that support server storage.
+     */
+    persistencePolicy?: ScaffoldProjectOptions["persistencePolicy"];
+    /**
+     * Optional create profile that enables preset groups such as plugin QA.
+     */
+    profile?: ScaffoldProjectOptions["profile"];
+    /**
+     * Absolute target directory for the generated project.
+     */
+    projectDir: string;
+    /**
+     * Resolved template id or external template locator to render.
+     */
+    templateId: string;
+    /**
+     * Optional built-in or external template variant id.
+     */
+    variant?: string;
+    /**
+     * Whether migration UI support should be added when supported.
+     */
+    withMigrationUi: boolean;
+    /**
+     * Whether scaffold test presets should be emitted.
+     */
+    withTestPreset: boolean;
+    /**
+     * Whether local wp-env support should be emitted.
+     */
+    withWpEnv: boolean;
+}
+/**
+ * Emit scaffold files into the target project directory.
+ *
+ * @param options Normalized scaffold emission options.
+ * @returns The scaffold result produced by the runtime renderer.
+ */
+export declare function emitScaffoldProject(options: ScaffoldEmissionOptions): Promise<Awaited<ReturnType<typeof scaffoldProject>>>;
+/**
+ * Build a dry-run scaffold plan without mutating the requested target directory.
+ *
+ * @param options Normalized scaffold emission options.
+ * @returns Preview metadata and the scaffold result from the temp render.
+ */
+export declare function buildScaffoldDryRunPlan(options: ScaffoldEmissionOptions): Promise<{
+    plan: ScaffoldDryRunPlan;
+    result: Awaited<ReturnType<typeof scaffoldProject>>;
+}>;
+export {};

package/dist/runtime/templates/cli-scaffold-emission.js

@@ -0,0 +1,45 @@
+import path from "node:path";
+import { assertDryRunTargetDirectoryReady, listRelativeProjectFiles, } from "./cli-scaffold-files.js";
+import { scaffoldProject } from "./scaffold.js";
+import { createManagedTempRoot } from "../shared/temp-roots.js";
+/**
+ * Emit scaffold files into the target project directory.
+ *
+ * @param options Normalized scaffold emission options.
+ * @returns The scaffold result produced by the runtime renderer.
+ */
+export async function emitScaffoldProject(options) {
+    return scaffoldProject(options);
+}
+/**
+ * Build a dry-run scaffold plan without mutating the requested target directory.
+ *
+ * @param options Normalized scaffold emission options.
+ * @returns Preview metadata and the scaffold result from the temp render.
+ */
+export async function buildScaffoldDryRunPlan(options) {
+    await assertDryRunTargetDirectoryReady(options.projectDir, options.allowExistingDir);
+    const { path: tempRoot, cleanup } = await createManagedTempRoot("wp-typia-scaffold-plan-");
+    const previewProjectDir = path.join(tempRoot, "preview-project");
+    try {
+        const result = await emitScaffoldProject({
+            ...options,
+            allowExistingDir: false,
+            noInstall: true,
+            projectDir: previewProjectDir,
+        });
+        const files = await listRelativeProjectFiles(previewProjectDir);
+        return {
+            plan: {
+                dependencyInstall: options.noInstall
+                    ? "skipped-by-flag"
+                    : "would-install",
+                files,
+            },
+            result,
+        };
+    }
+    finally {
+        await cleanup();
+    }
+}

package/dist/runtime/templates/cli-scaffold-files.d.ts

@@ -0,0 +1,22 @@
+/**
+ * List every file emitted under a scaffold project using POSIX-style paths.
+ *
+ * @param rootDir Root project directory to scan recursively.
+ * @returns Sorted relative file paths suitable for dry-run preview output.
+ */
+export declare function listRelativeProjectFiles(rootDir: string): Promise<string[]>;
+/**
+ * Ensure a dry-run target would be legal before rendering into a temp preview.
+ *
+ * @param projectDir Real target project directory requested by the user.
+ * @param allowExistingDir Whether existing target directories are allowed.
+ * @throws Error when the target exists, is non-empty, and is not allowed.
+ */
+export declare function assertDryRunTargetDirectoryReady(projectDir: string, allowExistingDir: boolean): Promise<void>;
+/**
+ * Read script names from the package manifest emitted by a scaffold run.
+ *
+ * @param projectDir Generated project directory containing package.json.
+ * @returns Script names, or undefined when the manifest is absent or invalid.
+ */
+export declare function readGeneratedPackageScripts(projectDir: string): Promise<string[] | undefined>;