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

package/dist/studio/shuffle.js

@@ -0,0 +1,181 @@
+/**
+ * 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 { createPrng } from '../core/prng.js';
+import { moduleFamilyOf, regionPairConforms, ringKindOf } from '../design/finder.js';
+import { resolveParams } from '../design/params.js';
+import { SHUFFLE_CONTRAST, contrastRatio } from './contrast.js';
+/** Fraction of shuffles that put a frame round the code. */
+const FRAME_CHANCE = 0.25;
+/** Tries at a colour before falling back to black, which always clears the bar. */
+const COLOUR_TRIES = 48;
+function hex(value) {
+    return Math.round(Math.min(255, Math.max(0, value)))
+        .toString(16)
+        .padStart(2, '0');
+}
+/** HSL (each 0 to 1) to #rrggbb, by the CSS Color 4 formula. */
+export function hslHex(h, s, l) {
+    const a = s * Math.min(l, 1 - l);
+    const channel = (n) => {
+        const k = (n + h * 12) % 12;
+        return (l - a * Math.max(-1, Math.min(k - 3, 9 - k, 1))) * 255;
+    };
+    return `#${hex(channel(0))}${hex(channel(8))}${hex(channel(4))}`;
+}
+function between(prng, min, max) {
+    return min + prng.next() * (max - min);
+}
+function pick(prng, list) {
+    return list[prng.int(list.length)];
+}
+/** A light ground: white two times in five, otherwise a pale tint. */
+function ground(prng) {
+    if (prng.next() < 0.4)
+        return '#ffffff';
+    return hslHex(prng.next(), between(prng, 0.2, 0.6), between(prng, 0.94, 0.985));
+}
+/** A dark ink at 7:1 or more against `against`, or black when none of the tries is. */
+export function darkInk(prng, against) {
+    for (let i = 0; i < COLOUR_TRIES; i += 1) {
+        const ink = hslHex(prng.next(), between(prng, 0.3, 0.9), between(prng, 0.06, 0.3));
+        if (contrastRatio(ink, against) >= SHUFFLE_CONTRAST)
+            return ink;
+    }
+    return '#000000';
+}
+function modulesPaint(prng, against, registries) {
+    const roll = prng.next();
+    const first = darkInk(prng, against);
+    if (roll < 0.5)
+        return { kind: 'solid', ink: first };
+    const second = darkInk(prng, against);
+    if (roll < 0.75) {
+        return {
+            kind: 'linear',
+            angle: prng.int(8) * 45,
+            space: 'symbol',
+            stops: [
+                { offset: 0, ink: first },
+                { offset: 1, ink: second },
+            ],
+        };
+    }
+    if (roll < 0.9) {
+        return {
+            kind: 'radial',
+            cx: 0.5,
+            cy: 0.5,
+            radius: 0.7,
+            space: 'symbol',
+            stops: [
+                { offset: 0, ink: first },
+                { offset: 1, ink: second },
+            ],
+        };
+    }
+    // An entry fill, with every colour parameter it has given a dark ink, so
+    // none of its defaults can come through untested.
+    const fills = registries.fills.list();
+    if (fills.length === 0)
+        return { kind: 'solid', ink: first };
+    const fill = pick(prng, fills);
+    const params = {};
+    for (const schema of fill.params) {
+        if (schema.kind === 'colour')
+            params[schema.key] = darkInk(prng, against);
+    }
+    return { kind: 'entry', ref: { id: fill.id, params } };
+}
+/** Every ring and centre that make a QR finder together at their default params. */
+export function conformingPairs(registries) {
+    const shapes = registries.regionShapes.list();
+    const rings = shapes.filter((s) => s.part === 'outer' && s.kinds.includes('concentric-7') && ringKindOf(s) === 'cornered');
+    const centres = shapes.filter((s) => s.part === 'inner' && s.kinds.includes('concentric-7'));
+    const pairs = [];
+    for (const ring of rings) {
+        for (const centre of centres) {
+            if (regionPairConforms(ring, resolveParams(ring.params, undefined), centre, resolveParams(centre.params, undefined), 'concentric-7')) {
+                pairs.push([ring, centre]);
+            }
+        }
+    }
+    return pairs;
+}
+function finderStyle(prng, base, pairs, against, family) {
+    const single = base.symbol.symbology !== 'qr';
+    // Only the pairs that read among this family of modules: `pairs` is the
+    // table among squares, which every other family's is a part of.
+    const read = pairs.filter(([ring, centre]) => ring.unpaired?.[family]?.includes(centre.id) !== true);
+    const usable = single ? read.filter(([ring]) => ring.id === 'square') : read;
+    if (usable.length === 0)
+        return null;
+    const [ring, centre] = pick(prng, usable);
+    const style = {
+        outer: { id: ring.id },
+        inner: { id: centre.id },
+    };
+    if (prng.next() < 0.3)
+        style.outerPaint = { kind: 'solid', ink: darkInk(prng, against) };
+    if (prng.next() < 0.3)
+        style.innerPaint = { kind: 'solid', ink: darkInk(prng, against) };
+    return style;
+}
+/** The design for `seed`, keeping what in `base` is the person's rather than the look. */
+export function shuffleDesign(base, seed, registries, pairs = conformingPairs(registries)) {
+    const prng = createPrng(seed);
+    const light = ground(prng.fork(1));
+    const paint = prng.fork(2);
+    const shapes = registries.moduleShapes.list();
+    const shape = shapes.length === 0 ? base.modules.shape : { id: pick(prng.fork(3), shapes).id };
+    const family = moduleFamilyOf(registries.moduleShapes.get(shape.id));
+    const finder = finderStyle(prng.fork(4), base, pairs, light, family);
+    const frames = registries.frames.list().filter((frame) => frame.id !== 'none');
+    const framing = prng.fork(5);
+    const framed = base.symbol.symbology !== 'rmqr' && frames.length > 0 && framing.next() < FRAME_CHANCE;
+    const design = {
+        schema: 'qr-design',
+        version: 1,
+        symbol: base.symbol,
+        quietZone: base.quietZone,
+        background: { kind: 'solid', ink: light },
+        modules: { shape, paint: modulesPaint(paint, light, registries), light: null },
+        regions: finder === null ? {} : { finder },
+        logo: base.logo,
+        frame: framed
+            ? {
+                ref: { id: pick(framing, frames).id },
+                paint: { kind: 'solid', ink: darkInk(framing, light) },
+            }
+            : null,
+        output: base.output,
+        ...(base.assets === undefined ? {} : { assets: base.assets }),
+        ...(base.name === undefined ? {} : { name: base.name }),
+    };
+    return design;
+}
+//# sourceMappingURL=shuffle.js.map

package/dist/studio/shuffle.js.map

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

package/dist/studio/slices.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Driving a long generator on this thread a slice at a time.
+ *
+ * The scan check and a batch run are both generators that do one unit of
+ * work (a capture, a row) per `next()`, because this package has no worker
+ * of its own: Chrome refuses a blob worker under file://. This steps one for
+ * about `scheduler.sliceMs`, then hands the thread back until the scheduler
+ * calls again, which keeps typing and scrolling responsive while it runs. An
+ * abort stops it between units and cancels the waiting slice, so nothing is
+ * left on the clock.
+ *
+ * A QrStudioError, or anything else a generator throws, ends the run as a
+ * failed Result. A TypeError is a bug rather than something a person did, so
+ * it rejects the promise instead, which is how it reaches a developer: a
+ * throw inside a timer would reach nobody.
+ */
+import type { QrStudioErrorCode } from '../core/errors.js';
+import type { Result } from '../core/result.js';
+import type { Scheduler } from './types.js';
+export interface SliceOptions<P> {
+    readonly scheduler: Scheduler;
+    readonly clock: () => number;
+    readonly signal: AbortSignal;
+    readonly progress: (p: P) => void;
+    /** The code a failure is reported under when what was thrown is not a QrStudioError. */
+    readonly failure: QrStudioErrorCode;
+}
+export declare function driveInSlices<P, R>(start: () => Generator<P, R>, options: SliceOptions<P>): Promise<Result<R>>;
+//# sourceMappingURL=slices.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slices.d.ts","sourceRoot":"","sources":["../../src/studio/slices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,YAAY,CAAC,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAClC,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;CACpC;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EACjC,KAAK,EAAE,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAC5B,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAyDpB"}

package/dist/studio/slices.js

@@ -0,0 +1,84 @@
+/**
+ * Driving a long generator on this thread a slice at a time.
+ *
+ * The scan check and a batch run are both generators that do one unit of
+ * work (a capture, a row) per `next()`, because this package has no worker
+ * of its own: Chrome refuses a blob worker under file://. This steps one for
+ * about `scheduler.sliceMs`, then hands the thread back until the scheduler
+ * calls again, which keeps typing and scrolling responsive while it runs. An
+ * abort stops it between units and cancels the waiting slice, so nothing is
+ * left on the clock.
+ *
+ * A QrStudioError, or anything else a generator throws, ends the run as a
+ * failed Result. A TypeError is a bug rather than something a person did, so
+ * it rejects the promise instead, which is how it reaches a developer: a
+ * throw inside a timer would reach nobody.
+ */
+import { CancelledError } from '../core/errors.js';
+import { err, ok } from '../core/result.js';
+import { asStudioError } from './keys.js';
+export function driveInSlices(start, options) {
+    const { scheduler, clock, signal, progress, failure } = options;
+    return new Promise((resolve, reject) => {
+        let cancel = null;
+        let finished = false;
+        // Reached once: the abort listener is removed here, and the slice loop
+        // stops at the first sign of `finished`.
+        const end = () => {
+            finished = true;
+            signal.removeEventListener('abort', onAbort);
+            cancel?.();
+            cancel = null;
+        };
+        const finish = (result) => {
+            end();
+            resolve(result);
+        };
+        const thrown = (error) => {
+            end();
+            if (error instanceof TypeError)
+                reject(error);
+            else
+                resolve(err(asStudioError(error, failure)));
+        };
+        const onAbort = () => finish(err(new CancelledError()));
+        if (signal.aborted) {
+            finish(err(new CancelledError()));
+            return;
+        }
+        signal.addEventListener('abort', onAbort);
+        let steps;
+        try {
+            steps = start();
+        }
+        catch (error) {
+            thrown(error);
+            return;
+        }
+        const slice = () => {
+            cancel = null;
+            const started = clock();
+            try {
+                for (;;) {
+                    const step = steps.next();
+                    if (step.done === true) {
+                        finish(ok(step.value));
+                        return;
+                    }
+                    progress(step.value);
+                    if (finished)
+                        return;
+                    if (clock() - started >= scheduler.sliceMs)
+                        break;
+                }
+            }
+            catch (error) {
+                thrown(error);
+                return;
+            }
+            cancel = scheduler.later(slice, 0);
+        };
+        cancel = scheduler.later(slice, 0);
+    });
+}
+//# sourceMappingURL=slices.js.map

package/dist/studio/slices.js.map

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

package/dist/studio/studio.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The headless studio: the one controller both interfaces render.
+ *
+ * Everything a person can do is an action (`dispatch`) or a command (`run`),
+ * and everything a view shows is in the snapshot, so a view holds no document
+ * state of its own. The website reads it through `useSyncExternalStore`; the
+ * offline app subscribes and draws. Both see the same snapshot object until
+ * something changes, and a part of it that did not change keeps its identity,
+ * so either can skip drawing what is the same.
+ *
+ * The expensive parts of a snapshot (the form, the symbol, the preview, the
+ * catalogue) are worked out when a view first reads them and are kept for as
+ * long as what they depend on is the same object. Typing fast therefore
+ * builds no scene for a keystroke nobody drew.
+ *
+ * Nothing a person can do makes this throw. An action that cannot be done
+ * changes nothing and says why in `snapshot.refusal`; a command that cannot
+ * be done resolves to a failed Result. Only a caller's mistake (an action of
+ * no known type, an option of the wrong kind) throws, as a TypeError.
+ */
+import type { Scheduler, Studio, StudioOptions } from './types.js';
+/** Longer than any code holds, by a wide margin, and short enough that a pasted book is refused at once. */
+export declare const MAX_RAW_TEXT = 16384;
+/** A design file is a few kilobytes; one with four logos is a few hundred. */
+export declare const MAX_DESIGN_FILE: number;
+/** setTimeout, in slices of about 8 ms. */
+export declare const DEFAULT_SCHEDULER: Scheduler;
+export declare function createStudio(options?: StudioOptions): Studio;
+//# sourceMappingURL=studio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../../src/studio/studio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAsEH,OAAO,KAAK,EAcX,SAAS,EACT,MAAM,EAKN,aAAa,EAKb,MAAM,YAAY,CAAC;AAcpB,4GAA4G;AAC5G,eAAO,MAAM,YAAY,QAAQ,CAAC;AAClC,8EAA8E;AAC9E,eAAO,MAAM,eAAe,QAAkB,CAAC;AAS/C,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,EAAE,SAM9B,CAAC;AAoCH,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAuyChE"}