@t09tanaka/stoneage 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+import { type BuildConfig, type BuildReport, type DataFlowFamilySummary, type DataFlowReport, type DataFlowDependencySummary, type SizeBudgetConfig, type ValidationIssue } from "./core.js";
+import { type ExampleBenchmark, type ExampleCounts } from "./example.js";
+import { type DeployProvider } from "./deploy.js";
+import { type ImageFormat } from "./images.js";
+export type CliCommand = {
+    command: "help";
+} | {
+    command: "benchmark";
+    outDir: string;
+    counts: Partial<ExampleCounts>;
+    trailingSlash?: BuildConfig["trailingSlash"];
+    includePublicDataExports?: boolean;
+    compareTo?: string;
+    maxSizeRegressionPercent?: number;
+    comparisonReportPath?: string;
+} | {
+    command: "validate";
+    outDir: string;
+    budgets?: SizeBudgetConfig;
+    requirePrecompressed?: boolean;
+    validationConfigPath?: string;
+    writeValidationConfigPath?: string;
+    json?: boolean;
+    reportPath?: string;
+    provider?: DeployProvider;
+} | {
+    command: "inspect";
+    outDir: string;
+    dependency: string;
+    json?: boolean;
+} | {
+    command: "plan";
+    outDir: string;
+    dependencies: string[];
+    json?: boolean;
+} | {
+    command: "optimize";
+    outDir: string;
+} | {
+    command: "optimize-images";
+    outDir: string;
+    sourceDir: string;
+    widths: number[];
+    formats: ImageFormat[];
+} | {
+    command: "deploy";
+    outDir: string;
+    provider: DeployProvider;
+    cname?: string;
+} | {
+    command: "dev";
+    outDir: string;
+    host?: string;
+    port?: number;
+    watchPaths?: string[];
+    buildCommand?: string;
+    debounceMs?: number;
+} | {
+    command: "agent-skill";
+    print: true;
+} | {
+    command: "audit-sveltekit";
+    routesDir: string;
+    paramsDir?: string;
+    json?: boolean;
+    reportPath?: string;
+    migrationPlan?: boolean;
+    emitStubsDir?: string;
+} | {
+    command: "build";
+    entry: string;
+    forwardedArgs: string[];
+} | {
+    command: "test";
+    forwardedArgs: string[];
+};
+export type ValidationSummary = {
+    ok: boolean;
+    pageCount: number;
+    artifactCount: number;
+    publicAssetCount: number;
+    publicAssetsCopied: number;
+    publicAssetsSkipped: number;
+    staleOutputsRemoved: number;
+    publicFileCount: number;
+    publicFileBytes: number;
+    transferSidecars: TransferSidecarSummary;
+    stylesheetAssetCount: number;
+    stylesheetAssetBytes: number;
+    publicCssFileCount: number;
+    publicCssFileBytes: number;
+    publicJavaScriptFileCount: number;
+    publicJavaScriptFileBytes: number;
+    imageAssetCount: number;
+    imageAssetBytes: number;
+    missingLinks: string[];
+    sitemapUrls: number;
+    sitemapFiles: string[];
+    sitemapFileIssues: ValidationIssue[];
+    publicDataExports: number;
+    publicDataExportIssues: ValidationIssue[];
+    headersManifestIssues: ValidationIssue[];
+    redirectManifestIssues: ValidationIssue[];
+    robotsTxtIssues: ValidationIssue[];
+    deployArtifactIssues: ValidationIssue[];
+    htmlMetadataIssues: ValidationIssue[];
+    hydrationPayloadIssues: ValidationIssue[];
+    missingAssetReferences: ValidationIssue[];
+    prefetchReferenceIssues: ValidationIssue[];
+    manifestOutputIssues: ValidationIssue[];
+    orphanHtmlIssues: ValidationIssue[];
+    largestHtml: BuildReport["largestHtml"];
+    largestArtifacts: BuildReport["largestArtifacts"];
+    largestPublicFiles: PublicFileSummary[];
+    publicFileTypes: PublicFileTypeSummary[];
+    largestStylesheets: StylesheetAssetSummary[];
+    largestPublicCssFiles: PublicFileSummary[];
+    largestPublicJavaScriptFiles: PublicFileSummary[];
+    largestImages: PublicFileSummary[];
+    routeFamilies: Record<string, number>;
+    routeWrites: Record<string, number>;
+    artifactFamilies: Record<string, number>;
+    artifactWrites: Record<string, number>;
+    dataFlow?: ValidationDataFlowSummary;
+    validationOptions?: ValidationOptionsSummary;
+    validationIssues: ValidationIssue[];
+    budgetFailures: ValidationBudgetFailure[];
+    sitemapDrift: {
+        missing: string[];
+        extra: string[];
+    };
+};
+export type PublicFileSummary = {
+    path: string;
+    bytes: number;
+    type: string;
+};
+export type PublicFileTypeSummary = {
+    type: string;
+    files: number;
+    bytes: number;
+};
+export type TransferSidecarSummary = {
+    compressibleFiles: number;
+    brotliFiles: number;
+    gzipFiles: number;
+    originalBytes: number;
+    brotliBytes: number;
+    gzipBytes: number;
+    missingBrotliFiles: string[];
+    missingGzipFiles: string[];
+};
+export type StylesheetAssetSummary = {
+    path: string;
+    bytes: number;
+    references: number;
+};
+export type ValidationBudgetFailure = {
+    kind: "pages" | "artifacts" | "route-family-pages" | "artifact-family-outputs" | "html" | "css" | "js" | "public-file" | "total-public" | "image-total" | "brotli" | "gzip" | "dependency-fanout";
+    path: string;
+    bytes: number;
+    limit: number;
+    dependency?: string;
+    outputs?: number;
+};
+export type ValidationDataFlowSummary = {
+    outputs: DataFlowReport["outputs"];
+    dependencyCount: number;
+    largestDependencyFanout: DataFlowDependencySummary[];
+    routeFamilies: DataFlowFamilySummary[];
+    artifactFamilies: DataFlowFamilySummary[];
+};
+export type ValidationOptionsSummary = {
+    configPath?: string;
+    configHash?: string;
+    budgets?: SizeBudgetConfig;
+    requirePrecompressed?: boolean;
+    provider?: DeployProvider;
+};
+export type ValidationOutputOptions = ValidationOptionsSummary;
+export type DependencyInspectSummary = {
+    dependency: string;
+    pageCount: number;
+    artifactCount: number;
+    pages: Array<{
+        route: string;
+        path: string;
+        outputPath: string;
+        hash: string;
+    }>;
+    artifacts: Array<{
+        route: string;
+        path: string;
+        outputPath: string;
+        hash: string;
+    }>;
+};
+export type DependencyPlanSummary = {
+    dependencies: string[];
+    outputCount: number;
+    pageCount: number;
+    artifactCount: number;
+    outputs: DependencyPlanOutput[];
+};
+export type DependencyPlanOutput = {
+    kind: "page" | "artifact";
+    route: string;
+    path: string;
+    outputPath: string;
+    dependencies: Record<string, string>;
+};
+export type BenchmarkComparison = {
+    ok: boolean;
+    baselinePath?: string;
+    currentReportPath?: string;
+    maxSizeRegressionPercent: number;
+    comparedMetrics: number;
+    regressions: BenchmarkRegression[];
+};
+export type BenchmarkRegression = {
+    metric: string;
+    baseline: number;
+    current: number;
+    delta: number;
+    regressionPercent: number | null;
+    limitPercent: number;
+};
+export declare function parseArgs(args: string[]): CliCommand;
+export declare function runCli(args?: string[]): Promise<void>;
+export declare function compareBenchmarkMetrics(current: ExampleBenchmark, baseline: unknown, options?: {
+    maxSizeRegressionPercent?: number;
+}): BenchmarkComparison;
+export declare function inspectDependency(outDir: string, dependency: string): Promise<DependencyInspectSummary>;
+export declare function planDependencyRebuilds(outDir: string, dependencies: string[]): Promise<DependencyPlanSummary>;
+export declare function validateOutput(outDir: string, options?: ValidationOutputOptions): Promise<ValidationSummary>;