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

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * The everyday surface: make a code, design it, draw it.
+ *
+ * Kept small on purpose. The reader, the print writers and the fonts are each
+ * tens of kilobytes that most callers never need, so they are subpaths of
+ * their own (`./decode`, `./render`, `./text`) and nothing here imports them;
+ * tests/studio/root.test.ts bundles this file and fails if one creeps in.
+ */
+export * from './core/index.js';
+export { encode, encodeStructuredAppend } from './encode/index.js';
+export { createRegistries } from './registries.js';
+export { applyConstraints, decodeDesignLink, defaultDesign, designLink, encodeDesignLink, migrateDesign, validateDesign, } from './design/index.js';
+export { buildScene } from './design/scene.js';
+export { sceneToSvg } from './render/svg.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,cAAc,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/inspect/explain.d.ts

@@ -0,0 +1,32 @@
+/**
+ * What some decoded text is and whether to trust where it goes.
+ *
+ * The content type that claims the text most strongly reads it, checks it
+ * and says what in it deserves caution. Any http or https link is also put
+ * through the URL analyser as written, even when a more specific type (a GS1
+ * Digital Link, say) outranked the plain link type, because the person needs
+ * to see the host a browser would really open whatever else the link is.
+ *
+ * Nothing is opened, resolved or fetched. Every type's methods are someone's
+ * code, possibly a third party's registered at runtime, so each call is
+ * fenced: a type that throws is treated as not claiming the text, and the
+ * text is explained as plain text instead, with a note. An inspector that
+ * fails on the code it was asked about is no use to the person holding it.
+ */
+import type { Registry } from '../core/registry.js';
+import type { PayloadType, UrlAnalysis } from '../payload/types.js';
+import type { InspectPayload } from './types.js';
+/** True for text a browser would open as an http or https link, after the trimming WHATWG does. */
+export declare function isWebLink(text: string): boolean;
+/**
+ * True for text the URL parser reads as a scheme that runs code, however it
+ * is disguised: a tab inside "javascript:" is removed by the parser, so the
+ * text looks like nothing in particular and still runs as script.
+ */
+export declare function isDangerousLink(text: string): boolean;
+export interface Explained {
+    readonly payload: InspectPayload;
+    readonly safety: UrlAnalysis;
+}
+export declare function explainText(text: string, payloads: Registry<PayloadType>): Explained;
+//# sourceMappingURL=explain.d.ts.map

package/dist/inspect/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/inspect/explain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,KAAK,EAAE,WAAW,EAA+B,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,mGAAmG;AACnG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG/C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMrD;AAcD,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC7B;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,SAAS,CAgDpF"}

package/dist/inspect/explain.js

@@ -0,0 +1,99 @@
+/**
+ * What some decoded text is and whether to trust where it goes.
+ *
+ * The content type that claims the text most strongly reads it, checks it
+ * and says what in it deserves caution. Any http or https link is also put
+ * through the URL analyser as written, even when a more specific type (a GS1
+ * Digital Link, say) outranked the plain link type, because the person needs
+ * to see the host a browser would really open whatever else the link is.
+ *
+ * Nothing is opened, resolved or fetched. Every type's methods are someone's
+ * code, possibly a third party's registered at runtime, so each call is
+ * fenced: a type that throws is treated as not claiming the text, and the
+ * text is explained as plain text instead, with a note. An inspector that
+ * fails on the code it was asked about is no use to the person holding it.
+ */
+import { issue } from '../core/issue.js';
+import { textType } from '../payload/content/text.js';
+import { detectPayload } from '../payload/detect.js';
+import { analyseUrl, isDangerousScheme } from '../payload/url-safety.js';
+/** True for text a browser would open as an http or https link, after the trimming WHATWG does. */
+export function isWebLink(text) {
+    // eslint-disable-next-line no-control-regex -- C0 controls and space are what the URL parser trims.
+    return /^[\u0000-\u0020]*https?:/i.test(text);
+}
+/**
+ * True for text the URL parser reads as a scheme that runs code, however it
+ * is disguised: a tab inside "javascript:" is removed by the parser, so the
+ * text looks like nothing in particular and still runs as script.
+ */
+export function isDangerousLink(text) {
+    try {
+        return isDangerousScheme(new URL(text).protocol.slice(0, -1));
+    }
+    catch {
+        return false;
+    }
+}
+function attemptCall(fn) {
+    try {
+        return { ok: true, value: fn() };
+    }
+    catch {
+        return { ok: false };
+    }
+}
+function findingKey(finding) {
+    return `${finding.code}|${finding.severity}|${JSON.stringify(finding.params ?? {})}`;
+}
+export function explainText(text, payloads) {
+    // detectPayload fences every type's detect itself, scoring one that throws
+    // as not claiming the text.
+    const issues = [];
+    let type = detectPayload(text, payloads).type;
+    let parsed = attemptCall(() => type.parse(text));
+    if (!parsed.ok) {
+        // Detected, but not readable as that type after all: explained as text.
+        issues.push(issue('inspect.issue.unreadable-as-type', [], 'warning', { typeId: type.id }));
+        type = (payloads.get('text') ?? textType);
+        parsed = attemptCall(() => type.parse(text));
+    }
+    const value = parsed.ok ? parsed.value : { text };
+    const validated = attemptCall(() => type.validate(value));
+    if (validated.ok)
+        issues.push(...validated.value);
+    // The link as written comes first: it is what the code holds, and where a
+    // type reports the same kind of finding about its own reading of the link
+    // (a link with its tracking tags moved into fields, say), the raw text's
+    // is the one shown.
+    const findings = [];
+    let displayHost = null;
+    let unicodeHost = null;
+    const raw = new Set();
+    if (isWebLink(text) || isDangerousLink(text)) {
+        const analysis = analyseUrl(text);
+        findings.push(...analysis.findings);
+        for (const finding of analysis.findings)
+            raw.add(finding.code);
+        displayHost = analysis.displayHost;
+        unicodeHost = analysis.unicodeHost;
+    }
+    const seen = new Set(findings.map(findingKey));
+    const own = type.safety === undefined
+        ? undefined
+        : attemptCall(() => type.safety(value));
+    if (own !== undefined && own.ok) {
+        for (const finding of own.value) {
+            const key = findingKey(finding);
+            if (raw.has(finding.code) || seen.has(key))
+                continue;
+            seen.add(key);
+            findings.push(finding);
+        }
+    }
+    return {
+        payload: Object.freeze({ typeId: type.id, value, issues: Object.freeze(issues) }),
+        safety: Object.freeze({ findings: Object.freeze(findings), displayHost, unicodeHost }),
+    };
+}
+//# sourceMappingURL=explain.js.map

package/dist/inspect/explain.js.map

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

package/dist/inspect/gs1.d.ts

@@ -0,0 +1,38 @@
+/**
+ * GS1 element strings: what a code that starts with FNC1 in the first
+ * position holds.
+ *
+ * Such a code is a run of application identifiers, each followed by its
+ * value: (01) a GTIN, (17) an expiry date, (10) a batch. Some identifiers
+ * have a fixed length and need no separator; the rest run to a group
+ * separator (GS, 0x1D, which the reader gives for FNC1 in the middle) or to
+ * the end. The subset here is the identifiers seen on trade items, logistic
+ * labels and coupons, from the GS1 General Specifications (release 24,
+ * section 3.2), with the lengths from its figure 3.2-1. An identifier not in
+ * it is still split out, by the rule for how long identifiers starting with
+ * those digits are (figure 3.2-2), and read to the next separator.
+ *
+ * Nothing is validated beyond the shape: a check digit or a date that does
+ * not exist is the content type's business, and an inspector shows what is
+ * there.
+ */
+import type { Gs1Element } from './types.js';
+interface AiSpec {
+    /** Digits in the identifier itself. */
+    readonly length: 2 | 3 | 4;
+    /** Characters in the value when fixed; undefined when variable. */
+    readonly fixed?: number;
+    /** The most characters in a variable value. */
+    readonly max?: number;
+}
+/** The identifiers this reads by name, with their value lengths. */
+export declare const GS1_AIS: Readonly<Record<string, AiSpec>>;
+/**
+ * The element strings of `text`, in order. Reading stops at the first
+ * place the text stops being element strings (a value too short for its
+ * fixed length, an identifier that is not digits), and what came before is
+ * kept: an inspector shows as much as it can.
+ */
+export declare function parseGs1(text: string): Gs1Element[];
+export {};
+//# sourceMappingURL=gs1.d.ts.map

package/dist/inspect/gs1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gs1.d.ts","sourceRoot":"","sources":["../../src/inspect/gs1.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,UAAU,MAAM;IACf,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,oEAAoE;AACpE,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyCnD,CAAC;AAmCH;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAqBnD"}

package/dist/inspect/gs1.js

@@ -0,0 +1,130 @@
+/**
+ * GS1 element strings: what a code that starts with FNC1 in the first
+ * position holds.
+ *
+ * Such a code is a run of application identifiers, each followed by its
+ * value: (01) a GTIN, (17) an expiry date, (10) a batch. Some identifiers
+ * have a fixed length and need no separator; the rest run to a group
+ * separator (GS, 0x1D, which the reader gives for FNC1 in the middle) or to
+ * the end. The subset here is the identifiers seen on trade items, logistic
+ * labels and coupons, from the GS1 General Specifications (release 24,
+ * section 3.2), with the lengths from its figure 3.2-1. An identifier not in
+ * it is still split out, by the rule for how long identifiers starting with
+ * those digits are (figure 3.2-2), and read to the next separator.
+ *
+ * Nothing is validated beyond the shape: a check digit or a date that does
+ * not exist is the content type's business, and an inspector shows what is
+ * there.
+ */
+const GS = '\u001d';
+/** The identifiers this reads by name, with their value lengths. */
+export const GS1_AIS = Object.freeze({
+    '00': { length: 2, fixed: 18 },
+    '01': { length: 2, fixed: 14 },
+    '02': { length: 2, fixed: 14 },
+    '10': { length: 2, max: 20 },
+    '11': { length: 2, fixed: 6 },
+    '12': { length: 2, fixed: 6 },
+    '13': { length: 2, fixed: 6 },
+    '15': { length: 2, fixed: 6 },
+    '16': { length: 2, fixed: 6 },
+    '17': { length: 2, fixed: 6 },
+    '20': { length: 2, fixed: 2 },
+    '21': { length: 2, max: 20 },
+    '22': { length: 2, max: 20 },
+    '240': { length: 3, max: 30 },
+    '241': { length: 3, max: 30 },
+    '250': { length: 3, max: 30 },
+    '251': { length: 3, max: 30 },
+    '253': { length: 3, max: 30 },
+    '254': { length: 3, max: 20 },
+    '30': { length: 2, max: 8 },
+    '37': { length: 2, max: 8 },
+    '400': { length: 3, max: 30 },
+    '401': { length: 3, max: 30 },
+    '402': { length: 3, fixed: 17 },
+    '403': { length: 3, max: 30 },
+    '410': { length: 3, fixed: 13 },
+    '411': { length: 3, fixed: 13 },
+    '412': { length: 3, fixed: 13 },
+    '413': { length: 3, fixed: 13 },
+    '414': { length: 3, fixed: 13 },
+    '415': { length: 3, fixed: 13 },
+    '416': { length: 3, fixed: 13 },
+    '420': { length: 3, max: 20 },
+    '421': { length: 3, max: 12 },
+    '422': { length: 3, fixed: 3 },
+    '7003': { length: 4, fixed: 10 },
+    '8003': { length: 4, max: 30 },
+    '8004': { length: 4, max: 30 },
+    '8020': { length: 4, max: 25 },
+    '90': { length: 2, max: 30 },
+});
+/** Measures with the decimal point in the fourth digit: 310n net weight in kilograms, and the rest of 31 to 36. */
+function measure(ai) {
+    return /^3[1-6]\d\d$/.test(ai) ? { length: 4, fixed: 6 } : undefined;
+}
+/** Amounts: 390n and 391n payable, 392n and 393n price, a decimal point in the fourth digit. */
+function amount(ai) {
+    return /^39[0-3]\d$/.test(ai) ? { length: 4, max: 18 } : undefined;
+}
+/** Figure 3.2-2: how many digits an identifier starting with these two has. */
+function lengthFor(prefix) {
+    const n = Number(prefix);
+    if (n <= 22 || n === 30 || n === 37 || n >= 90)
+        return 2;
+    if ((n >= 23 && n <= 25) || (n >= 40 && n <= 42))
+        return 3;
+    return 4;
+}
+/** The identifier at the start of `rest` and how its value is delimited. */
+function specAt(rest) {
+    for (const length of [2, 3, 4]) {
+        const ai = rest.slice(0, length);
+        const spec = GS1_AIS[ai] ?? (length === 4 ? (measure(ai) ?? amount(ai)) : undefined);
+        if (spec !== undefined && spec.length === length)
+            return { ai, spec };
+    }
+    if (!/^\d\d/.test(rest))
+        return null;
+    const length = lengthFor(rest.slice(0, 2));
+    const ai = rest.slice(0, length);
+    if (!/^\d+$/.test(ai) || ai.length < length)
+        return null;
+    // Internal company codes 91 to 99 run to 90 characters.
+    return { ai, spec: { length, max: Number(ai.slice(0, 2)) >= 91 ? 90 : 70 } };
+}
+/**
+ * The element strings of `text`, in order. Reading stops at the first
+ * place the text stops being element strings (a value too short for its
+ * fixed length, an identifier that is not digits), and what came before is
+ * kept: an inspector shows as much as it can.
+ */
+export function parseGs1(text) {
+    const out = [];
+    let at = text.startsWith(GS) ? 1 : 0;
+    while (at < text.length) {
+        const found = specAt(text.slice(at));
+        if (found === null)
+            break;
+        const start = at + found.ai.length;
+        let end;
+        if (found.spec.fixed !== undefined) {
+            end = start + found.spec.fixed;
+            if (end > text.length || text.slice(start, end).includes(GS))
+                break;
+        }
+        else {
+            const separator = text.indexOf(GS, start);
+            end = separator < 0 ? text.length : separator;
+            if (end - start > found.spec.max)
+                break;
+        }
+        out.push({ ai: found.ai, value: text.slice(start, end) });
+        at = end;
+        if (text[at] === GS)
+            at += 1;
+    }
+    return out;
+}
+//# sourceMappingURL=gs1.js.map

package/dist/inspect/gs1.js.map

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

package/dist/inspect/index.d.ts

@@ -0,0 +1,9 @@
+export { inspectImage, inspectText, inspectedSymbol } from './inspect.js';
+export { explainText, isDangerousLink, isWebLink } from './explain.js';
+export type { Explained } from './explain.js';
+export { GS1_AIS, parseGs1 } from './gs1.js';
+export { assembleSets } from './sets.js';
+export type { SetPart } from './sets.js';
+export { INSPECT_MESSAGE_KEYS, gs1MessageKey } from './keys.js';
+export type { Gs1Element, InspectPayload, InspectRegistries, InspectReport, InspectSet, InspectedSymbol, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/inspect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inspect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACvE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAChE,YAAY,EACX,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,eAAe,GACf,MAAM,YAAY,CAAC"}

package/dist/inspect/index.js

@@ -0,0 +1,6 @@
+export { inspectImage, inspectText, inspectedSymbol } from './inspect.js';
+export { explainText, isDangerousLink, isWebLink } from './explain.js';
+export { GS1_AIS, parseGs1 } from './gs1.js';
+export { assembleSets } from './sets.js';
+export { INSPECT_MESSAGE_KEYS, gs1MessageKey } from './keys.js';
+//# sourceMappingURL=index.js.map

package/dist/inspect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/inspect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/inspect/inspect.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The inspector: what a scanned code says, and whether to trust it.
+ *
+ * `inspectImage` reads every code in a picture with the scanner (the
+ * lenient profile, several codes allowed), reports how well each one read,
+ * puts structured append sets back together, and explains the content of
+ * the first code, or of the set it completes. `inspectText` explains text a
+ * person pasted or a camera already read.
+ *
+ * Neither ever opens, resolves or fetches anything. The report says where a
+ * code goes, the host a browser would really connect to included, and the
+ * person decides. That is the inspector's whole promise, and it is why the
+ * report's link analysis comes from the parser alone.
+ */
+import type { Result } from '../core/result.js';
+import type { RgbaImage } from '../core/image.js';
+import type { DecodeOptions, DecodedSymbol } from '../decode/types.js';
+import type { InspectRegistries, InspectReport, InspectedSymbol } from './types.js';
+/** One decoded symbol as the inspector reports it. */
+export declare function inspectedSymbol(symbol: DecodedSymbol): InspectedSymbol;
+/** Explain text a person pasted or a reader already gave. Never throws for any string. */
+export declare function inspectText(text: string, registries: InspectRegistries): InspectReport;
+/**
+ * Read every code in a picture and explain the first, or the set it
+ * completes. A picture with no code that reads is a failed result, with the
+ * decoder's reason.
+ */
+export declare function inspectImage(image: RgbaImage, registries: InspectRegistries, options?: DecodeOptions): Result<InspectReport>;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/inspect/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/inspect/inspect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAapF,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CAwBtE;AAED,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,aAAa,CAKtF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,iBAAiB,EAC7B,OAAO,GAAE,aAAkB,GACzB,MAAM,CAAC,aAAa,CAAC,CAuCvB"}

package/dist/inspect/inspect.js

@@ -0,0 +1,98 @@
+/**
+ * The inspector: what a scanned code says, and whether to trust it.
+ *
+ * `inspectImage` reads every code in a picture with the scanner (the
+ * lenient profile, several codes allowed), reports how well each one read,
+ * puts structured append sets back together, and explains the content of
+ * the first code, or of the set it completes. `inspectText` explains text a
+ * person pasted or a camera already read.
+ *
+ * Neither ever opens, resolves or fetches anything. The report says where a
+ * code goes, the host a browser would really connect to included, and the
+ * person decides. That is the inspector's whole promise, and it is why the
+ * report's link analysis comes from the parser alone.
+ */
+import { QrStudioError } from '../core/errors.js';
+import { err, ok } from '../core/result.js';
+import { decodeImage } from '../decode/decoder.js';
+import { explainText } from './explain.js';
+import { parseGs1 } from './gs1.js';
+import { assembleSets } from './sets.js';
+function checkRegistries(registries) {
+    if (typeof registries !== 'object' ||
+        registries === null ||
+        typeof registries.symbologies !== 'object' ||
+        typeof registries.payloads !== 'object') {
+        throw new TypeError('inspect: registries gives the symbologies and the content types.');
+    }
+}
+/** One decoded symbol as the inspector reports it. */
+export function inspectedSymbol(symbol) {
+    const { read } = symbol;
+    const { bitstream } = read;
+    return Object.freeze({
+        symbology: symbol.symbology,
+        version: read.version,
+        ecLevel: read.ecLevel,
+        mask: read.mask,
+        corners: symbol.corners,
+        segments: bitstream.segments,
+        text: bitstream.text,
+        textSource: bitstream.textSource,
+        structuredAppend: bitstream.structuredAppend,
+        gs1: bitstream.fnc1 === 'gs1' ? Object.freeze(parseGs1(bitstream.text)) : null,
+        quality: Object.freeze({
+            errorsPerBlock: read.errorsPerBlock,
+            capacityPerBlock: read.capacityPerBlock,
+            erasuresUsed: read.erasuresUsed,
+            formatErrors: read.formatErrors,
+            mirrored: read.mirrored,
+            inverted: symbol.inverted,
+            minConfidence: symbol.minConfidence,
+        }),
+    });
+}
+/** Explain text a person pasted or a reader already gave. Never throws for any string. */
+export function inspectText(text, registries) {
+    if (typeof text !== 'string')
+        throw new TypeError('inspectText: text is a string.');
+    checkRegistries(registries);
+    const { payload, safety } = explainText(text, registries.payloads);
+    return Object.freeze({ symbols: Object.freeze([]), sets: Object.freeze([]), payload, safety });
+}
+/**
+ * Read every code in a picture and explain the first, or the set it
+ * completes. A picture with no code that reads is a failed result, with the
+ * decoder's reason.
+ */
+export function inspectImage(image, registries, options = {}) {
+    checkRegistries(registries);
+    const decoded = decodeImage(image, { ...options, profile: options.profile ?? 'lenient' }, registries.symbologies);
+    if (!decoded.ok)
+        return err(decoded.error);
+    const found = decoded.value;
+    // The decoder reports finding nothing as a failure, never as an empty
+    // success; this keeps that promise from becoming a crash here if it ever
+    // changes.
+    /* v8 ignore next 3 */
+    if (found.length === 0) {
+        return err(new QrStudioError('decode/not-found', 'No code was found in this picture.'));
+    }
+    const symbols = found.map(inspectedSymbol);
+    const sets = assembleSets(found.flatMap((symbol) => {
+        const header = symbol.read.bitstream.structuredAppend;
+        return header === null
+            ? []
+            : [{ ...header, text: symbol.read.bitstream.text, bytes: symbol.read.bitstream.bytes }];
+    }));
+    // The first code, or the whole message when the first code is part of a set that is complete.
+    const first = symbols[0];
+    const header = first.structuredAppend;
+    const set = header === null
+        ? undefined
+        : sets.find((candidate) => candidate.parity === header.parity && candidate.total === header.total);
+    const text = set?.text ?? first.text;
+    const { payload, safety } = explainText(text, registries.payloads);
+    return ok(Object.freeze({ symbols: Object.freeze(symbols), sets: Object.freeze(sets), payload, safety }));
+}
+//# sourceMappingURL=inspect.js.map

package/dist/inspect/inspect.js.map

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

package/dist/inspect/keys.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The message keys a view needs to show an inspection: labels for what was
+ * read, the sentences about sets and about where a code goes, and a name for
+ * each GS1 application identifier the inspector reads by name. Safety
+ * findings are the payload layer's own keys (`safetyMessageKey`). The
+ * English is src/messages/en/inspect.ts.
+ */
+export declare const INSPECT_MESSAGE_KEYS: Readonly<{
+    labels: Readonly<{
+        symbology: "inspect.label.symbology";
+        version: "inspect.label.version";
+        ecLevel: "inspect.label.error-correction";
+        mask: "inspect.label.mask";
+        textSource: "inspect.label.text-source";
+        segments: "inspect.label.segments";
+        structuredAppend: "inspect.label.structured-append";
+        gs1: "inspect.label.gs1";
+        quality: "inspect.label.quality";
+        errorsCorrected: "inspect.label.errors-corrected";
+        formatErrors: "inspect.label.format-errors";
+        mirrored: "inspect.label.mirrored";
+        inverted: "inspect.label.inverted";
+        confidence: "inspect.label.confidence";
+        content: "inspect.label.content";
+        destination: "inspect.label.destination";
+        unicodeHost: "inspect.label.unicode-host";
+    }>;
+    textSources: Readonly<{
+        'utf-8': "inspect.text-source.utf-8";
+        'latin1-fallback': "inspect.text-source.latin1-fallback";
+        'shift-jis': "inspect.text-source.shift-jis";
+        eci: "inspect.text-source.eci";
+    }>;
+    sets: Readonly<{
+        complete: "inspect.set.complete";
+        incomplete: "inspect.set.incomplete";
+        parityMismatch: "inspect.set.parity-mismatch";
+    }>;
+    /** Shown beside every destination: nothing has been opened, and the person decides. */
+    notOpened: "inspect.not-opened";
+    /** When a code scored as one kind of content but did not read as it. */
+    unreadableAsType: "inspect.issue.unreadable-as-type";
+    gs1Measure: "inspect.gs1.measure";
+    gs1Amount: "inspect.gs1.amount";
+    gs1Unknown: "inspect.gs1.unknown";
+}>;
+/**
+ * The name of a GS1 application identifier: `inspect.gs1.<ai>` for those
+ * read by name, one key for the measures (31 to 36) and one for the amounts
+ * (390 to 393), whose fourth digit places the decimal point, and
+ * `inspect.gs1.unknown` for the rest.
+ */
+export declare function gs1MessageKey(ai: string): string;
+//# sourceMappingURL=keys.d.ts.map

package/dist/inspect/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/inspect/keys.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+BhC,uFAAuF;;IAEvF,wEAAwE;;;;;EAKvE,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAKhD"}

package/dist/inspect/keys.js

@@ -0,0 +1,63 @@
+/**
+ * The message keys a view needs to show an inspection: labels for what was
+ * read, the sentences about sets and about where a code goes, and a name for
+ * each GS1 application identifier the inspector reads by name. Safety
+ * findings are the payload layer's own keys (`safetyMessageKey`). The
+ * English is src/messages/en/inspect.ts.
+ */
+import { GS1_AIS } from './gs1.js';
+export const INSPECT_MESSAGE_KEYS = Object.freeze({
+    labels: Object.freeze({
+        symbology: 'inspect.label.symbology',
+        version: 'inspect.label.version',
+        ecLevel: 'inspect.label.error-correction',
+        mask: 'inspect.label.mask',
+        textSource: 'inspect.label.text-source',
+        segments: 'inspect.label.segments',
+        structuredAppend: 'inspect.label.structured-append',
+        gs1: 'inspect.label.gs1',
+        quality: 'inspect.label.quality',
+        errorsCorrected: 'inspect.label.errors-corrected',
+        formatErrors: 'inspect.label.format-errors',
+        mirrored: 'inspect.label.mirrored',
+        inverted: 'inspect.label.inverted',
+        confidence: 'inspect.label.confidence',
+        content: 'inspect.label.content',
+        destination: 'inspect.label.destination',
+        unicodeHost: 'inspect.label.unicode-host',
+    }),
+    textSources: Object.freeze({
+        'utf-8': 'inspect.text-source.utf-8',
+        'latin1-fallback': 'inspect.text-source.latin1-fallback',
+        'shift-jis': 'inspect.text-source.shift-jis',
+        eci: 'inspect.text-source.eci',
+    }),
+    sets: Object.freeze({
+        complete: 'inspect.set.complete',
+        incomplete: 'inspect.set.incomplete',
+        parityMismatch: 'inspect.set.parity-mismatch',
+    }),
+    /** Shown beside every destination: nothing has been opened, and the person decides. */
+    notOpened: 'inspect.not-opened',
+    /** When a code scored as one kind of content but did not read as it. */
+    unreadableAsType: 'inspect.issue.unreadable-as-type',
+    gs1Measure: 'inspect.gs1.measure',
+    gs1Amount: 'inspect.gs1.amount',
+    gs1Unknown: 'inspect.gs1.unknown',
+});
+/**
+ * The name of a GS1 application identifier: `inspect.gs1.<ai>` for those
+ * read by name, one key for the measures (31 to 36) and one for the amounts
+ * (390 to 393), whose fourth digit places the decimal point, and
+ * `inspect.gs1.unknown` for the rest.
+ */
+export function gs1MessageKey(ai) {
+    if (Object.prototype.hasOwnProperty.call(GS1_AIS, ai))
+        return `inspect.gs1.${ai}`;
+    if (/^3[1-6]\d\d$/.test(ai))
+        return INSPECT_MESSAGE_KEYS.gs1Measure;
+    if (/^39[0-3]\d$/.test(ai))
+        return INSPECT_MESSAGE_KEYS.gs1Amount;
+    return INSPECT_MESSAGE_KEYS.gs1Unknown;
+}
+//# sourceMappingURL=keys.js.map