@invarn/cibuild 2.9.4 → 2.9.7

package/dist/src/yaml/steps/ui-fidelity-render-android.d.ts

@@ -1,155 +0,0 @@
-/**
- * ui-fidelity-render-android step implementation.
- *
- * Renders parameterless Jetpack Compose wrappers from a self-contained Gradle
- * project to PNGs via Roborazzi + Robolectric on the JVM — no device, no
- * emulator — on a macOS runner. The step returns a self-contained node script
- * that, at runtime:
- *
- *   1. Reads `.ci/inputs/params.json`
- *      ({ "screens": { "<ScreenName>": "<referenceFileBasename>" } });
- *      reference images live at `.ci/inputs/<basename>`.
- *      Optional reference-provenance sidecar (manifest-driven multi-state path):
- *      `"render_locale": "<locale>"` plus
- *      `"provenance": { "<ScreenName>": { figmaNode, locale, resolved, exportedAt } }`.
- *      The gate arms whenever a screen's provenance is present (or, legacy, when
- *      `render_locale` is declared) and checks provenance METADATA only (never
- *      pixels/OCR). An absent reference — or an unprovenanced screen while
- *      `render_locale` is declared — is FATAL: status `unverifiable`, failing
- *      loud instead of yielding a confident-but-false PASS. `resolved == false`
- *      (placeholder copy) or `locale != render_locale` downgrade ONLY the copy
- *      channel: the screen renders and is judged on geometry, colors, typeface,
- *      spans, and lines, while copy comparisons are skipped and reported as a
- *      per-screen `copy_advisory` (`copy_unverifiable` + reason) in
- *      protocol-result.json. Content differences (copy, geometry) are NOT gated
- *      here — they stay soft, judged findings.
- *   2. Extracts and validates the shipped Gradle project shipped as
- *      `.ci/inputs/package.tar.gz` (single project root carrying a settings
- *      script, bounded extracted size, safe member paths).
- *   3. Runs the project's Roborazzi record task (default
- *      `recordRoborazziDebug`) once. A build/compile failure means the project
- *      does not render and every screen is marked RENDER_UNSUPPORTED — the
- *      Android analog of the iOS probe gate (one Gradle module compiles as a
- *      unit, so a wrapper compile error cannot be isolated to one screen).
- *   4. Locates each screen's Roborazzi golden inside the project (recorded as
- *      `build/outputs/roborazzi/...render<ScreenName>.png` from a test method
- *      named render<ScreenName>, or a flat `<ScreenName>.png`), runs it through
- *      the shared render-output
- *      post-processor (content trim, reference alignment, dimension
- *      reporting), and writes, inside the artifacts dir
- *      (${CIBUILD_ARTIFACTS_DIR:-.ci/artifacts}):
- *      - ui-fidelity/rendered/<Screen>.png
- *      - ui-fidelity/references/<Screen>.png
- *      - ui-fidelity/aligned/<Screen>.png
- *      - protocol-result.json (always written, even on partial/total failure)
- *   5. Exits non-zero iff the archive was invalid or any screen is not
- *      "rendered".
- *
- * The result payload and artifact layout are identical in shape to the iOS
- * ui-fidelity-render step, so the dashboard compare view, the artifact
- * download tool, and the agent's compare flow are reused unchanged. Image
- * paths in protocol-result.json are relative to the artifacts dir, and error
- * messages are sanitized so absolute runner paths are rewritten before they
- * are stored.
- */
-import { BaseStepExecutor } from './base.js';
-import type { StepDef, CIConfig } from '../../types.js';
-import type { ValidationRequirement } from '../validation-types.js';
-/** Inputs for the ui-fidelity-render-android step. */
-export interface UiFidelityRenderAndroidInputs {
-    /**
-     * Display scale factor applied when reporting logical points (default 2).
-     * Must match the density qualifier the render test pins (xhdpi = 2x), so
-     * logical_pt = rendered_px / scale lines up with design references.
-     */
-    scale?: number | string;
-    /**
-     * Gradle task that records the Roborazzi PNGs (default
-     * "recordRoborazziDebug"). Run from the project root, so it executes in
-     * whichever module declares it.
-     */
-    gradle_task?: string;
-}
-/**
- * Default Roborazzi record task. Run from the project root so Gradle resolves
- * it in whichever subproject declares it.
- */
-export declare const DEFAULT_GRADLE_TASK = "recordRoborazziDebug";
-/** Valid values for the package_source input. */
-export declare const PACKAGE_SOURCES: readonly ["repo", "inputs", "url"];
-export type PackageSource = (typeof PACKAGE_SOURCES)[number];
-/**
- * Default package source: the Gradle project ships as package.tar.gz in the
- * run-inputs directory (the agent-upload path). "repo" instead renders the
- * committed project at package_path, for a triggered (agent-less) run.
- * "url" (fidelity-linux 03) downloads the same package.tar.gz from a signed
- * package_url into the run-inputs directory and then proceeds byte-for-byte
- * like inputs mode — the clone-free delivery for triggered runs, on macOS
- * and Linux workers alike.
- */
-export declare const DEFAULT_PACKAGE_SOURCE: PackageSource;
-/** Valid values for the reference_source input. */
-export declare const REFERENCE_SOURCES: readonly ["repo", "inputs"];
-export type ReferenceSource = (typeof REFERENCE_SOURCES)[number];
-/**
- * Default reference source: references arrive as run inputs (a plain basename
- * under `.ci/inputs`), matching the agent-upload path.
- */
-export declare const DEFAULT_REFERENCE_SOURCE: ReferenceSource;
-/** Basename of the shipped Gradle-project archive inside the run-inputs dir. */
-export declare const PACKAGE_ARCHIVE_BASENAME = "package.tar.gz";
-/** Renderer identifier recorded in protocol-result.json. */
-export declare const ANDROID_RENDERER = "roborazzi-robolectric";
-/**
- * Validates a Gradle task name: a non-empty token of letters, digits, and the
- * separators Gradle allows in a task path (`:`, `-`, `_`). Rejects shell
- * metacharacters so the task is safe to pass to the runner.
- */
-export declare function isValidGradleTask(task: string): boolean;
-/** Config baked into the generated runtime script at YAML-conversion time. */
-export interface AndroidRenderScriptConfig {
-    scale: number;
-    gradleTask: string;
-    /**
-     * Only present when package_source was explicitly set to a non-default mode
-     * ("repo" or "url"). When absent, the project ships as package.tar.gz and is
-     * extracted/validated exactly as the default, byte-identical script.
-     */
-    packageSource?: PackageSource;
-    /**
-     * Repo-relative path to the committed Gradle project. Present (and required)
-     * with packageSource "repo" (the checkout dir to render) and "url" (the
-     * prefix committed reference paths are resolved under, inside the extracted
-     * package); ignored otherwise.
-     */
-    packagePath?: string;
-    /**
-     * Signed download URL for package.tar.gz. Present (and required) only with
-     * packageSource "url"; ignored otherwise.
-     */
-    packageUrl?: string;
-    /**
-     * Only present (and only ever "repo") when reference_source was explicitly set
-     * to "repo". When absent, references are read from `.ci/inputs/<basename>` and
-     * the generated reference-sourcing code is byte-identical to the default.
-     */
-    referenceSource?: ReferenceSource;
-}
-/**
- * Generates the self-contained runtime node script for the step. Pure function
- * of its config — exported so tests can execute the script directly.
- *
- * When config.referenceSource is absent the reference block is byte-identical
- * to the default (JSON.stringify drops the undefined key, and the unpatched
- * runtime is used).
- */
-export declare function generateAndroidRenderScript(config: AndroidRenderScriptConfig): string;
-/**
- * ui-fidelity-render-android step executor. Returns a node-kind StepDef whose
- * script performs the render at runtime on the macOS runner.
- */
-export declare class UiFidelityRenderAndroidStepExecutor extends BaseStepExecutor {
-    getValidationRequirements(inputs: UiFidelityRenderAndroidInputs, _env: Record<string, string>, _config: CIConfig): ValidationRequirement[];
-    execute(inputs: UiFidelityRenderAndroidInputs, _env: Record<string, string>, _config: CIConfig): Promise<StepDef>;
-}
-//# sourceMappingURL=ui-fidelity-render-android.d.ts.map

package/dist/src/yaml/steps/ui-fidelity-render-android.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ui-fidelity-render-android.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/ui-fidelity-render-android.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAMpE,sDAAsD;AACtD,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D,iDAAiD;AACjD,eAAO,MAAM,eAAe,oCAAqC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAAwB,CAAC;AAE9D,mDAAmD;AACnD,eAAO,MAAM,iBAAiB,6BAA8B,CAAC;AAC7D,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAA0B,CAAC;AAElE,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AAEzD,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,8EAA8E;AAC9E,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAurCD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CA0BrF;AAED;;;GAGG;AACH,qBAAa,mCAAoC,SAAQ,gBAAgB;IACvE,yBAAyB,CACvB,MAAM,EAAE,6BAA6B,EACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,qBAAqB,EAAE;IAyBpB,OAAO,CACX,MAAM,EAAE,6BAA6B,EACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,OAAO,CAAC;CAiGpB"}