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

package/dist/studio/document.js

@@ -0,0 +1,208 @@
+/**
+ * Studio documents: the defaults, the empty fields of a content type, and
+ * making a document out of something that arrived from outside (a design
+ * link, a saved document, a file from the library).
+ *
+ * Anything from outside is checked here and repaired where the repair is
+ * plain, with an issue saying so. A document never fails to load because one
+ * part of it is wrong: an unknown content type falls back to a web link, a
+ * design that does not validate falls back to the default, and a field of the
+ * wrong kind is left for the form to show as wrong.
+ */
+import { issue } from '../core/issue.js';
+import { defaultDesign } from '../design/document.js';
+import { decodeDesignLink } from '../design/link.js';
+import { migrateDesign } from '../design/migrate.js';
+import { validateDesign } from '../design/validate.js';
+import { STUDIO_KEYS, asStudioError, errorIssue } from './keys.js';
+export const DEFAULT_TYPE = 'url';
+export const DEFAULT_CONDITIONS = Object.freeze({
+    sizeMm: 25,
+    dpi: null,
+    distanceMm: null,
+});
+const MODES = ['create', 'scan', 'bulk'];
+const NUMBER_KINDS = new Set(['number', 'integer', 'amount', 'latitude', 'longitude']);
+/** What an untouched field holds: its schema default, or nothing of its kind. */
+export function emptyValue(field) {
+    if (field.default !== undefined)
+        return field.default;
+    if (field.multiple === true)
+        return Object.freeze([]);
+    if (field.kind === 'boolean')
+        return false;
+    if (NUMBER_KINDS.has(field.kind))
+        return null;
+    return '';
+}
+/** Whether `value` is the kind of thing `field` holds, so it can move from one type to another. */
+export function fitsField(field, value) {
+    if (value === null)
+        return NUMBER_KINDS.has(field.kind);
+    if (field.multiple === true)
+        return Array.isArray(value);
+    if (Array.isArray(value))
+        return false;
+    if (field.kind === 'boolean')
+        return typeof value === 'boolean';
+    if (NUMBER_KINDS.has(field.kind))
+        return typeof value === 'number';
+    if (typeof value !== 'string')
+        return false;
+    if (field.kind === 'select' && value !== '') {
+        return (field.options ?? []).some((option) => option.value === value);
+    }
+    return true;
+}
+/** Whether a value is a FieldValue at all: a value from a file or a fuzzer may be anything. */
+export function isFieldValue(value) {
+    if (value === null)
+        return true;
+    if (typeof value === 'string' || typeof value === 'boolean')
+        return true;
+    // Any number: one that is not finite is the form's to report, not this check's.
+    if (typeof value === 'number')
+        return true;
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+}
+/**
+ * The fields for `type`: every value in `from` whose key the type has and
+ * whose kind it takes, and the empty value for the rest. Keys the type does
+ * not have are dropped, so switching from Wi-Fi to a link does not carry the
+ * password along unseen.
+ */
+export function fieldsFor(type, from = {}) {
+    const out = {};
+    for (const field of type.fields) {
+        const value = Object.prototype.hasOwnProperty.call(from, field.key)
+            ? from[field.key]
+            : undefined;
+        out[field.key] = value !== undefined && fitsField(field, value) ? value : emptyValue(field);
+    }
+    return Object.freeze(out);
+}
+/** A design from anything: migrated and validated, or the default with the reasons it was refused. */
+export function designFrom(input, registries, fonts) {
+    let migrated;
+    try {
+        migrated = migrateDesign(input);
+    }
+    catch (thrown) {
+        return { design: null, issues: [errorIssue(asStudioError(thrown, 'design/invalid'), [])] };
+    }
+    try {
+        return validateDesign(migrated, registries.design, fonts === undefined ? {} : { fonts });
+    }
+    catch (thrown) {
+        // The validator reports problems as issues; this is for a registry
+        // entry of somebody else's that throws while it is asked about itself.
+        return { design: null, issues: [errorIssue(asStudioError(thrown, 'design/invalid'), [])] };
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function positiveOrNull(value) {
+    if (value === null)
+        return null;
+    if (typeof value === 'number' && Number.isFinite(value) && value > 0)
+        return value;
+    return undefined;
+}
+/**
+ * Conditions from anything, each part checked on its own. `bad` holds the
+ * path of each part that was wrong, from the document's root.
+ */
+export function conditionsFrom(input, base) {
+    if (!isRecord(input)) {
+        return { conditions: base, bad: input === undefined ? [] : [['conditions']] };
+    }
+    const bad = [];
+    const out = { ...base };
+    for (const key of ['sizeMm', 'dpi', 'distanceMm']) {
+        if (!Object.prototype.hasOwnProperty.call(input, key) || input[key] === undefined)
+            continue;
+        const value = positiveOrNull(input[key]);
+        if (value === undefined)
+            bad.push(['conditions', key]);
+        else
+            out[key] = value;
+    }
+    return { conditions: out, bad };
+}
+/** The document a studio starts with when it is given nothing. */
+export function defaultDocument(registries) {
+    const type = registries.payloads.get(DEFAULT_TYPE) ?? registries.payloads.list()[0];
+    if (type === undefined) {
+        throw new TypeError('createStudio: the payload registry has no content types.');
+    }
+    return Object.freeze({
+        mode: 'create',
+        typeId: type.id,
+        fields: fieldsFor(type),
+        design: defaultDesign(),
+        conditions: DEFAULT_CONDITIONS,
+    });
+}
+/**
+ * A document from something outside: a whole document (from the library, or
+ * a caller), checked and repaired part by part.
+ */
+export function documentFrom(input, registries, fonts) {
+    const base = defaultDocument(registries);
+    if (!isRecord(input)) {
+        return { document: base, issues: [issue(STUDIO_KEYS.documentRepaired, [], 'warning')] };
+    }
+    const issues = [];
+    const mode = MODES.includes(input.mode) ? input.mode : base.mode;
+    if (input.mode !== undefined && mode !== input.mode) {
+        issues.push(issue(STUDIO_KEYS.documentRepaired, ['mode'], 'warning'));
+    }
+    const found = typeof input.typeId === 'string' ? registries.payloads.get(input.typeId) : undefined;
+    const type = found !== undefined && found.generate !== false
+        ? found
+        : registries.payloads.require(base.typeId);
+    if (type !== found)
+        issues.push(issue(STUDIO_KEYS.documentRepaired, ['typeId'], 'warning'));
+    const given = {};
+    if (isRecord(input.fields)) {
+        for (const [key, value] of Object.entries(input.fields)) {
+            if (isFieldValue(value))
+                given[key] = value;
+        }
+    }
+    const fields = fieldsFor(type, given);
+    const checked = designFrom(input.design, registries, fonts);
+    if (checked.design === null) {
+        issues.push(issue(STUDIO_KEYS.documentRepaired, ['design'], 'warning'));
+    }
+    const { conditions, bad } = conditionsFrom(input.conditions, base.conditions);
+    for (const path of bad)
+        issues.push(issue(STUDIO_KEYS.documentRepaired, path, 'warning'));
+    return {
+        document: Object.freeze({
+            mode,
+            typeId: type.id,
+            fields,
+            design: checked.design ?? base.design,
+            conditions,
+        }),
+        issues,
+    };
+}
+/** The document a link opens: the default content with the link's design. */
+export function documentFromLink(fragment, registries) {
+    const base = defaultDocument(registries);
+    try {
+        const design = decodeDesignLink(fragment, registries.design);
+        return { document: Object.freeze({ ...base, design }), issues: [] };
+    }
+    catch (thrown) {
+        const error = asStudioError(thrown, 'design/invalid');
+        return {
+            document: base,
+            issues: [issue(STUDIO_KEYS.designLink, [], 'warning', { code: error.code })],
+        };
+    }
+}
+//# sourceMappingURL=document.js.map

package/dist/studio/document.js.map

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

package/dist/studio/export.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Exporting the code as a file.
+ *
+ * Every format starts from the same scene the preview draws, so what is
+ * saved is what was seen. SVG and PNG are this package's own writers and give
+ * the same bytes in every browser. JPEG and WebP go through the browser's
+ * encoders, which a caller passes in (the dom layer's canvas encoder); PDF and
+ * EPS through the print layer.
+ *
+ * Sizes: a raster is as wide as asked in pixels, or as a physical size at a
+ * dpi works out to, or a size picked so every module lands on whole pixels.
+ * A print format always has a physical size, from the options, the design,
+ * the scan conditions or 25 mm, in that order. The options and the design
+ * measure it as the design's `output.sizeBasis` says (the whole artwork, or
+ * the Swiss QR-bill's symbol alone); the conditions measure the symbol with
+ * its quiet zone. Whatever gave it, the millimetres of the result are read
+ * from the scene that size builds, never worked out again from the number.
+ *
+ * A bad option never fails an export: it is left out and the result's issues
+ * say which one. What a content type fixes (the Swiss QR-bill's 46 mm) cannot
+ * be changed here either.
+ */
+import type { RgbaImage } from '../core/image.js';
+import type { Result } from '../core/result.js';
+import type { DesignOverlay, DesignRegistries, FontRegistry, QrDesignV1 } from '../design/types.js';
+import type { BuiltSymbol } from '../symbology/types.js';
+import type { Printer, VerifyConditions } from './seams.js';
+import type { ExportFormat, ExportOptions, ExportResult, RasterEncoder } from './types.js';
+/** The widest raster an export draws, in pixels a side. */
+export declare const EXPORT_MAX_SIDE = 16384;
+/** The most pixels an export draws: 64 megapixels, a quarter of a gigabyte of RGBA. */
+export declare const EXPORT_MAX_PIXELS: number;
+/** The printed size when nothing else gives one. */
+export declare const DEFAULT_PRINT_MM = 25;
+export interface ExportInput {
+    readonly symbol: BuiltSymbol;
+    /** The design as drawn, after the content's constraints. */
+    readonly design: QrDesignV1;
+    /** The size the content fixes, if it fixes one. */
+    readonly fixedSizeMm: number | undefined;
+    readonly conditions: VerifyConditions;
+    readonly registries: DesignRegistries;
+    readonly assets: (id: string) => RgbaImage | undefined;
+    readonly fonts: FontRegistry;
+    /** What the content prints over the code, from applyConstraints. */
+    readonly overlay: DesignOverlay | null;
+    readonly seed: number;
+    readonly rasterEncoder: RasterEncoder | null;
+    readonly printer: Printer | null;
+}
+export declare function exportSymbol(input: ExportInput, format: ExportFormat, options: ExportOptions): Promise<Result<ExportResult>>;
+//# sourceMappingURL=export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/studio/export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKpG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3F,2DAA2D;AAC3D,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,uFAAuF;AACvF,eAAO,MAAM,iBAAiB,QAAmB,CAAC;AAIlD,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAsBnC,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC;AA2KD,wBAAsB,YAAY,CACjC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAqE/B"}

package/dist/studio/export.js

@@ -0,0 +1,269 @@
+/**
+ * Exporting the code as a file.
+ *
+ * Every format starts from the same scene the preview draws, so what is
+ * saved is what was seen. SVG and PNG are this package's own writers and give
+ * the same bytes in every browser. JPEG and WebP go through the browser's
+ * encoders, which a caller passes in (the dom layer's canvas encoder); PDF and
+ * EPS through the print layer.
+ *
+ * Sizes: a raster is as wide as asked in pixels, or as a physical size at a
+ * dpi works out to, or a size picked so every module lands on whole pixels.
+ * A print format always has a physical size, from the options, the design,
+ * the scan conditions or 25 mm, in that order. The options and the design
+ * measure it as the design's `output.sizeBasis` says (the whole artwork, or
+ * the Swiss QR-bill's symbol alone); the conditions measure the symbol with
+ * its quiet zone. Whatever gave it, the millimetres of the result are read
+ * from the scene that size builds, never worked out again from the number.
+ *
+ * A bad option never fails an export: it is left out and the result's issues
+ * say which one. What a content type fixes (the Swiss QR-bill's 46 mm) cannot
+ * be changed here either.
+ */
+import { QrStudioError } from '../core/errors.js';
+import { issue } from '../core/issue.js';
+import { err, ok } from '../core/result.js';
+import { LIMITS, MIN_QUIET_ZONE } from '../design/document.js';
+import { buildScene } from '../design/scene.js';
+import { encodePng } from '../render/png.js';
+import { rasterise } from '../render/raster.js';
+import { sceneToSvg } from '../render/svg.js';
+import { STUDIO_KEYS, asStudioError } from './keys.js';
+import { exportName } from './names.js';
+/** The widest raster an export draws, in pixels a side. */
+export const EXPORT_MAX_SIDE = 16384;
+/** The most pixels an export draws: 64 megapixels, a quarter of a gigabyte of RGBA. */
+export const EXPORT_MAX_PIXELS = 64 * 1024 * 1024;
+/** What a raster is drawn at when nothing says otherwise: about a thousand pixels across. */
+const DEFAULT_RASTER = 1024;
+const DEFAULT_DPI = 300;
+/** The printed size when nothing else gives one. */
+export const DEFAULT_PRINT_MM = 25;
+const MIME = Object.freeze({
+    svg: 'image/svg+xml',
+    png: 'image/png',
+    jpeg: 'image/jpeg',
+    webp: 'image/webp',
+    pdf: 'application/pdf',
+    eps: 'application/postscript',
+});
+const EXTENSION = Object.freeze({
+    svg: 'svg',
+    png: 'png',
+    jpeg: 'jpg',
+    webp: 'webp',
+    pdf: 'pdf',
+    eps: 'eps',
+});
+const WHITE = { r: 255, g: 255, b: 255, a: 1 };
+function positive(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0;
+}
+function within(value, min, max) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= min && value <= max;
+}
+/** The options that fit, the design they change, and an issue for each that did not. */
+function checkOptions(input, options) {
+    const issues = [];
+    const bad = (option) => {
+        issues.push(issue(STUDIO_KEYS.exportOption, ['options', option], 'warning'));
+    };
+    const given = (typeof options === 'object' && options !== null ? options : {});
+    let design = input.design;
+    const out = {};
+    if (given.quietZone !== undefined) {
+        const zone = given.quietZone;
+        if (typeof zone === 'number' &&
+            Number.isInteger(zone) &&
+            zone >= 0 &&
+            zone <= LIMITS.quietZone) {
+            design = { ...design, quietZone: zone };
+            const minimum = MIN_QUIET_ZONE[input.symbol.symbology] ?? 4;
+            if (zone < minimum) {
+                issues.push(issue(STUDIO_KEYS.quietZoneBelowMinimum, ['options', 'quietZone'], 'warning', {
+                    min: minimum,
+                }));
+            }
+        }
+        else
+            bad('quietZone');
+    }
+    let sizeMm = design.output.sizeMm;
+    if (given.sizeMm !== undefined) {
+        if (!within(given.sizeMm, LIMITS.sizeMm.min, LIMITS.sizeMm.max))
+            bad('sizeMm');
+        else if (input.fixedSizeMm !== undefined && given.sizeMm !== input.fixedSizeMm) {
+            issues.push(issue(STUDIO_KEYS.exportSizeConstrained, ['options', 'sizeMm'], 'warning', {
+                size: input.fixedSizeMm,
+            }));
+        }
+        else
+            sizeMm = given.sizeMm;
+    }
+    // Only ever set to a number above, so a change is always to a size.
+    if (sizeMm !== design.output.sizeMm) {
+        design = { ...design, output: { ...design.output, sizeMm: sizeMm } };
+    }
+    if (given.widthPx !== undefined) {
+        const width = given.widthPx;
+        if (typeof width === 'number' &&
+            Number.isInteger(width) &&
+            width >= 1 &&
+            width <= EXPORT_MAX_SIDE) {
+            out.widthPx = width;
+        }
+        else
+            bad('widthPx');
+    }
+    if (given.dpi !== undefined) {
+        if (within(given.dpi, LIMITS.dpi.min, LIMITS.dpi.max))
+            out.dpi = given.dpi;
+        else
+            bad('dpi');
+    }
+    else if (design.output.dpi !== undefined)
+        out.dpi = design.output.dpi;
+    if (given.colourSpace !== undefined) {
+        if (given.colourSpace === 'srgb' || given.colourSpace === 'cmyk')
+            out.colourSpace = given.colourSpace;
+        else
+            bad('colourSpace');
+    }
+    if (given.bleedMm !== undefined) {
+        if (within(given.bleedMm, 0, 50))
+            out.bleedMm = given.bleedMm;
+        else
+            bad('bleedMm');
+    }
+    if (given.cropMarks !== undefined) {
+        if (typeof given.cropMarks === 'boolean')
+            out.cropMarks = given.cropMarks;
+        else
+            bad('cropMarks');
+    }
+    if (given.quality !== undefined) {
+        if (within(given.quality, 0, 1))
+            out.quality = given.quality;
+        else
+            bad('quality');
+    }
+    return { design, issues, options: out };
+}
+/** The scene's printed width and height in millimetres, when it has a physical size. */
+function physical(scene) {
+    const units = scene.unitsPerMm;
+    if (!positive(units))
+        return null;
+    return { width: scene.width / units, height: scene.height / units };
+}
+/** Pixels across for a raster of `scene`. */
+function rasterWidth(scene, widthPx, dpi) {
+    if (widthPx !== undefined)
+        return widthPx;
+    const size = physical(scene);
+    if (size !== null)
+        return Math.max(1, Math.round((size.width / 25.4) * (dpi ?? DEFAULT_DPI)));
+    // Whole pixels a module, so no module's edge falls across a pixel.
+    const perModule = Math.max(1, Math.ceil(DEFAULT_RASTER / scene.width));
+    return Math.max(1, Math.round(scene.width * perModule));
+}
+function tooLarge(width, height) {
+    return new QrStudioError('render/surface-too-large', 'That picture is too large to draw here. Choose a smaller size.', { width, height, maxPixels: EXPORT_MAX_PIXELS });
+}
+function unavailable(format) {
+    return new QrStudioError('render/format-unavailable', 'This browser cannot save in that format. Choose PNG or SVG.', { format });
+}
+async function raster(scene, format, checked, encoder) {
+    if (format !== 'png' && encoder === null)
+        return err(unavailable(format));
+    const width = rasterWidth(scene, checked.options.widthPx, checked.options.dpi);
+    const height = Math.max(1, Math.round((width * scene.height) / scene.width));
+    if (width > EXPORT_MAX_SIDE || height > EXPORT_MAX_SIDE || width * height > EXPORT_MAX_PIXELS) {
+        return err(tooLarge(width, height));
+    }
+    // JPEG has no transparency, and an encoder flattens onto black unasked.
+    const image = rasterise(scene, {
+        width,
+        height,
+        ...(format === 'jpeg' && scene.background === null ? { background: WHITE } : {}),
+    });
+    if (format === 'png') {
+        const size = physical(scene);
+        const dpi = size === null ? checked.options.dpi : (width / size.width) * 25.4;
+        return ok({ bytes: encodePng(image, dpi === undefined ? {} : { dpi }), width, height });
+    }
+    const encoded = await encoder.encode(image, format, checked.options.quality === undefined ? {} : { quality: checked.options.quality });
+    return encoded.ok ? ok({ bytes: encoded.value, width, height }) : encoded;
+}
+export async function exportSymbol(input, format, options) {
+    if (!Object.prototype.hasOwnProperty.call(MIME, format)) {
+        throw new TypeError('export: format is svg, png, jpeg, webp, pdf or eps.');
+    }
+    if ((format === 'pdf' || format === 'eps') && input.printer === null)
+        return err(unavailable(format));
+    const checked = checkOptions(input, options);
+    let built;
+    try {
+        built = buildScene(input.symbol, checked.design, {
+            registries: input.registries,
+            assets: input.assets,
+            fonts: input.fonts,
+            seed: input.seed,
+            overlay: input.overlay,
+        });
+    }
+    catch (thrown) {
+        return err(asStudioError(thrown, 'render/format-unavailable'));
+    }
+    let { scene } = built;
+    // A print format needs a size. With none from the options or the design,
+    // it is the scan conditions' (the symbol with its quiet zone, as they
+    // measure it) or 25 mm, set on the scene directly so the design's own
+    // size, and the basis it is measured on, are left alone.
+    if ((format === 'pdf' || format === 'eps') && physical(scene) === null) {
+        const sizeMm = input.conditions.sizeMm ?? DEFAULT_PRINT_MM;
+        scene = {
+            ...scene,
+            unitsPerMm: (input.symbol.matrix.width + 2 * checked.design.quietZone) / sizeMm,
+        };
+    }
+    const issues = [...built.issues, ...checked.issues];
+    const filename = exportName(checked.design.name, EXTENSION[format]);
+    const done = (bytes, width, height) => ok(Object.freeze({ filename, mime: MIME[format], bytes, width, height, issues }));
+    try {
+        switch (format) {
+            case 'svg':
+                return done(new TextEncoder().encode(sceneToSvg(scene)), scene.width, scene.height);
+            case 'png':
+            case 'jpeg':
+            case 'webp': {
+                const drawn = await raster(scene, format, checked, input.rasterEncoder);
+                return drawn.ok ? done(drawn.value.bytes, drawn.value.width, drawn.value.height) : drawn;
+            }
+            case 'pdf':
+            case 'eps': {
+                const printer = input.printer;
+                const size = physical(scene);
+                const colour = checked.options.colourSpace ?? checked.design.output.colourSpace;
+                if (format === 'pdf') {
+                    const bytes = printer.pdf(scene, {
+                        colour,
+                        widthMm: size.width,
+                        heightMm: size.height,
+                        ...(checked.options.bleedMm === undefined ? {} : { bleedMm: checked.options.bleedMm }),
+                        ...(checked.options.cropMarks === undefined
+                            ? {}
+                            : { cropMarks: checked.options.cropMarks }),
+                    });
+                    return done(bytes, size.width, size.height);
+                }
+                const text = printer.eps(scene, { colour, widthMm: size.width });
+                return done(new TextEncoder().encode(text), size.width, size.height);
+            }
+        }
+    }
+    catch (thrown) {
+        return err(asStudioError(thrown, 'render/format-unavailable'));
+    }
+}
+//# sourceMappingURL=export.js.map

package/dist/studio/export.js.map

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

package/dist/studio/form.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The form a view draws for a content type: its schema with the values, the
+ * issues sorted onto the fields they belong to, and the fields gathered into
+ * the groups and the disclosure the schema asks for.
+ *
+ * A view renders this and nothing else, so a content type added to the
+ * registry gets a working form in both interfaces without a line of view
+ * code. Field order is the schema's; a group is a run of consecutive fields
+ * sharing a `group`, which is how every built-in type lays its groups out.
+ */
+import type { Issue } from '../core/issue.js';
+import type { FieldValue, PayloadType } from '../payload/types.js';
+import type { FormView } from './types.js';
+export declare function formView(type: PayloadType, fields: Readonly<Record<string, FieldValue>>, issues: readonly Issue[]): FormView;
+//# sourceMappingURL=form.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/studio/form.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAiB,MAAM,qBAAqB,CAAC;AAGlF,OAAO,KAAK,EAA6B,QAAQ,EAAE,MAAM,YAAY,CAAC;AAoBtE,wBAAgB,QAAQ,CACvB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,EAC5C,MAAM,EAAE,SAAS,KAAK,EAAE,GACtB,QAAQ,CAmEV"}