@hexpro/qr-code-studio 0.0.0-stage → 0.1.1

package/dist/studio/kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../../src/studio/kit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAoB,UAAU,EAAe,MAAM,oBAAoB,CAAC;AAGpF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,gFAAgF;AAChF,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,+DAA+D;AAC/D,eAAO,MAAM,eAAe,KAAK,CAAC;AAalC,0GAA0G;AAC1G,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,GAAG,UAAU,CAsCtE;AAaD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAgB1D"}

package/dist/studio/kit.js

@@ -0,0 +1,114 @@
+/**
+ * A brand kit applied to a design, and a kit made from one.
+ *
+ * A kit is a palette, perhaps a logo, and the presets the brand prefers. The
+ * palette is a set of colours with no roles, so applying it has to decide
+ * which colour goes where, and has to keep the code readable while it does.
+ * The rule, in order:
+ *
+ * 1. The ground. The kit's lightest ink becomes the background when it is
+ *    pale enough to be one (relative luminance 0.8 or more, about the
+ *    lightness of a pale tint). Otherwise the design keeps its own ground.
+ * 2. The modules. The kit's darkest ink becomes the module colour when it
+ *    stands at 4.5:1 or more against the ground, the floor every preset is
+ *    held to. Otherwise the modules keep their own colour, because a brand
+ *    colour that does not read is worse than no brand colour.
+ * 3. The finder rings. The next darkest ink that also clears 4.5:1 becomes
+ *    the colour of the three corner rings, the one place a second brand
+ *    colour shows without costing the data modules anything. Without one the
+ *    rings follow the modules. A design with no finder style of its own gets
+ *    the plain square ring and centre, the pair every reader finds.
+ * 4. The logo. A kit with a picture logo puts it in the middle, keeping the
+ *    size and clearing the design already had.
+ *
+ * Contrast is judged against the ground's own colour when it is a solid
+ * ink, and against white otherwise (a gradient, a fill, or no ground, which
+ * is paper). The kit's presets are not applied: they are offered, first,
+ * beside the rest (`snapshot.library.kit`).
+ */
+import { contrastRatio, luminance } from './contrast.js';
+import { LOGO_ASSET_ID } from './logo.js';
+/** The luminance at or above which a kit ink can be a ground. */
+export const KIT_GROUND_LUMINANCE = 0.8;
+/** The contrast a kit ink needs against the ground to draw modules or rings. */
+export const KIT_CONTRAST = 4.5;
+/** The most inks a kit holds, as both library stores allow. */
+export const KIT_PALETTE_MAX = 32;
+const WHITE = '#ffffff';
+function solid(ink) {
+    return { kind: 'solid', ink };
+}
+/** The ink a paint is judged against: its own when it is solid, white otherwise. */
+function groundInk(paint) {
+    return paint !== null && paint.kind === 'solid' ? paint.ink : WHITE;
+}
+/** The design with `kit` applied by the rule above. The person's own logo stays when the kit has none. */
+export function applyKit(design, kit) {
+    const inks = [...kit.palette].sort((a, b) => luminance(a) - luminance(b));
+    let out = design;
+    const lightest = inks[inks.length - 1];
+    if (lightest !== undefined && luminance(lightest) >= KIT_GROUND_LUMINANCE) {
+        out = { ...out, background: solid(lightest) };
+    }
+    const ground = groundInk(out.background);
+    const readable = inks.filter((ink) => luminance(ink) < luminance(ground) && contrastRatio(ink, ground) >= KIT_CONTRAST);
+    const [modules, rings] = readable;
+    if (modules !== undefined) {
+        out = { ...out, modules: { ...out.modules, paint: solid(modules) } };
+    }
+    if (rings !== undefined) {
+        const style = out.regions.finder ?? {
+            outer: { id: 'square' },
+            inner: { id: 'square-centre' },
+        };
+        out = { ...out, regions: { ...out.regions, finder: { ...style, outerPaint: solid(rings) } } };
+    }
+    if (kit.logo !== null) {
+        const current = out.logo;
+        out = {
+            ...out,
+            logo: {
+                size: current?.size ?? 0.2,
+                clear: current?.clear ?? 'box',
+                padding: current?.padding ?? 1,
+                plate: current?.plate ?? null,
+                source: { kind: 'asset', id: LOGO_ASSET_ID },
+            },
+            assets: { [LOGO_ASSET_ID]: kit.logo },
+        };
+    }
+    return out;
+}
+/** Every solid ink a paint puts down, gradient stops included; an entry fill's are its own business. */
+function inksOf(paint) {
+    if (paint === null || paint === undefined || paint.kind === 'entry')
+        return [];
+    if (paint.kind === 'solid')
+        return [paint.ink];
+    return paint.stops.map((stop) => stop.ink);
+}
+function sameInk(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+/**
+ * A kit made from a design, for "Save as brand kit": its inks, its picture
+ * logo, and no presets, which the person chooses.
+ */
+export function kitFromDesign(design) {
+    const found = [
+        ...inksOf(design.modules.paint),
+        ...inksOf(design.regions.finder?.outerPaint),
+        ...inksOf(design.regions.finder?.innerPaint),
+        ...inksOf(design.background),
+    ];
+    const palette = [];
+    for (const ink of found) {
+        if (palette.length < KIT_PALETTE_MAX && !palette.some((kept) => sameInk(kept, ink))) {
+            palette.push(ink);
+        }
+    }
+    const source = design.logo?.source;
+    const logo = source?.kind === 'asset' ? (design.assets?.[source.id] ?? null) : null;
+    return Object.freeze({ palette: Object.freeze(palette), logo, presets: Object.freeze([]) });
+}
+//# sourceMappingURL=kit.js.map

package/dist/studio/kit.js.map

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

package/dist/studio/logo.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Putting a picture in the middle of the code.
+ *
+ * A picture logo is two changes to a design, the embedded image and the logo
+ * that names it, and they have to land together: the validator drops an
+ * image nothing uses, and refuses a logo that names an image the design does
+ * not hold. So the studio takes them as one `design/patch` with both, and
+ * this builds it. The dom layer's `importLogo` makes the asset.
+ */
+import type { DesignAsset, QrDesignV1 } from '../design/types.js';
+import type { DesignPatch } from './seams.js';
+/** The id a picture logo is stored under. One logo per design, so one id. */
+export declare const LOGO_ASSET_ID = "logo";
+/** The largest logo picture a design holds, in pixels a side, as the validator allows. */
+export declare const LOGO_MAX_SIDE: 1024;
+/** The most bytes of PNG a logo picture may be, as the validator allows. */
+export declare const LOGO_MAX_BYTES: number;
+/**
+ * The patches that put `asset` in as the design's logo, keeping the size,
+ * clearing and plate of a logo it already has.
+ */
+export declare function logoPatches(design: QrDesignV1, asset: DesignAsset): readonly DesignPatch[];
+/** The patches that take the logo out, picture and all. */
+export declare function removeLogoPatches(design: QrDesignV1): readonly DesignPatch[];
+//# sourceMappingURL=logo.d.ts.map

package/dist/studio/logo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.d.ts","sourceRoot":"","sources":["../../src/studio/logo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAc,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,6EAA6E;AAC7E,eAAO,MAAM,aAAa,SAAS,CAAC;AAEpC,0FAA0F;AAC1F,eAAO,MAAM,aAAa,MAAmB,CAAC;AAC9C,4EAA4E;AAC5E,eAAO,MAAM,cAAc,QAAoB,CAAC;AAUhD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,SAAS,WAAW,EAAE,CAa1F;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,WAAW,EAAE,CAI5E"}

package/dist/studio/logo.js

@@ -0,0 +1,49 @@
+/**
+ * Putting a picture in the middle of the code.
+ *
+ * A picture logo is two changes to a design, the embedded image and the logo
+ * that names it, and they have to land together: the validator drops an
+ * image nothing uses, and refuses a logo that names an image the design does
+ * not hold. So the studio takes them as one `design/patch` with both, and
+ * this builds it. The dom layer's `importLogo` makes the asset.
+ */
+import { LIMITS } from '../design/document.js';
+/** The id a picture logo is stored under. One logo per design, so one id. */
+export const LOGO_ASSET_ID = 'logo';
+/** The largest logo picture a design holds, in pixels a side, as the validator allows. */
+export const LOGO_MAX_SIDE = LIMITS.assetSide;
+/** The most bytes of PNG a logo picture may be, as the validator allows. */
+export const LOGO_MAX_BYTES = LIMITS.assetBytes;
+/** Where a new logo starts: a fifth of the symbol across, a module of clear space round it. */
+const DEFAULT_LOGO = Object.freeze({
+    size: 0.2,
+    clear: 'box',
+    padding: 1,
+    plate: null,
+});
+/**
+ * The patches that put `asset` in as the design's logo, keeping the size,
+ * clearing and plate of a logo it already has.
+ */
+export function logoPatches(design, asset) {
+    const current = design.logo;
+    const logo = {
+        size: current?.size ?? DEFAULT_LOGO.size,
+        clear: current?.clear ?? DEFAULT_LOGO.clear,
+        padding: current?.padding ?? DEFAULT_LOGO.padding,
+        plate: current?.plate ?? DEFAULT_LOGO.plate,
+        source: { kind: 'asset', id: LOGO_ASSET_ID },
+    };
+    return Object.freeze([
+        { path: ['assets', LOGO_ASSET_ID], value: asset },
+        { path: ['logo'], value: logo },
+    ]);
+}
+/** The patches that take the logo out, picture and all. */
+export function removeLogoPatches(design) {
+    const patches = [{ path: ['logo'], value: null }];
+    if (design.assets !== undefined)
+        patches.push({ path: ['assets'], value: undefined });
+    return Object.freeze(patches);
+}
+//# sourceMappingURL=logo.js.map

package/dist/studio/logo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.js","sourceRoot":"","sources":["../../src/studio/logo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAI/C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AAEpC,0FAA0F;AAC1F,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC;AAC9C,4EAA4E;AAC5E,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC;AAEhD,+FAA+F;AAC/F,MAAM,YAAY,GAA+B,MAAM,CAAC,MAAM,CAAC;IAC9D,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,KAAK;IACZ,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,IAAI;CACX,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAkB,EAAE,KAAkB;IACjE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;IAC5B,MAAM,IAAI,GAAe;QACxB,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,YAAY,CAAC,IAAI;QACxC,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,YAAY,CAAC,KAAK;QAC3C,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,YAAY,CAAC,OAAO;QACjD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,YAAY,CAAC,KAAK;QAC3C,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa,EAAE;KAC5C,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACpB,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE;QACjD,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE;KAC/B,CAAC,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IACnD,MAAM,OAAO,GAAkB,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACtF,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/studio/names.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The file name an export is saved under.
+ *
+ * Never the content. A code's file name is the one piece of it that shows in
+ * a downloads list, a shared folder and an email attachment, and a name made
+ * from a Wi-Fi password or a private link would publish exactly what the code
+ * was made to keep. So a name comes from the design's own name, which the
+ * person gave it to tell their designs apart, or is the generic
+ * `qr-code.<ext>`.
+ */
+/**
+ * A file stem from a design's name: letters and digits of any script, with
+ * spaces, hyphens and underscores between them, and nothing a file system or
+ * a shell would read as structure.
+ */
+export declare function fileStem(name: string | undefined): string;
+export declare function exportName(name: string | undefined, extension: string): string;
+//# sourceMappingURL=names.d.ts.map

package/dist/studio/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../src/studio/names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAYzD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E"}

package/dist/studio/names.js

@@ -0,0 +1,36 @@
+/**
+ * The file name an export is saved under.
+ *
+ * Never the content. A code's file name is the one piece of it that shows in
+ * a downloads list, a shared folder and an email attachment, and a name made
+ * from a Wi-Fi password or a private link would publish exactly what the code
+ * was made to keep. So a name comes from the design's own name, which the
+ * person gave it to tell their designs apart, or is the generic
+ * `qr-code.<ext>`.
+ */
+const GENERIC = 'qr-code';
+/** Characters kept from a design's name; long enough to tell designs apart. */
+const MAX_STEM = 64;
+/**
+ * A file stem from a design's name: letters and digits of any script, with
+ * spaces, hyphens and underscores between them, and nothing a file system or
+ * a shell would read as structure.
+ */
+export function fileStem(name) {
+    if (typeof name !== 'string')
+        return GENERIC;
+    const cleaned = name
+        .normalize('NFC')
+        // Path separators, the characters Windows reserves, controls and
+        // punctuation all become a space, so "A/B" is "A B" rather than "AB".
+        .replace(/[^\p{L}\p{N} _-]+/gu, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .replace(/^[-_ .]+|[-_ .]+$/g, '');
+    const stem = [...cleaned].slice(0, MAX_STEM).join('').trim();
+    return stem === '' ? GENERIC : stem;
+}
+export function exportName(name, extension) {
+    return `${fileStem(name)}.${extension}`;
+}
+//# sourceMappingURL=names.js.map

package/dist/studio/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../src/studio/names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,OAAO,GAAG,SAAS,CAAC;AAC1B,+EAA+E;AAC/E,MAAM,QAAQ,GAAG,EAAE,CAAC;AAEpB;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAwB;IAChD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI;SAClB,SAAS,CAAC,KAAK,CAAC;QACjB,iEAAiE;QACjE,sEAAsE;SACrE,OAAO,CAAC,qBAAqB,EAAE,GAAG,CAAC;SACnC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE;SACN,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAwB,EAAE,SAAiB;IACrE,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;AACzC,CAAC"}

package/dist/studio/patch.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Applying a path-addressed patch to a plain value.
+ *
+ * `{ path: ['modules', 'shape'], value: { id: 'dot' } }` replaces one part of
+ * a design, and an empty path the whole of it, as verify's `applyDesignPatch`
+ * reads a patch. It copies only the objects on the way down, so everything
+ * beside the path keeps its identity. A missing step on the way is created,
+ * an object for a string key and an array for a number, and a value of
+ * `undefined` removes the key. Whether the result is a good design is the
+ * validator's question; this only refuses paths no design could have, so a
+ * patch can never reach an object's prototype.
+ */
+/** Why a path cannot be applied, or null when it can. */
+export declare function pathProblem(path: unknown): 'shape' | 'key' | null;
+/** `target` with `value` at `path`. Call only with a path `pathProblem` accepts. */
+export declare function applyPatch(target: unknown, path: readonly (string | number)[], value: unknown): unknown;
+//# sourceMappingURL=patch.d.ts.map

package/dist/studio/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../src/studio/patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,IAAI,CAajE;AA8BD,oFAAoF;AACpF,wBAAgB,UAAU,CACzB,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAClC,KAAK,EAAE,OAAO,GACZ,OAAO,CAET"}

package/dist/studio/patch.js

@@ -0,0 +1,64 @@
+/**
+ * Applying a path-addressed patch to a plain value.
+ *
+ * `{ path: ['modules', 'shape'], value: { id: 'dot' } }` replaces one part of
+ * a design, and an empty path the whole of it, as verify's `applyDesignPatch`
+ * reads a patch. It copies only the objects on the way down, so everything
+ * beside the path keeps its identity. A missing step on the way is created,
+ * an object for a string key and an array for a number, and a value of
+ * `undefined` removes the key. Whether the result is a good design is the
+ * validator's question; this only refuses paths no design could have, so a
+ * patch can never reach an object's prototype.
+ */
+const FORBIDDEN_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+/** Deeper than any design goes; a longer path is a mistake or an attack. */
+const MAX_DEPTH = 16;
+/** Why a path cannot be applied, or null when it can. */
+export function pathProblem(path) {
+    // An empty path is the whole design, as verify's applyDesignPatch reads one.
+    if (!Array.isArray(path) || path.length > MAX_DEPTH)
+        return 'shape';
+    for (const step of path) {
+        if (typeof step === 'number') {
+            if (!Number.isInteger(step) || step < 0 || step > 1024)
+                return 'shape';
+        }
+        else if (typeof step !== 'string' || step.length === 0 || step.length > 64) {
+            return 'shape';
+        }
+        else if (FORBIDDEN_KEYS.has(step)) {
+            return 'key';
+        }
+    }
+    return null;
+}
+function setAt(target, path, at, value) {
+    const step = path[at];
+    const container = Array.isArray(target)
+        ? [...target]
+        : typeof target === 'object' && target !== null
+            ? { ...target }
+            : typeof step === 'number'
+                ? []
+                : {};
+    const record = container;
+    if (at === path.length - 1) {
+        if (value === undefined) {
+            if (Array.isArray(container))
+                container.splice(step, 1);
+            else
+                delete record[step];
+        }
+        else {
+            record[step] = value;
+        }
+        return container;
+    }
+    record[step] = setAt(record[step], path, at + 1, value);
+    return container;
+}
+/** `target` with `value` at `path`. Call only with a path `pathProblem` accepts. */
+export function applyPatch(target, path, value) {
+    return path.length === 0 ? value : setAt(target, path, 0, value);
+}
+//# sourceMappingURL=patch.js.map

package/dist/studio/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../src/studio/patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AAC1E,4EAA4E;AAC5E,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,yDAAyD;AACzD,MAAM,UAAU,WAAW,CAAC,IAAa;IACxC,6EAA6E;IAC7E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS;QAAE,OAAO,OAAO,CAAC;IACpE,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,IAAI;gBAAE,OAAO,OAAO,CAAC;QACxE,CAAC;aAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC9E,OAAO,OAAO,CAAC;QAChB,CAAC;aAAM,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,KAAK,CACb,MAAe,EACf,IAAkC,EAClC,EAAU,EACV,KAAc;IAEd,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAoB,CAAC;IACzC,MAAM,SAAS,GAAiD,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACpF,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;QACb,CAAC,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAC9C,CAAC,CAAC,EAAE,GAAI,MAAkC,EAAE;YAC5C,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ;gBACzB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,CAAC;IACR,MAAM,MAAM,GAAG,SAA6C,CAAC;IAC7D,IAAI,EAAE,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;gBAAE,SAAS,CAAC,MAAM,CAAC,IAAc,EAAE,CAAC,CAAC,CAAC;;gBAC7D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;QACD,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IACxD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,UAAU,CACzB,MAAe,EACf,IAAkC,EAClC,KAAc;IAEd,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;AAClE,CAAC"}

package/dist/studio/seams.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The layers the studio drives through a seam a caller can replace: the
+ * scan check (verify), the inspector and the print writers.
+ *
+ * Their types are the layers' own; the seams are the shapes a caller passes
+ * in when it wants something else in their place. The website runs the scan
+ * check in a module worker of its own and passes a `VerifyRunner`; a test
+ * passes fakes; and by default the studio uses the layers themselves.
+ */
+import type { Result } from '../core/result.js';
+import type { RgbaImage } from '../core/image.js';
+import type { QrDesignV1 } from '../design/types.js';
+import type { DecodeOptions, Point } from '../decode/types.js';
+import type { InspectReport } from '../inspect/types.js';
+import type { EpsOptions } from '../render/eps.js';
+import type { PdfOptions } from '../render/pdf.js';
+import type { Scene } from '../render/types.js';
+import type { Registries } from '../registries.js';
+import type { CaptureAxis, CheckId, Fix, VerifyJob, VerifyProgress, VerifyReport } from '../verify/types.js';
+export declare const CAPTURE_AXES: readonly CaptureAxis[];
+export declare const CHECK_IDS: readonly CheckId[];
+/** Runs one job to its report. The website's runs it in a worker; the default runs the generator here. */
+export interface VerifyRunner {
+    run(job: VerifyJob, signal: AbortSignal, progress: (p: VerifyProgress) => void): Promise<Result<VerifyReport>>;
+}
+/** verify's `runVerifyJob`, the generator a runner drives one capture at a time. */
+export type VerifyGenerator = (job: VerifyJob, registries: Registries) => Generator<VerifyProgress, VerifyReport>;
+/** verify's `suggestFixes`, over the design registries the studio was given. */
+export type FixSuggester = (report: VerifyReport, design: QrDesignV1) => readonly Fix[];
+/** inspect's `inspectImage` and `inspectText`, together. */
+export interface Inspector {
+    image(image: RgbaImage, registries: Registries, options?: DecodeOptions): Result<InspectReport>;
+    text(text: string, registries: Registries): InspectReport;
+}
+/** render's `sceneToPdf` and `sceneToEps`, together. */
+export interface Printer {
+    pdf(scene: Scene, options: PdfOptions): Uint8Array;
+    eps(scene: Scene, options: EpsOptions): string;
+}
+export type { DecodeOptions, EpsOptions, PdfOptions, Point };
+export type { BatchMapping, BatchOutcome, BatchOutput } from '../batch/types.js';
+export type { Gs1Element, InspectPayload, InspectReport, InspectSet, InspectedSymbol, } from '../inspect/types.js';
+export type { Baseline, CaptureAxis, CheckId, CheckStatus, DesignPatch, Fix, VerifyBlock, VerifyCapture, VerifyCheck, VerifyConditions, VerifyJob, VerifyProgress, VerifyReport, } from '../verify/types.js';
+//# sourceMappingURL=seams.d.ts.map

package/dist/studio/seams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seams.d.ts","sourceRoot":"","sources":["../../src/studio/seams.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EACX,WAAW,EACX,OAAO,EACP,GAAG,EACH,SAAS,EACT,cAAc,EACd,YAAY,EACZ,MAAM,oBAAoB,CAAC;AAc5B,eAAO,MAAM,YAAY,EAAE,SAAS,WAAW,EAE9C,CAAC;AAcF,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EAAoD,CAAC;AAE7F,0GAA0G;AAC1G,MAAM,WAAW,YAAY;IAC5B,GAAG,CACF,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,GACnC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;CACjC;AAED,oFAAoF;AACpF,MAAM,MAAM,eAAe,GAAG,CAC7B,GAAG,EAAE,SAAS,EACd,UAAU,EAAE,UAAU,KAClB,SAAS,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;AAE7C,gFAAgF;AAChF,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,KAAK,SAAS,GAAG,EAAE,CAAC;AAExF,4DAA4D;AAC5D,MAAM,WAAW,SAAS;IACzB,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IAChG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,aAAa,CAAC;CAC1D;AAED,wDAAwD;AACxD,MAAM,WAAW,OAAO;IACvB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,GAAG,UAAU,CAAC;IACnD,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC;CAC/C;AAED,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACjF,YAAY,EACX,UAAU,EACV,cAAc,EACd,aAAa,EACb,UAAU,EACV,eAAe,GACf,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,QAAQ,EACR,WAAW,EACX,OAAO,EACP,WAAW,EACX,WAAW,EACX,GAAG,EACH,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,YAAY,GACZ,MAAM,oBAAoB,CAAC"}

package/dist/studio/seams.js

@@ -0,0 +1,36 @@
+/**
+ * The layers the studio drives through a seam a caller can replace: the
+ * scan check (verify), the inspector and the print writers.
+ *
+ * Their types are the layers' own; the seams are the shapes a caller passes
+ * in when it wants something else in their place. The website runs the scan
+ * check in a module worker of its own and passes a `VerifyRunner`; a test
+ * passes fakes; and by default the studio uses the layers themselves.
+ */
+/** Every capture axis, for a view that labels them. Written as a record so a new axis fails to compile here. */
+const AXES = {
+    distance: true,
+    focus: true,
+    motion: true,
+    noise: true,
+    angle: true,
+    light: true,
+    glare: true,
+    ink: true,
+    contrast: true,
+};
+export const CAPTURE_AXES = Object.freeze(Object.keys(AXES));
+/** Every check id, for a view that names the rows. Written as a record for the same reason. */
+const CHECKS = {
+    'quiet-zone': true,
+    contrast: true,
+    polarity: true,
+    'function-patterns': true,
+    'logo-budget': true,
+    'module-size': true,
+    'finder-shape': true,
+    'colour-red-channel': true,
+    'reader-support': true,
+};
+export const CHECK_IDS = Object.freeze(Object.keys(CHECKS));
+//# sourceMappingURL=seams.js.map

package/dist/studio/seams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seams.js","sourceRoot":"","sources":["../../src/studio/seams.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH,gHAAgH;AAChH,MAAM,IAAI,GAAwC;IACjD,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;IACX,GAAG,EAAE,IAAI;IACT,QAAQ,EAAE,IAAI;CACd,CAAC;AACF,MAAM,CAAC,MAAM,YAAY,GAA2B,MAAM,CAAC,MAAM,CAChE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAkB,CAClC,CAAC;AAEF,+FAA+F;AAC/F,MAAM,MAAM,GAAoC;IAC/C,YAAY,EAAE,IAAI;IAClB,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,mBAAmB,EAAE,IAAI;IACzB,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,IAAI;IACnB,cAAc,EAAE,IAAI;IACpB,oBAAoB,EAAE,IAAI;IAC1B,gBAAgB,EAAE,IAAI;CACtB,CAAC;AACF,MAAM,CAAC,MAAM,SAAS,GAAuB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAc,CAAC,CAAC"}

package/dist/studio/share.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Structural sharing for plain JSON values.
+ *
+ * The validator hands back a fresh design every time it checks one, so a
+ * change to the logo would otherwise give a new `modules`, a new `regions`
+ * and a new everything, and every view memoised on any of them would draw
+ * again. `share` walks the new value against the old and keeps each old
+ * subtree that is equal, so only the path that really changed has new
+ * objects on it. Values are compared as JSON compares them: own enumerable
+ * keys in any order, arrays by position.
+ */
+/** Deep equality of two JSON values. */
+export declare function sameJson(a: unknown, b: unknown): boolean;
+/** `next`, with every subtree equal to the one at the same place in `previous` replaced by that one. */
+export declare function share<T>(previous: unknown, next: T): T;
+//# sourceMappingURL=share.d.ts.map

package/dist/studio/share.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.d.ts","sourceRoot":"","sources":["../../src/studio/share.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,wCAAwC;AACxC,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAkBxD;AAED,wGAAwG;AACxG,wBAAgB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAWtD"}

package/dist/studio/share.js

@@ -0,0 +1,57 @@
+/**
+ * Structural sharing for plain JSON values.
+ *
+ * The validator hands back a fresh design every time it checks one, so a
+ * change to the logo would otherwise give a new `modules`, a new `regions`
+ * and a new everything, and every view memoised on any of them would draw
+ * again. `share` walks the new value against the old and keeps each old
+ * subtree that is equal, so only the path that really changed has new
+ * objects on it. Values are compared as JSON compares them: own enumerable
+ * keys in any order, arrays by position.
+ */
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Deep equality of two JSON values. */
+export function sameJson(a, b) {
+    if (a === b)
+        return true;
+    if (Array.isArray(a)) {
+        if (!Array.isArray(b) || a.length !== b.length)
+            return false;
+        for (let i = 0; i < a.length; i += 1)
+            if (!sameJson(a[i], b[i]))
+                return false;
+        return true;
+    }
+    if (isPlainObject(a)) {
+        if (!isPlainObject(b))
+            return false;
+        const keys = Object.keys(a);
+        if (keys.length !== Object.keys(b).length)
+            return false;
+        for (const key of keys) {
+            if (!Object.prototype.hasOwnProperty.call(b, key) || !sameJson(a[key], b[key]))
+                return false;
+        }
+        return true;
+    }
+    // Distinct numbers, strings and booleans, or one of them against an object.
+    return false;
+}
+/** `next`, with every subtree equal to the one at the same place in `previous` replaced by that one. */
+export function share(previous, next) {
+    if (sameJson(previous, next))
+        return previous;
+    if (Array.isArray(next) && Array.isArray(previous)) {
+        return next.map((item, i) => share(previous[i], item));
+    }
+    if (isPlainObject(next) && isPlainObject(previous)) {
+        const out = {};
+        for (const key of Object.keys(next))
+            out[key] = share(previous[key], next[key]);
+        return out;
+    }
+    return next;
+}
+//# sourceMappingURL=share.js.map

package/dist/studio/share.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.js","sourceRoot":"","sources":["../../src/studio/share.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,SAAS,aAAa,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,QAAQ,CAAC,CAAU,EAAE,CAAU;IAC9C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC7D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;QAC9E,OAAO,IAAI,CAAC;IACb,CAAC;IACD,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACxD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;QAC9F,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IACD,4EAA4E;IAC5E,OAAO,KAAK,CAAC;AACd,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,KAAK,CAAI,QAAiB,EAAE,IAAO;IAClD,IAAI,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;QAAE,OAAO,QAAa,CAAC;IACnD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAM,CAAC;IAC7D,CAAC;IACD,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAChF,OAAO,GAAQ,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/studio/shuffle.d.ts

@@ -0,0 +1,38 @@
+/**
+ * A random design, from a seed, built only out of what the catalogue holds.
+ *
+ * "Shuffle" is a starting point, so it has to be a good one: every design it
+ * makes must scan as well as a preset does. Three rules hold that:
+ *
+ * - finders come only from ring and centre pairs that make a finder the
+ *   strict reader finds (`regionPairConforms`), at their default params,
+ *   and only with rings a reader that traces their sides follows
+ *   (`ringKindOf` is cornered): a round ring comes with a warning, which a
+ *   preset never has;
+ * - every dark ink is at least 7:1 against the ground by luminance, the
+ *   figure the presets aim for, where the conformance floor is 4.5:1. A
+ *   gradient between two such inks stays above it all the way along, because
+ *   luminance is convex in the sRGB values, so a mix is never lighter than
+ *   the lighter of its ends;
+ * - shapes keep their default params, which are the ones their own
+ *   conformance and the presets were measured at.
+ *
+ * Everything that is the person's rather than the look is kept: how the
+ * symbol is chosen (symbology, level, versions), the quiet zone, the logo
+ * and its picture, the output settings and the name. Micro QR and rMQR keep
+ * square rings, as the scene builder would draw them anyway.
+ *
+ * The same seed over the same registries gives the same design: the stream is
+ * core's seeded PRNG and every colour is worked out in basic arithmetic.
+ */
+import type { Prng } from '../core/prng.js';
+import type { DesignRegistries, QrDesignV1, RegionShape } from '../design/types.js';
+/** HSL (each 0 to 1) to #rrggbb, by the CSS Color 4 formula. */
+export declare function hslHex(h: number, s: number, l: number): string;
+/** A dark ink at 7:1 or more against `against`, or black when none of the tries is. */
+export declare function darkInk(prng: Prng, against: string): string;
+/** Every ring and centre that make a QR finder together at their default params. */
+export declare function conformingPairs(registries: DesignRegistries): readonly (readonly [RegionShape, RegionShape])[];
+/** The design for `seed`, keeping what in `base` is the person's rather than the look. */
+export declare function shuffleDesign(base: QrDesignV1, seed: number, registries: DesignRegistries, pairs?: readonly (readonly [RegionShape, RegionShape])[]): QrDesignV1;
+//# sourceMappingURL=shuffle.d.ts.map

package/dist/studio/shuffle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.d.ts","sourceRoot":"","sources":["../../src/studio/shuffle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,KAAK,EAEX,gBAAgB,EAEhB,UAAU,EACV,WAAW,EAEX,MAAM,oBAAoB,CAAC;AAc5B,gEAAgE;AAChE,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAO9D;AAgBD,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM3D;AA2CD,oFAAoF;AACpF,wBAAgB,eAAe,CAC9B,UAAU,EAAE,gBAAgB,GAC1B,SAAS,CAAC,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,EAAE,CAuBlD;AA2BD,0FAA0F;AAC1F,wBAAgB,aAAa,CAC5B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,gBAAgB,EAC5B,KAAK,GAAE,SAAS,CAAC,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,EAAgC,GACnF,UAAU,CAgCZ"}