@invarn/cibuild 2.0.1 → 2.0.2

package/dist/src/yaml/steps/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAi3C7C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqCH;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CA63C7C"}

package/dist/src/yaml/steps/index.js

@@ -24,7 +24,7 @@ import { BitriseSlackStepExecutor } from './bitrise-slack.js';
 import { BitriseApkInfoStepExecutor } from './bitrise-apk-info.js';
 import { GooglePlayDeployStepExecutor } from './google-play-deploy.js';
 import { AppStoreDeployStepExecutor } from './app-store-deploy.js';
-import { UiFidelityRenderStepExecutor, DEFAULT_RENDER_SIZE, DEFAULT_SCALE, } from './ui-fidelity-render.js';
+import { UiFidelityRenderStepExecutor, DEFAULT_RENDER_SIZE, DEFAULT_SCALE, DEFAULT_PACKAGE_SOURCE, } from './ui-fidelity-render.js';
 /**
  * Initializes the step registry with all available steps
  * This function should be called once at application startup
@@ -764,14 +764,23 @@ export function initializeStepRegistry() {
         description: 'Render parameterless SwiftUI views from a SwiftPM package to PNGs with ImageRenderer (no app build, no simulator)',
         platform: 'ios',
         inputs: {
+            package_source: {
+                description: "Where the SwiftPM package comes from: 'repo' (package_path in the checkout) " +
+                    "or 'inputs' (package.tar.gz shipped in the run-inputs directory)",
+                required: false,
+                default: DEFAULT_PACKAGE_SOURCE,
+            },
             package_path: {
-                description: "Path to the user's SwiftPM package containing the screens",
-                required: true,
+                description: "Path to the user's SwiftPM package containing the screens. " +
+                    "Required when package_source is 'repo' (the default); ignored with 'inputs'",
+                required: false,
                 inputType: 'path',
             },
             target: {
-                description: 'SPM library product to import in the render harness',
-                required: true,
+                description: 'SPM library product to import in the render harness. Required when ' +
+                    "package_source is 'repo'; optional with 'inputs', where it is discovered " +
+                    'from the shipped manifest when exactly one library product exists',
+                required: false,
                 inputType: 'text',
             },
             render_size: {

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

@@ -28,8 +28,25 @@
  *
  * protocol-result.json contains relative paths only: image paths are relative
  * to the artifacts dir, and error messages are sanitized so absolute runner
- * paths (resolved package_path, harness temp dir, compiler diagnostics) are
- * rewritten to relative paths or placeholders before they are stored.
+ * paths (resolved package_path, harness temp dir, extracted shipped package,
+ * compiler diagnostics) are rewritten to relative paths or placeholders
+ * before they are stored.
+ *
+ * The package_source input picks where the SwiftPM package comes from:
+ *   - "repo" (default): the package lives in the checkout at package_path.
+ *     Omitting the input generates a byte-identical script to the original
+ *     step (locked by a snapshot test), and the result document keeps its
+ *     original { renderer, screens } shape.
+ *   - "inputs": the caller ships the package as .ci/inputs/package.tar.gz.
+ *     The archive is extracted into a scratch directory and validated
+ *     (single package root, Package.swift at its top, bounded extracted
+ *     size); rendering then proceeds exactly as in repo mode. Validation
+ *     failures are per-build structured errors (PACKAGE_ARCHIVE_MISSING,
+ *     PACKAGE_ARCHIVE_INVALID, PACKAGE_MANIFEST_MISSING,
+ *     PACKAGE_ARCHIVE_TOO_LARGE, PACKAGE_TARGET_UNRESOLVED) recorded as a
+ *     top-level error object in the result document, distinct from
+ *     per-screen render errors. With an explicit package_source the result
+ *     document is { renderer, package_source, error, screens }.
  */
 import { BaseStepExecutor } from './base.js';
 import type { StepDef, CIConfig } from '../../types.js';
@@ -38,10 +55,26 @@ import type { ValidationRequirement } from '../validation-types.js';
  * Inputs for the ui-fidelity-render step
  */
 export interface UiFidelityRenderInputs {
-    /** Path to the user's SwiftPM package (the package that defines the screens) */
-    package_path: string;
-    /** SPM library product/target to import in the render harness */
-    target: string;
+    /**
+     * Where the SwiftPM package comes from (default "repo"):
+     * - "repo": the package lives in the checkout at package_path (v1
+     *   behavior; omitting package_source generates a byte-identical script).
+     * - "inputs": the package ships as .ci/inputs/package.tar.gz and is
+     *   extracted, validated, and built from a scratch directory at runtime.
+     */
+    package_source?: 'repo' | 'inputs';
+    /**
+     * Path to the user's SwiftPM package (the package that defines the
+     * screens). Required in repo mode; ignored with package_source "inputs".
+     */
+    package_path?: string;
+    /**
+     * SPM library product/target to import in the render harness. Required in
+     * repo mode; optional with package_source "inputs", where it is discovered
+     * from the shipped manifest when the package declares exactly one library
+     * product.
+     */
+    target?: string;
     /** Render size in device points, formatted "<width>x<height>" (default 393x852) */
     render_size?: string;
     /** Display scale factor applied to the render (default 2) */
@@ -56,6 +89,22 @@ export interface UiFidelityRenderInputs {
 export declare const DEFAULT_RENDER_SIZE = "393x852";
 /** Default display scale (@2x), matching how references are typically exported. */
 export declare const DEFAULT_SCALE = 2;
+/** Valid values for the package_source input. */
+export declare const PACKAGE_SOURCES: readonly ["repo", "inputs"];
+export type PackageSource = (typeof PACKAGE_SOURCES)[number];
+/** Default package source: the package lives in the repo checkout. */
+export declare const DEFAULT_PACKAGE_SOURCE: PackageSource;
+/** Basename of the shipped package archive inside the run-inputs directory. */
+export declare const PACKAGE_ARCHIVE_BASENAME = "package.tar.gz";
+/**
+ * Default cap on the extracted size of a shipped package archive (32 MiB),
+ * overridable at runtime via UI_FIDELITY_MAX_PACKAGE_BYTES. The archive
+ * arrives through a size-limited dispatch channel (256 KiB), and gzip tops
+ * out around a 1000:1 ratio, so this bound is a decompression-bomb guard
+ * with enormous headroom for legitimate source slices, which are typically
+ * well under 1 MiB extracted.
+ */
+export declare const DEFAULT_MAX_EXTRACTED_BYTES: number;
 export interface RenderSize {
     width: number;
     height: number;
@@ -74,13 +123,23 @@ export declare function parseScale(value: number | string): number;
  * Configuration baked into the generated runtime script at YAML-conversion
  * time. Everything else (screens, references) is read at runtime from
  * .ci/inputs/params.json.
+ *
+ * packageSource is only present when the package_source input was explicitly
+ * configured. When absent, the generated script is byte-identical to the
+ * pre-package_source script (locked by a snapshot test) and the result
+ * document keeps its original `{ renderer, screens }` shape. When present,
+ * the result document additionally records `package_source` and a top-level
+ * `error` (null, or `{ code, message }` for per-build package failures).
  */
 export interface RenderScriptConfig {
-    packagePath: string;
-    target: string;
+    /** null only with packageSource "inputs", where the package is shipped. */
+    packagePath: string | null;
+    /** null only with packageSource "inputs", where it may be discovered. */
+    target: string | null;
     width: number;
     height: number;
     scale: number;
+    packageSource?: PackageSource;
 }
 /** Options consumed by the pure Swift-source generators. */
 export interface HarnessGeneratorOptions {
@@ -106,6 +165,10 @@ export declare function getRenderScriptInternals(): RenderScriptInternals;
 /**
  * Generates the self-contained runtime node script for the step.
  * Pure function of its config — exported so tests can execute the script.
+ *
+ * When config.packageSource is absent the output is byte-identical to the
+ * pre-package_source script (JSON.stringify drops undefined keys, and the
+ * unpatched v1 runtime is used).
  */
 export declare function generateRenderScript(config: RenderScriptConfig): string;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"ui-fidelity-render.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/ui-fidelity-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;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;AAEpE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C,mFAAmF;AACnF,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAWzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAQzD;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4DAA4D;AAC5D,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAAC;IACzF,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAAC;IAC7D,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAAC;CAC/E;AA6eD;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,CAShE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAQvE;AAED;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,gBAAgB;IAChE,yBAAyB,CACvB,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,qBAAqB,EAAE;IAoBpB,OAAO,CACX,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,OAAO,CAAC;CAoBpB"}
+{"version":3,"file":"ui-fidelity-render.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/ui-fidelity-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;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;AAEpE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACnC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C,mFAAmF;AACnF,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,iDAAiD;AACjD,eAAO,MAAM,eAAe,6BAA8B,CAAC;AAC3D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,EAAE,aAAsB,CAAC;AAE5D,+EAA+E;AAC/E,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,QAAmB,CAAC;AAE5D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAWzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAQzD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,yEAAyE;IACzE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,4DAA4D;AAC5D,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAAC;IACzF,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAAC;IAC7D,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAAC;CAC/E;AAg5BD;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,CAShE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAUvE;AAED;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,gBAAgB;IAChE,yBAAyB,CACvB,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,qBAAqB,EAAE;IAoCpB,OAAO,CACX,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,OAAO,CAAC;CA0DpB"}