@12ui/design 0.2.12 → 0.2.14

package/dist/branch-viewport-normalization.d.ts

@@ -0,0 +1,74 @@
+/**
+ * One page stacks into one tall source, so every viewport of it must share one
+ * width. Branch pages mix two origins that cannot agree on their own:
+ *
+ *   - the CONTINUATION screens, drawn by the server on a canvas fixed by the
+ *     run's aspect (`CREATE_ASPECT_SIZES`, 1536x1024 for landscape). The build
+ *     claim accepts `source`, `concept`, `aspect`, `winner` and
+ *     `referenceImage` and nothing else — there is no width parameter — so the
+ *     server side of the page CANNOT be moved to meet the winner.
+ *   - the WINNER, viewport 1 of the source page, which came from a local image
+ *     provider or an upload and is whatever size that produced. Measured across
+ *     the 0.2.14 harness pass: 1672x941, 864x1821, 853x1844, 1024x1536, and in
+ *     one run 1536x1024 — the only run whose page could have converted.
+ *
+ * So the canonical width is the server's, read off the screens it actually
+ * produced, and the local image is the one that moves. That is a declared fact
+ * on both sides rather than a tuned guess: the width is measured from the
+ * delivered pixels the package validator will itself inspect.
+ *
+ * Only the width is reconciled. Heights differ on purpose — a page is a stack
+ * of viewports of different depths — so the resize preserves aspect ratio and
+ * the viewport simply becomes as tall as that width implies.
+ */
+/** The joined page must still fit the LayerDoc canvas and source-pixel limits. */
+export declare const MAX_JOINED_PAGE_SIDE = 10000;
+export declare const MAX_JOINED_PAGE_PIXELS = 8000000;
+export type ViewportImage = {
+    id: string;
+    bytes: Uint8Array;
+    mediaType: 'image/png' | 'image/jpeg' | 'image/webp';
+    width: number;
+    height: number;
+    /** True for a screen the server drew: it defines the page's canonical width. */
+    canonical: boolean;
+};
+export type NormalizedViewportImage = ViewportImage & {
+    sha256: string;
+    normalized: boolean;
+    original?: {
+        width: number;
+        height: number;
+        sha256: string;
+        bytes: number;
+    };
+};
+export declare const digestOf: (bytes: Uint8Array) => string;
+/**
+ * The width every viewport of this page is reconciled to: the width the server
+ * drew its screens at. With no server screen on the page there is nothing to
+ * reconcile and the page keeps the width it already has.
+ */
+export declare const canonicalPageWidth: (viewports: readonly ViewportImage[]) => number | null;
+export type PageNormalization = {
+    canonicalWidth: number | null;
+    /** True when the page was narrowed below the server's canvas to fit a limit. */
+    fitted: boolean;
+    viewports: NormalizedViewportImage[];
+    /** Ids that were resized, for the run record and the report. */
+    normalizedIds: string[];
+};
+/**
+ * The widest the page may be and still join inside both limits.
+ *
+ * Every viewport scales with the page, so the joined height is `width * K`
+ * where K is the sum of the viewports' height/width ratios. That makes the
+ * pixel limit `width² * K <= P` and the side limit `width * K <= S`, both
+ * solvable directly. Shrinking the whole page keeps it convertible and keeps
+ * every viewport in proportion; refusing would hand back nothing, and a tall
+ * approved screen stacked over three continuations is a shape the harness
+ * actually produced (864x1821 over three 1536x1024 screens is 9.7M pixels).
+ */
+export declare const widthThatFits: (requested: number, viewports: readonly ViewportImage[]) => number;
+export declare const normalizePageViewports: (viewports: readonly ViewportImage[]) => Promise<PageNormalization>;
+//# sourceMappingURL=branch-viewport-normalization.d.ts.map

package/dist/branch-viewport-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-viewport-normalization.d.ts","sourceRoot":"","sources":["../src/branch-viewport-normalization.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAC3C,eAAO,MAAM,sBAAsB,UAAY,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,aAAa,GAAG;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,OAAO,UAAU,KAAG,MAE5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,WAAW,SAAS,aAAa,EAAE,KAAG,MAAM,GAAG,IAYjF,CAAC;AAoCF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gFAAgF;IAChF,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,uBAAuB,EAAE,CAAC;IACrC,gEAAgE;IAChE,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,GACxB,WAAW,MAAM,EACjB,WAAW,SAAS,aAAa,EAAE,KAClC,MASF,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,WAAW,SAAS,aAAa,EAAE,KAClC,OAAO,CAAC,iBAAiB,CAuB3B,CAAC"}

package/dist/branch-viewport-normalization.js

@@ -0,0 +1,120 @@
+import { createHash } from 'node:crypto';
+import sharp from 'sharp';
+import { readImageDimensions } from './image-dimensions.js';
+/**
+ * One page stacks into one tall source, so every viewport of it must share one
+ * width. Branch pages mix two origins that cannot agree on their own:
+ *
+ *   - the CONTINUATION screens, drawn by the server on a canvas fixed by the
+ *     run's aspect (`CREATE_ASPECT_SIZES`, 1536x1024 for landscape). The build
+ *     claim accepts `source`, `concept`, `aspect`, `winner` and
+ *     `referenceImage` and nothing else — there is no width parameter — so the
+ *     server side of the page CANNOT be moved to meet the winner.
+ *   - the WINNER, viewport 1 of the source page, which came from a local image
+ *     provider or an upload and is whatever size that produced. Measured across
+ *     the 0.2.14 harness pass: 1672x941, 864x1821, 853x1844, 1024x1536, and in
+ *     one run 1536x1024 — the only run whose page could have converted.
+ *
+ * So the canonical width is the server's, read off the screens it actually
+ * produced, and the local image is the one that moves. That is a declared fact
+ * on both sides rather than a tuned guess: the width is measured from the
+ * delivered pixels the package validator will itself inspect.
+ *
+ * Only the width is reconciled. Heights differ on purpose — a page is a stack
+ * of viewports of different depths — so the resize preserves aspect ratio and
+ * the viewport simply becomes as tall as that width implies.
+ */
+/** The joined page must still fit the LayerDoc canvas and source-pixel limits. */
+export const MAX_JOINED_PAGE_SIDE = 10_000;
+export const MAX_JOINED_PAGE_PIXELS = 8_000_000;
+export const digestOf = (bytes) => (createHash('sha256').update(bytes).digest('hex'));
+/**
+ * The width every viewport of this page is reconciled to: the width the server
+ * drew its screens at. With no server screen on the page there is nothing to
+ * reconcile and the page keeps the width it already has.
+ */
+export const canonicalPageWidth = (viewports) => {
+    const declared = viewports.filter((viewport) => viewport.canonical);
+    if (declared.length === 0)
+        return null;
+    const widths = new Set(declared.map((viewport) => viewport.width));
+    if (widths.size > 1) {
+        throw new Error(`The generated screens of this page disagree on their own width (${[...widths].sort().join(', ')}px).`
+            + ' That is a server-side contradiction, not something the client may resize around;'
+            + ' report the run id rather than reconciling it here.');
+    }
+    return declared[0].width;
+};
+const resizeToWidth = async (viewport, width) => {
+    const height = Math.max(1, Math.round(viewport.height * width / viewport.width));
+    const pipeline = sharp(viewport.bytes, { animated: false, failOn: 'warning' })
+        .autoOrient()
+        .resize({ width, height, fit: 'fill', kernel: sharp.kernel.lanczos3 });
+    const encoded = viewport.mediaType === 'image/jpeg'
+        ? pipeline.jpeg({ quality: 95 })
+        : viewport.mediaType === 'image/webp'
+            ? pipeline.webp({ quality: 95 })
+            : pipeline.png();
+    const bytes = new Uint8Array(await encoded.toBuffer());
+    const actual = await readImageDimensions(bytes);
+    if (actual.width !== width) {
+        throw new Error(`Viewport ${viewport.id} could not be normalized to ${width}px`);
+    }
+    return {
+        ...viewport,
+        bytes,
+        width: actual.width,
+        height: actual.height,
+        sha256: digestOf(bytes),
+        normalized: true,
+        original: {
+            width: viewport.width,
+            height: viewport.height,
+            sha256: digestOf(viewport.bytes),
+            bytes: viewport.bytes.byteLength,
+        },
+    };
+};
+/**
+ * The widest the page may be and still join inside both limits.
+ *
+ * Every viewport scales with the page, so the joined height is `width * K`
+ * where K is the sum of the viewports' height/width ratios. That makes the
+ * pixel limit `width² * K <= P` and the side limit `width * K <= S`, both
+ * solvable directly. Shrinking the whole page keeps it convertible and keeps
+ * every viewport in proportion; refusing would hand back nothing, and a tall
+ * approved screen stacked over three continuations is a shape the harness
+ * actually produced (864x1821 over three 1536x1024 screens is 9.7M pixels).
+ */
+export const widthThatFits = (requested, viewports) => {
+    if (viewports.length < 2)
+        return requested;
+    const ratio = viewports.reduce((total, viewport) => total + viewport.height / viewport.width, 0);
+    if (ratio <= 0)
+        return requested;
+    return Math.max(1, Math.min(requested, Math.floor(Math.sqrt(MAX_JOINED_PAGE_PIXELS / ratio)), Math.floor(MAX_JOINED_PAGE_SIDE / ratio)));
+};
+export const normalizePageViewports = async (viewports) => {
+    const declared = canonicalPageWidth(viewports);
+    // With no server screen there is nothing to reconcile to, so the page keeps
+    // the width it has — but it must still fit, so the limit still applies.
+    const requested = declared ?? viewports[0]?.width ?? 0;
+    const canonicalWidth = widthThatFits(requested, viewports);
+    const resolved = await Promise.all(viewports.map(async (viewport) => {
+        if (canonicalWidth === 0 || viewport.width === canonicalWidth) {
+            return {
+                ...viewport,
+                sha256: digestOf(viewport.bytes),
+                normalized: false,
+            };
+        }
+        return resizeToWidth(viewport, canonicalWidth);
+    }));
+    return {
+        canonicalWidth: canonicalWidth === 0 ? null : canonicalWidth,
+        fitted: canonicalWidth < requested,
+        viewports: resolved,
+        normalizedIds: resolved.filter((viewport) => viewport.normalized).map((viewport) => viewport.id),
+    };
+};
+//# sourceMappingURL=branch-viewport-normalization.js.map

package/dist/branch-viewport-normalization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-viewport-normalization.js","sourceRoot":"","sources":["../src/branch-viewport-normalization.ts"],"names":[],"mappings":"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"}

package/dist/cli-arguments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-arguments.d.ts","sourceRoot":"","sources":["../src/cli-arguments.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAYrD,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EAAE,KACb;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAqBtC,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,QAAQ,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SAGnE,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,QAAQ,EAAE,MAAM,MAAM,KAAG,OAA+B,CAAC"}
+{"version":3,"file":"cli-arguments.d.ts","sourceRoot":"","sources":["../src/cli-arguments.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAiBrD,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EAAE,KACb;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAqBtC,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,QAAQ,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SAGnE,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,QAAQ,EAAE,MAAM,MAAM,KAAG,OAA+B,CAAC"}

package/dist/cli-arguments.js

@@ -1,11 +1,16 @@
+// Every value-less flag must be listed here or the parser swallows the next
+// token as its value.
 const booleanFlags = new Set([
     'detach',
+    'dry-run',
     'force',
     'help',
     'json',
     'quiet',
+    'resume',
     'skip-auth',
     'version',
+    'wait',
 ]);
 export const parseCliArguments = (argv) => {
     const command = [];

package/dist/cli-arguments.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-arguments.js","sourceRoot":"","sources":["../src/cli-arguments.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,QAAQ;IACR,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,WAAW;IACX,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAc,EAC0B,EAAE;IAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,IAAI,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACjD,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACnB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,KAAK,IAAI,mBAAmB,CAAC,CAAC;QAClF,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAe,EAAE,IAAY,EAAsB,EAAE;IAC9E,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAe,EAAE,IAAY,EAAW,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC"}
+{"version":3,"file":"cli-arguments.js","sourceRoot":"","sources":["../src/cli-arguments.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,sBAAsB;AACtB,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,QAAQ;IACR,SAAS;IACT,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,WAAW;IACX,SAAS;IACT,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAc,EAC0B,EAAE;IAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,IAAI,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACjD,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACnB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,KAAK,IAAI,mBAAmB,CAAC,CAAC;QAClF,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAe,EAAE,IAAY,EAAsB,EAAE;IAC9E,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAe,EAAE,IAAY,EAAW,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC"}

package/dist/cli-branch-command.d.ts

@@ -0,0 +1,46 @@
+import { type CliFlags } from './cli-arguments.js';
+import { readConversionConfig } from './config.js';
+import { TwelveUiBranchClient } from './branch-client.js';
+import { TwelveUiConversionPackageClient } from './package-client.js';
+export declare const BRANCH_USAGE = "Usage:\n  12ui branch execute --winner-run <crt-id> --winner-slot <slot>|--winner-image <file>\n                      --concept <text>|--concept-file <file> --scope page|site\n                      --out-dir <directory> [--convert html] [--convert-model fast|standard|pro]\n                      [--convert-quality standard|pro] [--source-conversion-id <id>]\n                      [--max-screens <n>] [--idempotency-key <key>] [--resume] [--dry-run]\n                      [--wait] [--quiet] [--origin <url>] [--api-key <key>]\n  12ui branch resume  --out-dir <directory> [--quiet] [--origin <url>] [--api-key <key>]\n  12ui branch status  --out-dir <directory> [--json] [--origin <url>] [--api-key <key>]";
+/**
+ * `.12ui/site/.12ui/site/candidates/D.png` — measured in the harness pass, from
+ * an agent that resolved the run-directory convention against a cwd that was
+ * already inside it. The path is real, so nothing fails; the run just scatters.
+ * Say so once rather than refusing work over a cosmetic mistake.
+ */
+export declare const nestedRunDirectoryWarning: (target: string) => string | null;
+export type ResolvedBranchDirectory = {
+    /** Where this branch run's own records live. */
+    branchDir: string;
+    /** The draft run directory it belongs to, when there is one. */
+    runDir: string | null;
+};
+/**
+ * `12ui branch execute <run-dir>` takes the DRAFT run directory and keeps its
+ * own records in `<run-dir>/branch`, which is where the skill says the pages
+ * land. `--out-dir` stays an alias that names the branch directory outright,
+ * for a branch run with no draft behind it.
+ *
+ * `branch status` accepts either spelling: a directory that already holds
+ * branch records is one, and otherwise `<dir>/branch` is tried, so a caller who
+ * passes the run directory and one who passes the branch directory both get an
+ * answer instead of a lecture.
+ */
+export declare const resolveBranchDirectory: (args: {
+    runDirArgument?: string;
+    outDirFlag?: string;
+}) => Promise<ResolvedBranchDirectory>;
+export declare const branchExecuteBanner: (args: {
+    scope: "page" | "site";
+    outDir: string;
+    convert: boolean;
+}) => string;
+export declare const runBranchCommand: (action: string | undefined, flags: CliFlags, dependencies?: {
+    readConfig?: typeof readConversionConfig;
+    createBranchClient?: (config: ReturnType<typeof readConversionConfig>) => TwelveUiBranchClient;
+    createPackageClient?: (config: ReturnType<typeof readConversionConfig>) => TwelveUiConversionPackageClient;
+    /** The positional `<run-dir>` from `12ui branch execute <run-dir>`. */
+    runDirArgument?: string;
+}) => Promise<void>;
+//# sourceMappingURL=cli-branch-command.d.ts.map

package/dist/cli-branch-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-branch-command.d.ts","sourceRoot":"","sources":["../src/cli-branch-command.ts"],"names":[],"mappings":"AAIA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAoD,MAAM,oBAAoB,CAAC;AAqB5G,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAMtE,eAAO,MAAM,YAAY,usBAQ+D,CAAC;AAIzF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,IAOnE,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GAAU,MAAM;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,KAAG,OAAO,CAAC,uBAAuB,CAuBlC,CAAC;AAgIF,eAAO,MAAM,mBAAmB,GAAI,MAAM;IACxC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB,KAAG,MAeH,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,MAAM,GAAG,SAAS,EAC1B,OAAO,QAAQ,EACf,eAAc;IACZ,UAAU,CAAC,EAAE,OAAO,oBAAoB,CAAC;IACzC,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,KAAK,oBAAoB,CAAC;IAC/F,mBAAmB,CAAC,EAAE,CACpB,MAAM,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,KAC5C,+BAA+B,CAAC;IACrC,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,KACL,OAAO,CAAC,IAAI,CAwNd,CAAC"}