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

package/dist/design/paint.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Design paints to scene paints.
+ *
+ * A design says what a gradient means relative to the thing it fills ("left
+ * to right across the symbol", "from the centre of each module"); a scene
+ * says where, in user units. This is the one place the first becomes the
+ * second, so the SVG, the raster and the scan check all see the same
+ * gradient.
+ *
+ * Angles are degrees, 0 pointing right and growing clockwise as seen with y
+ * down, which is how `render` and `geometry` turn as well. A linear gradient
+ * runs through the centre of its box and is just long enough that the box's
+ * corners land on its first and last stops, as a CSS linear-gradient is.
+ * Radial and conic centres and the radial radius are fractions of the box;
+ * the radius is a fraction of the box's longer side, so a radius of 0.5
+ * reaches the edges of a square symbol and the ends of a rectangular one.
+ */
+import type { Prng } from '../core/prng.js';
+import type { Registry } from '../core/registry.js';
+import type { Colour, ScenePaint, Stop } from '../render/types.js';
+import type { Box, DesignPaint, FillEntry, Ink } from './types.js';
+/** An ink as a scene colour, with its print value carried beside the screen one. */
+export declare function inkColour(ink: Ink): Colour;
+/**
+ * The unit vector for an angle, exact at whole quarter turns.
+ *
+ * cos(pi / 2) in floating point is 6e-17, not zero, and a vertical gradient
+ * built from it would put its ends a hair off the box's edges in the SVG.
+ */
+export declare function direction(degrees: number): readonly [number, number];
+/**
+ * A linear gradient through the centre of `box` at `angle`, just long enough
+ * that the box's corners land on its ends.
+ */
+export declare function linearPaint(angle: number, list: readonly Stop[], box: Box): ScenePaint;
+/**
+ * Whether a paint is worked out once over its whole box or once per module.
+ * An entry fill says which it is; a missing entry counts as the whole box,
+ * since the builder will have replaced it.
+ */
+export declare function paintSpace(paint: DesignPaint, fills: Registry<FillEntry>): 'symbol' | 'module';
+/**
+ * The scene paint for `paint` filling `box`. An entry fill must be in
+ * `fills`; the scene builder checks that before it gets here.
+ */
+export declare function resolvePaint(paint: DesignPaint, box: Box, fills: Registry<FillEntry>, prng: Prng): ScenePaint;
+//# sourceMappingURL=paint.d.ts.map

package/dist/design/paint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../src/design/paint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAc,SAAS,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAE/E,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAO1C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAQpE;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,GAAG,UAAU,CAatF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,QAAQ,GAAG,QAAQ,CAI9F;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC1B,IAAI,EAAE,IAAI,GACR,UAAU,CA2BZ"}

package/dist/design/paint.js

@@ -0,0 +1,115 @@
+/**
+ * Design paints to scene paints.
+ *
+ * A design says what a gradient means relative to the thing it fills ("left
+ * to right across the symbol", "from the centre of each module"); a scene
+ * says where, in user units. This is the one place the first becomes the
+ * second, so the SVG, the raster and the scan check all see the same
+ * gradient.
+ *
+ * Angles are degrees, 0 pointing right and growing clockwise as seen with y
+ * down, which is how `render` and `geometry` turn as well. A linear gradient
+ * runs through the centre of its box and is just long enough that the box's
+ * corners land on its first and last stops, as a CSS linear-gradient is.
+ * Radial and conic centres and the radial radius are fractions of the box;
+ * the radius is a fraction of the box's longer side, so a radius of 0.5
+ * reaches the edges of a square symbol and the ends of a rectangular one.
+ */
+import { PI, cos, sin } from '../core/math.js';
+import { parseColour } from '../render/colour.js';
+import { resolveParams } from './params.js';
+/** An ink as a scene colour, with its print value carried beside the screen one. */
+export function inkColour(ink) {
+    if (typeof ink === 'string')
+        return parseColour(ink);
+    const colour = parseColour(ink.srgb);
+    return {
+        ...colour,
+        cmyk: [ink.cmyk[0], ink.cmyk[1], ink.cmyk[2], ink.cmyk[3]],
+    };
+}
+/**
+ * The unit vector for an angle, exact at whole quarter turns.
+ *
+ * cos(pi / 2) in floating point is 6e-17, not zero, and a vertical gradient
+ * built from it would put its ends a hair off the box's edges in the SVG.
+ */
+export function direction(degrees) {
+    const reduced = ((degrees % 360) + 360) % 360;
+    if (reduced === 0)
+        return [1, 0];
+    if (reduced === 90)
+        return [0, 1];
+    if (reduced === 180)
+        return [-1, 0];
+    if (reduced === 270)
+        return [0, -1];
+    const radians = reduced * (PI / 180);
+    return [cos(radians), sin(radians)];
+}
+function stops(list) {
+    return list.map((stop) => ({ offset: stop.offset, colour: inkColour(stop.ink) }));
+}
+/**
+ * A linear gradient through the centre of `box` at `angle`, just long enough
+ * that the box's corners land on its ends.
+ */
+export function linearPaint(angle, list, box) {
+    const [dx, dy] = direction(angle);
+    const half = (box.width * Math.abs(dx) + box.height * Math.abs(dy)) / 2;
+    const cx = box.x + box.width / 2;
+    const cy = box.y + box.height / 2;
+    return {
+        kind: 'linear',
+        x1: cx - dx * half,
+        y1: cy - dy * half,
+        x2: cx + dx * half,
+        y2: cy + dy * half,
+        stops: list,
+    };
+}
+/**
+ * Whether a paint is worked out once over its whole box or once per module.
+ * An entry fill says which it is; a missing entry counts as the whole box,
+ * since the builder will have replaced it.
+ */
+export function paintSpace(paint, fills) {
+    if (paint.kind === 'solid')
+        return 'symbol';
+    if (paint.kind === 'entry')
+        return fills.get(paint.ref.id)?.space ?? 'symbol';
+    return paint.space;
+}
+/**
+ * The scene paint for `paint` filling `box`. An entry fill must be in
+ * `fills`; the scene builder checks that before it gets here.
+ */
+export function resolvePaint(paint, box, fills, prng) {
+    switch (paint.kind) {
+        case 'solid':
+            return { kind: 'solid', colour: inkColour(paint.ink) };
+        case 'linear':
+            return linearPaint(paint.angle, stops(paint.stops), box);
+        case 'radial':
+            return {
+                kind: 'radial',
+                cx: box.x + paint.cx * box.width,
+                cy: box.y + paint.cy * box.height,
+                r: paint.radius * Math.max(box.width, box.height),
+                stops: stops(paint.stops),
+            };
+        case 'conic':
+            return {
+                kind: 'conic',
+                cx: box.x + paint.cx * box.width,
+                cy: box.y + paint.cy * box.height,
+                angle: paint.angle,
+                stops: stops(paint.stops),
+            };
+        case 'entry': {
+            const entry = fills.require(paint.ref.id);
+            return entry.resolve(resolveParams(entry.params, paint.ref.params), box, prng);
+        }
+    }
+}
+//# sourceMappingURL=paint.js.map

package/dist/design/paint.js.map

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

package/dist/design/params.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Entry parameters: checking a value against its schema and filling in the
+ * defaults.
+ *
+ * A design file names an entry and some of its parameters, and the entry
+ * draws with all of them. The two places that need the full set (the
+ * validator and the scene builder) must agree about which given values count,
+ * so both go through `paramProblem`: a value either fits its schema exactly or
+ * is not used at all. Nothing is clamped here; a slider value one step past
+ * its range is a problem to report, not a number to quietly move.
+ */
+import type { ParamSchema, ResolvedParams } from './types.js';
+/** Why a value does not fit its schema, as a message key and the numbers a sentence needs. */
+export interface ParamProblem {
+    readonly code: string;
+    readonly params?: Readonly<Record<string, number>>;
+}
+/** Null when `value` fits `schema`, otherwise what is wrong with it. Never the value itself. */
+export declare function paramProblem(schema: ParamSchema, value: unknown): ParamProblem | null;
+/**
+ * Every parameter of an entry: the given value where it fits its schema, the
+ * default otherwise. Keys the schema does not name are left out. Frozen, so
+ * an entry cannot change what the next module receives.
+ */
+export declare function resolveParams(schema: readonly ParamSchema[], given: Readonly<Record<string, unknown>> | undefined): ResolvedParams;
+/** A number parameter, for an entry's own use: its schema guarantees the kind. */
+export declare function num(params: ResolvedParams, key: string): number;
+/** A string parameter (select or colour). */
+export declare function str(params: ResolvedParams, key: string): string;
+//# sourceMappingURL=params.d.ts.map

package/dist/design/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/design/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAc,cAAc,EAAE,MAAM,YAAY,CAAC;AAE1E,8FAA8F;AAC9F,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAUD,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAmCrF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GAClD,cAAc,CAahB;AAED,kFAAkF;AAClF,wBAAgB,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,6CAA6C;AAC7C,wBAAgB,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/dist/design/params.js

@@ -0,0 +1,85 @@
+/**
+ * Entry parameters: checking a value against its schema and filling in the
+ * defaults.
+ *
+ * A design file names an entry and some of its parameters, and the entry
+ * draws with all of them. The two places that need the full set (the
+ * validator and the scene builder) must agree about which given values count,
+ * so both go through `paramProblem`: a value either fits its schema exactly or
+ * is not used at all. Nothing is clamped here; a slider value one step past
+ * its range is a problem to report, not a number to quietly move.
+ */
+import { parseColour } from '../render/colour.js';
+/** The bounds of a schema that has at least one, as a sentence's numbers. */
+function range(schema) {
+    const out = {};
+    if (schema.min !== undefined)
+        out.min = schema.min;
+    if (schema.max !== undefined)
+        out.max = schema.max;
+    return out;
+}
+/** Null when `value` fits `schema`, otherwise what is wrong with it. Never the value itself. */
+export function paramProblem(schema, value) {
+    switch (schema.kind) {
+        case 'number':
+        case 'angle':
+        case 'integer': {
+            if (typeof value !== 'number' || !Number.isFinite(value)) {
+                return { code: 'design.issue.not-a-number' };
+            }
+            if (schema.kind === 'integer' && !Number.isInteger(value)) {
+                return { code: 'design.issue.not-an-integer' };
+            }
+            if ((schema.min !== undefined && value < schema.min) ||
+                (schema.max !== undefined && value > schema.max)) {
+                return { code: 'design.issue.out-of-range', params: range(schema) };
+            }
+            return null;
+        }
+        case 'boolean':
+            return typeof value === 'boolean' ? null : { code: 'design.issue.not-a-boolean' };
+        case 'select':
+            return typeof value === 'string' &&
+                (schema.options ?? []).some((option) => option.value === value)
+                ? null
+                : { code: 'design.issue.invalid-option' };
+        case 'colour':
+            if (typeof value !== 'string')
+                return { code: 'design.issue.invalid-colour' };
+            try {
+                parseColour(value);
+                return null;
+            }
+            catch {
+                return { code: 'design.issue.invalid-colour' };
+            }
+    }
+}
+/**
+ * Every parameter of an entry: the given value where it fits its schema, the
+ * default otherwise. Keys the schema does not name are left out. Frozen, so
+ * an entry cannot change what the next module receives.
+ */
+export function resolveParams(schema, given) {
+    const out = {};
+    for (const entry of schema) {
+        const value = given !== undefined && Object.prototype.hasOwnProperty.call(given, entry.key)
+            ? given[entry.key]
+            : undefined;
+        out[entry.key] =
+            value !== undefined && paramProblem(entry, value) === null
+                ? value
+                : entry.default;
+    }
+    return Object.freeze(out);
+}
+/** A number parameter, for an entry's own use: its schema guarantees the kind. */
+export function num(params, key) {
+    return params[key];
+}
+/** A string parameter (select or colour). */
+export function str(params, key) {
+    return params[key];
+}
+//# sourceMappingURL=params.js.map

package/dist/design/params.js.map

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

package/dist/design/preset-size.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The size a preset is promised to scan at, for the level a design asks for.
+ *
+ * A preset's `minSizeMm` is measured at its own level. Raising the level
+ * makes the same content take a larger symbol, whose modules are smaller at
+ * the same printed width, so each allowed level has a size of its own
+ * (`sizesMm`). Anything that suggests or defaults a print size from a preset
+ * asks here with the level the design will be built at.
+ */
+import type { EcLevel } from '../segment/types.js';
+import type { Preset } from './types.js';
+/** The smallest printed width, in millimetres, `preset` scans at with `level` (default its own). */
+export declare function presetSizeMm(preset: Preset, level?: EcLevel): number;
+//# sourceMappingURL=preset-size.d.ts.map

package/dist/design/preset-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-size.d.ts","sourceRoot":"","sources":["../../src/design/preset-size.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAEpE"}

package/dist/design/preset-size.js

@@ -0,0 +1,14 @@
+/**
+ * The size a preset is promised to scan at, for the level a design asks for.
+ *
+ * A preset's `minSizeMm` is measured at its own level. Raising the level
+ * makes the same content take a larger symbol, whose modules are smaller at
+ * the same printed width, so each allowed level has a size of its own
+ * (`sizesMm`). Anything that suggests or defaults a print size from a preset
+ * asks here with the level the design will be built at.
+ */
+/** The smallest printed width, in millimetres, `preset` scans at with `level` (default its own). */
+export function presetSizeMm(preset, level) {
+    return level === undefined ? preset.minSizeMm : (preset.sizesMm?.[level] ?? preset.minSizeMm);
+}
+//# sourceMappingURL=preset-size.js.map

package/dist/design/preset-size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-size.js","sourceRoot":"","sources":["../../src/design/preset-size.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,oGAAoG;AACpG,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,KAAe;IAC3D,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;AAC/F,CAAC"}

package/dist/design/registries.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The design registries, filled with the built-ins.
+ *
+ * Fresh instances every call, so a caller that registers a shape of its own
+ * changes no other registry, and nothing is registered at import.
+ */
+import type { DesignRegistries } from './types.js';
+export declare function createDesignRegistries(): DesignRegistries;
+//# sourceMappingURL=registries.d.ts.map

package/dist/design/registries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registries.d.ts","sourceRoot":"","sources":["../../src/design/registries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,wBAAgB,sBAAsB,IAAI,gBAAgB,CASzD"}

package/dist/design/registries.js

@@ -0,0 +1,24 @@
+/**
+ * The design registries, filled with the built-ins.
+ *
+ * Fresh instances every call, so a caller that registers a shape of its own
+ * changes no other registry, and nothing is registered at import.
+ */
+import { Registry } from '../core/registry.js';
+import { BUILT_IN_FILLS } from './catalogue/fills.js';
+import { BUILT_IN_FRAMES } from './catalogue/frames.js';
+import { builtInIcons } from './catalogue/icons.js';
+import { BUILT_IN_MODULE_SHAPES } from './catalogue/module-shapes.js';
+import { builtInPresets } from './catalogue/presets.js';
+import { BUILT_IN_REGION_SHAPES } from './catalogue/region-shapes.js';
+export function createDesignRegistries() {
+    return {
+        moduleShapes: new Registry('module-shape', BUILT_IN_MODULE_SHAPES),
+        regionShapes: new Registry('region-shape', BUILT_IN_REGION_SHAPES),
+        fills: new Registry('fill', BUILT_IN_FILLS),
+        frames: new Registry('frame', BUILT_IN_FRAMES),
+        icons: new Registry('icon', builtInIcons()),
+        presets: new Registry('preset', builtInPresets()),
+    };
+}
+//# sourceMappingURL=registries.js.map

package/dist/design/registries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registries.js","sourceRoot":"","sources":["../../src/design/registries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,MAAM,UAAU,sBAAsB;IACrC,OAAO;QACN,YAAY,EAAE,IAAI,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAC;QAClE,YAAY,EAAE,IAAI,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAC;QAClE,KAAK,EAAE,IAAI,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;QAC3C,MAAM,EAAE,IAAI,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;QAC9C,KAAK,EAAE,IAAI,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;QAC3C,OAAO,EAAE,IAAI,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAC;KACjD,CAAC;AACH,CAAC"}

package/dist/design/scene.d.ts

@@ -0,0 +1,38 @@
+/**
+ * A built symbol and a design, to a scene.
+ *
+ * The layers go down in this order: the frame's own artwork (beneath
+ * everything), the background, light modules when the design draws them,
+ * dark modules, finder rings, finder centres, the logo's plate, the logo,
+ * the content's overlay (the Swiss QR-bill's cross, when the context names
+ * it), whatever the frame draws on top, and the frame's caption. Units are
+ * modules, the quiet zone included, so a module is one unit wide whatever
+ * the export's size.
+ *
+ * Finder, separator and the rMQR sub-finder and corner modules are drawn by
+ * the region shapes, and so are QR's 5 by 5 alignment patterns, in the
+ * finder's style (see `alignmentRegions` for why). Every other dark module
+ * (data, timing, format and version information, the dark module, rMQR's
+ * small alignment patterns) is drawn by the module shape. A connecting
+ * shape's neighbours are counted over the modules the module shape draws, so
+ * a bar never reaches into a finder and a fluid blob never bulges towards
+ * one.
+ *
+ * Micro QR and rMQR, read by one finder rather than three, keep their rings
+ * square and their small patterns plain, and rMQR is drawn without a frame:
+ * each is measured below where it is done.
+ *
+ * The same symbol, design and seed always give the same scene, and so the
+ * same SVG bytes: every random choice comes from a stream forked off the
+ * seed by a fixed label, and nothing iterates a structure whose order could
+ * vary.
+ *
+ * Anything that cannot be drawn as asked (an entry this registry lacks, a
+ * parameter out of its range, a ring that does not support the region's
+ * kind) is drawn the plain way instead, with an issue saying so; the scene
+ * is never refused. `validateDesign` reports the same problems up front.
+ */
+import type { BuiltSymbol } from '../symbology/types.js';
+import type { BuildContext, BuiltScene, QrDesignV1 } from './types.js';
+export declare function buildScene(symbol: BuiltSymbol, design: QrDesignV1, context: BuildContext): BuiltScene;
+//# sourceMappingURL=scene.d.ts.map

package/dist/design/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/design/scene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAaH,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,uBAAuB,CAAC;AAU1E,OAAO,KAAK,EAEX,YAAY,EACZ,UAAU,EASV,UAAU,EAIV,MAAM,YAAY,CAAC;AA2RpB,wBAAgB,UAAU,CACzB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,YAAY,GACnB,UAAU,CAyTZ"}