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

package/dist/design/canonical.js

@@ -0,0 +1,100 @@
+/**
+ * Canonical JSON for designs: the same design always writes the same text.
+ *
+ * JSON.stringify writes keys in the order they were added, so two equal
+ * designs built in different orders would give two different links. Here
+ * every key the schema knows has a fixed rank, keys it does not know
+ * (parameter names, embedded image ids) follow in code unit order, and
+ * numbers are written as ECMAScript specifies them, which is the same in
+ * every engine.
+ */
+const ORDER = [
+    'schema',
+    'version',
+    'name',
+    'symbol',
+    'symbology',
+    'ecLevel',
+    'boostEc',
+    'minVersion',
+    'maxVersion',
+    'mask',
+    'segmentation',
+    'kanji',
+    'eci',
+    'quietZone',
+    'background',
+    'modules',
+    'shape',
+    'paint',
+    'light',
+    'regions',
+    'finder',
+    'sub-finder',
+    'corner-finder',
+    'outer',
+    'inner',
+    'outerPaint',
+    'innerPaint',
+    'logo',
+    'source',
+    'size',
+    'clear',
+    'padding',
+    'plate',
+    'frame',
+    'ref',
+    'text',
+    'content',
+    'fontId',
+    'output',
+    'sizeMm',
+    'sizeBasis',
+    'dpi',
+    'colourSpace',
+    'assets',
+    'png',
+    'width',
+    'height',
+    'kind',
+    'id',
+    'params',
+    'ink',
+    'srgb',
+    'cmyk',
+    'angle',
+    'cx',
+    'cy',
+    'radius',
+    'stops',
+    'offset',
+    'space',
+];
+const RANK = new Map(ORDER.map((key, i) => [key, i]));
+function compare(a, b) {
+    const ra = RANK.get(a);
+    const rb = RANK.get(b);
+    if (ra !== undefined && rb !== undefined)
+        return ra - rb;
+    if (ra !== undefined)
+        return -1;
+    if (rb !== undefined)
+        return 1;
+    // An object's keys are distinct, so two never compare equal.
+    return a < b ? -1 : 1;
+}
+/** The value as canonical JSON. Keys whose value is undefined are left out, as JSON leaves them. */
+export function canonicalJson(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => (item === undefined ? 'null' : canonicalJson(item))).join(',')}]`;
+    }
+    if (typeof value === 'object' && value !== null) {
+        const record = value;
+        const keys = Object.keys(record)
+            .filter((key) => record[key] !== undefined)
+            .sort(compare);
+        return `{${keys.map((key) => `${JSON.stringify(key)}:${canonicalJson(record[key])}`).join(',')}}`;
+    }
+    return JSON.stringify(value) ?? 'null';
+}
+//# sourceMappingURL=canonical.js.map

package/dist/design/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../../src/design/canonical.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,KAAK,GAAsB;IAChC,QAAQ;IACR,SAAS;IACT,MAAM;IACN,QAAQ;IACR,WAAW;IACX,SAAS;IACT,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,MAAM;IACN,cAAc;IACd,OAAO;IACP,KAAK;IACL,WAAW;IACX,YAAY;IACZ,SAAS;IACT,OAAO;IACP,OAAO;IACP,OAAO;IACP,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,eAAe;IACf,OAAO;IACP,OAAO;IACP,YAAY;IACZ,YAAY;IACZ,MAAM;IACN,QAAQ;IACR,MAAM;IACN,OAAO;IACP,SAAS;IACT,OAAO;IACP,OAAO;IACP,KAAK;IACL,MAAM;IACN,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,KAAK;IACL,aAAa;IACb,QAAQ;IACR,KAAK;IACL,OAAO;IACP,QAAQ;IACR,MAAM;IACN,IAAI;IACJ,QAAQ;IACR,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,IAAI;IACJ,IAAI;IACJ,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,OAAO;CACP,CAAC;AAEF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtD,SAAS,OAAO,CAAC,CAAS,EAAE,CAAS;IACpC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IACzD,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,CAAC;IAChC,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAC/B,6DAA6D;IAC7D,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,aAAa,CAAC,KAAc;IAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAClG,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aAC9B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;aAC1C,IAAI,CAAC,OAAO,CAAC,CAAC;QAChB,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACnG,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC;AACxC,CAAC"}

package/dist/design/caption.d.ts

@@ -0,0 +1,54 @@
+/**
+ * A frame's caption, set by the text layer into the box the frame reserves.
+ *
+ * The caption becomes filled paths in the scene, never live text, so an SVG,
+ * a PNG, a PDF and an EPS of one design all carry the same outlines, the scan
+ * check sees exactly what is printed, and nothing in a file can be searched
+ * or copied back out of it.
+ *
+ * It is set as large as the box allows: one line filling the box's height,
+ * shrunk until it fits on the frame's lines, down to a floor of half the size
+ * at which those lines fill the box. Past the floor it is drawn at the floor,
+ * clipped to the box so it never reaches the quiet zone, with a warning. A
+ * character the font cannot draw is left out and reported, never swapped for
+ * one from another font, because a caption that silently says something else
+ * is worse than one that says what is missing.
+ *
+ * Unless the design paints it, the caption takes the frame's ink for where
+ * it sits: on the frame's own artwork (a banner's band, a card's foot) it is
+ * knocked out in the design's background, white when that is transparent, as
+ * the quiet zone is; beside the artwork (under corner brackets, beside a
+ * speech bubble's tail) it is drawn in the frame's paint. Which of the two a
+ * box is, is measured from the frame's drawing rather than declared, so a
+ * frame written to the contract alone gets the right one.
+ *
+ * Nothing here puts the caption's text into an issue or a title: an issue
+ * carries a count at most.
+ */
+import type { Issue } from '../core/issue.js';
+import type { Prng } from '../core/prng.js';
+import type { SceneNode, ScenePaint } from '../render/types.js';
+import type { FontRegistry } from '../text/types.js';
+import type { DesignFrame, DesignPaint, DesignRegistries, FrameEntry, FrameLayout } from './types.js';
+/** Code points, so a caption's length is what a person counts. */
+export declare function codePoints(text: string): number;
+export interface CaptionContext {
+    readonly frame: FrameEntry;
+    readonly layout: FrameLayout;
+    readonly text: NonNullable<DesignFrame['text']>;
+    readonly fonts: FontRegistry | undefined;
+    readonly registries: DesignRegistries;
+    /** The frame's paint as drawn, for a caption beside the artwork. */
+    readonly framePaint: ScenePaint;
+    /** The design's background, already checked, or null when it is transparent. */
+    readonly background: DesignPaint | null;
+    /** Checks an entry paint: null, with an issue, when its fill is missing. */
+    readonly paint: (paint: DesignPaint) => DesignPaint | null;
+    readonly prng: Prng;
+}
+/** The caption as scene nodes for the frame's `over` layer, and what went wrong setting it. */
+export declare function drawCaption(ctx: CaptionContext): {
+    readonly nodes: readonly SceneNode[];
+    readonly issues: readonly Issue[];
+};
+//# sourceMappingURL=caption.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"caption.d.ts","sourceRoot":"","sources":["../../src/design/caption.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,KAAK,EACX,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,MAAM,YAAY,CAAC;AAWpB,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW/C;AAiDD,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,GAAG,IAAI,CAAC;IAC3D,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACpB;AAED,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG;IACjD,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;CAClC,CA6EA"}

package/dist/design/caption.js

@@ -0,0 +1,175 @@
+/**
+ * A frame's caption, set by the text layer into the box the frame reserves.
+ *
+ * The caption becomes filled paths in the scene, never live text, so an SVG,
+ * a PNG, a PDF and an EPS of one design all carry the same outlines, the scan
+ * check sees exactly what is printed, and nothing in a file can be searched
+ * or copied back out of it.
+ *
+ * It is set as large as the box allows: one line filling the box's height,
+ * shrunk until it fits on the frame's lines, down to a floor of half the size
+ * at which those lines fill the box. Past the floor it is drawn at the floor,
+ * clipped to the box so it never reaches the quiet zone, with a warning. A
+ * character the font cannot draw is left out and reported, never swapped for
+ * one from another font, because a caption that silently says something else
+ * is worse than one that says what is missing.
+ *
+ * Unless the design paints it, the caption takes the frame's ink for where
+ * it sits: on the frame's own artwork (a banner's band, a card's foot) it is
+ * knocked out in the design's background, white when that is transparent, as
+ * the quiet zone is; beside the artwork (under corner brackets, beside a
+ * speech bubble's tail) it is drawn in the frame's paint. Which of the two a
+ * box is, is measured from the frame's drawing rather than declared, so a
+ * frame written to the contract alone gets the right one.
+ *
+ * Nothing here puts the caption's text into an issue or a title: an issue
+ * carries a count at most.
+ */
+import { issue } from '../core/issue.js';
+import { PathBuilder } from '../geometry/path.js';
+import { rasterise } from '../render/raster.js';
+import { layoutText } from '../text/layout.js';
+import { createFontRegistry } from '../text/registry.js';
+import { LIMITS } from './document.js';
+import { resolvePaint } from './paint.js';
+/** CSS's usual line height, the least a caption is set at. */
+const MIN_LINE_HEIGHT = 1.2;
+/** Pixels across the caption box when measuring whether it sits on the frame's artwork. */
+const ON_ARTWORK_SAMPLES = 24;
+/** The most pixels that measurement draws, however small the box is against the artwork. */
+const ON_ARTWORK_PIXELS = 16384;
+const WHITE = { kind: 'solid', ink: '#ffffff' };
+/** Code points, so a caption's length is what a person counts. */
+export function codePoints(text) {
+    let count = 0;
+    for (let i = 0; i < text.length; i += 1) {
+        const unit = text.charCodeAt(i);
+        if (unit >= 0xd800 && unit <= 0xdbff) {
+            const next = text.charCodeAt(i + 1);
+            if (next >= 0xdc00 && next <= 0xdfff)
+                i += 1;
+        }
+        count += 1;
+    }
+    return count;
+}
+/**
+ * Whether most of the caption box is covered by the frame's own drawing.
+ *
+ * The frame is drawn alone at about ON_ARTWORK_SAMPLES pixels across the box,
+ * and the coverage of the pixels whose centres fall in the box is averaged.
+ * A box thinner than a pixel is judged by the pixel at its centre.
+ */
+function onArtwork(layout, box) {
+    const scale = Math.min(ON_ARTWORK_SAMPLES / box.width, Math.sqrt(ON_ARTWORK_PIXELS / (layout.width * layout.height)));
+    const width = Math.max(1, Math.ceil(layout.width * scale));
+    const height = Math.max(1, Math.ceil(layout.height * scale));
+    // The scene is sized to whole pixels at exactly `scale`, so a pixel's
+    // centre maps back to the frame's units without rounding.
+    const image = rasterise({
+        width: width / scale,
+        height: height / scale,
+        background: null,
+        layers: [...layout.nodes, ...(layout.over ?? [])],
+    }, { width, height });
+    const alpha = (x, y) => image.data[(y * width + x) * 4 + 3] / 255;
+    let sum = 0;
+    let count = 0;
+    const x0 = Math.max(0, Math.ceil(box.x * scale - 0.5));
+    const x1 = Math.min(width - 1, Math.floor((box.x + box.width) * scale - 0.5));
+    const y0 = Math.max(0, Math.ceil(box.y * scale - 0.5));
+    const y1 = Math.min(height - 1, Math.floor((box.y + box.height) * scale - 0.5));
+    for (let y = y0; y <= y1; y += 1) {
+        for (let x = x0; x <= x1; x += 1) {
+            sum += alpha(x, y);
+            count += 1;
+        }
+    }
+    if (count === 0) {
+        const cx = Math.min(width - 1, Math.floor((box.x + box.width / 2) * scale));
+        const cy = Math.min(height - 1, Math.floor((box.y + box.height / 2) * scale));
+        return alpha(cx, cy) >= 0.5;
+    }
+    return sum / count >= 0.5;
+}
+/** The caption as scene nodes for the frame's `over` layer, and what went wrong setting it. */
+export function drawCaption(ctx) {
+    const { frame, layout, text } = ctx;
+    const at = ['frame', 'text'];
+    const issues = [];
+    const box = layout.textBox;
+    const limits = frame.text;
+    if (limits === null || box === null || !(box.width > 0) || !(box.height > 0)) {
+        issues.push(issue('design.issue.caption-unsupported', at, 'warning'));
+        return { nodes: [], issues };
+    }
+    const length = codePoints(text.content);
+    const max = Math.min(limits.maxChars, LIMITS.caption);
+    if (length > max) {
+        // validateDesign refuses this; a design that skipped it is drawn
+        // without the caption rather than with one the frame cannot hold.
+        issues.push(issue('design.issue.too-long', [...at, 'content'], 'warning', { length, max }));
+        return { nodes: [], issues };
+    }
+    const fonts = ctx.fonts ?? createFontRegistry();
+    const font = fonts.get(text.fontId);
+    if (font === undefined) {
+        issues.push(issue('design.issue.font-unavailable', [...at, 'fontId'], 'warning'));
+        return { nodes: [], issues };
+    }
+    // The line is at least as tall as the font's own line box, so no glyph
+    // reaches past the caption box while the caption fits it.
+    const lineHeight = Math.max(MIN_LINE_HEIGHT, (font.ascender - font.descender) / font.unitsPerEm);
+    const size = box.height / lineHeight;
+    const result = layoutText(text.content, {
+        fonts,
+        fontId: font.id,
+        size,
+        box,
+        align: box.align,
+        maxLines: limits.maxLines,
+        lineHeight,
+        shrinkToFit: true,
+        minSize: size / (2 * limits.maxLines),
+    });
+    if (result.missing.length > 0) {
+        issues.push(issue('design.issue.caption-missing-glyphs', [...at, 'content'], 'warning', {
+            count: result.missing.length,
+        }));
+    }
+    if (result.overflow)
+        issues.push(issue('design.issue.caption-overflow', [...at, 'content'], 'warning'));
+    const out = new PathBuilder();
+    for (const path of result.paths)
+        out.append(path);
+    if (out.empty)
+        return { nodes: [], issues };
+    // A paint whose fill this registry lacks falls back to the frame's ink,
+    // as a missing paint anywhere else falls back to the plain one.
+    const area = { x: box.x, y: box.y, width: box.width, height: box.height };
+    const own = text.paint === undefined ? null : ctx.paint(text.paint);
+    let paint;
+    if (own !== null)
+        paint = resolvePaint(own, area, ctx.registries.fills, ctx.prng);
+    else if (onArtwork(layout, box)) {
+        paint = resolvePaint(ctx.background ?? WHITE, area, ctx.registries.fills, ctx.prng);
+    }
+    else
+        paint = ctx.framePaint;
+    const node = { kind: 'path', path: out.build(), paint, role: 'caption' };
+    if (!result.overflow)
+        return { nodes: [node], issues };
+    // What does not fit is cut at the box, which the frame keeps clear of
+    // the quiet zone.
+    return {
+        nodes: [
+            {
+                kind: 'group',
+                children: [node],
+                clip: new PathBuilder().rect(box.x, box.y, box.width, box.height).build(),
+            },
+        ],
+        issues,
+    };
+}
+//# sourceMappingURL=caption.js.map

package/dist/design/caption.js.map

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

package/dist/design/catalogue/draw.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Drawing helpers shared by the built-in entries.
+ *
+ * Every built-in is a filled outline under the nonzero rule, so a hole is a
+ * contour wound the other way and a union is two contours wound the same
+ * way. `Contour` records an outline once and can write it either way round,
+ * which is all a ring needs: the outer edge clockwise, the same kind of edge
+ * a module in, anticlockwise.
+ *
+ * Clockwise means as seen with y down, the way `PathBuilder.rect` and
+ * `circle` wind. Arcs are cubic Beziers of at most a quarter turn each, with
+ * the control distance 4/3 tan(t / 4) that puts each piece's midpoint on the
+ * circle; quarter-turn end points are exact, so a ring drawn this way meets
+ * the module grid where the grid is.
+ */
+import type { PathBuilder } from '../../geometry/path.js';
+/** One closed outline, kept as segments so it can be written in either direction. */
+export declare class Contour {
+    private readonly startX;
+    private readonly startY;
+    private atX;
+    private atY;
+    private readonly segments;
+    constructor(x: number, y: number);
+    lineTo(x: number, y: number): this;
+    cubicTo(c1x: number, c1y: number, c2x: number, c2y: number, x: number, y: number): this;
+    /**
+     * An arc of the circle about (cx, cy) from `from` to `to` degrees, growing
+     * clockwise when `to` is larger. Joins from the current point with a line
+     * if the arc does not start there.
+     */
+    arc(cx: number, cy: number, r: number, from: number, to: number): this;
+    /** Write the outline into `out`, closed, in the order it was drawn or reversed. */
+    emit(out: PathBuilder, reverse?: boolean): void;
+}
+/** A rectangle with four corner radii, top left first, clockwise. */
+export declare function roundedBox(x: number, y: number, w: number, h: number, radii: readonly [number, number, number, number]): Contour;
+/** A circle as four quarter arcs, starting at the top. */
+export declare function circleContour(cx: number, cy: number, r: number): Contour;
+/**
+ * A superellipse of exponent about four, as four cubics.
+ *
+ * The control factor 0.909 puts each quarter's midpoint where |x|^4 + |y|^4
+ * = 1 has it (at 2^-1/4 of the half size on both axes), which is the
+ * squircle's defining point; the rest stays within half a percent of the true
+ * curve.
+ */
+export declare function squircleContour(cx: number, cy: number, rx: number, ry: number): Contour;
+/** A closed polygon through x, y pairs, in the order given. */
+export declare function polygonContour(points: readonly number[]): Contour;
+/** A rectangle with each corner cut at 45 degrees by `cut` along both edges. */
+export declare function octagonContour(x: number, y: number, w: number, h: number, cut: number): Contour;
+/**
+ * A rectangle with a concave quarter circle of radius `bite` taken out of
+ * each corner, centred on the corner. A bite reaching past the box's edges is
+ * clamped to half the shorter side.
+ */
+export declare function scoopedContour(x: number, y: number, w: number, h: number, bite: number): Contour;
+/**
+ * The hole of a ring whose outer edge is `scoopedContour(x, y, w, h, bite)`,
+ * one module in, keeping the ring one module thick round the bites too: the
+ * box inset by one with each corner cut by an arc of radius bite + 1 about the
+ * outer corner. Wound clockwise; emit it reversed.
+ */
+export declare function scoopedHole(x: number, y: number, w: number, h: number, bite: number): Contour;
+/** A regular star polygon: `points` tips at radius `outer`, notches at `inner`, the first tip at `start` degrees. */
+export declare function starContour(cx: number, cy: number, points: number, outer: number, inner: number, start: number): Contour;
+/** A regular polygon with `sides` corners at radius `r`, the first at `start` degrees. */
+export declare function regularContour(cx: number, cy: number, sides: number, r: number, start: number): Contour;
+/**
+ * A line from (x1, y1) to (x2, y2) drawn as a filled stadium `width` wide
+ * with round ends, which is how an icon's strokes are made without strokes.
+ */
+export declare function capsule(x1: number, y1: number, x2: number, y2: number, width: number): Contour;
+/** A ring: `outer` clockwise and `hole` written reversed. */
+export declare function ring(out: PathBuilder, outer: Contour, hole: Contour): void;
+//# sourceMappingURL=draw.d.ts.map

package/dist/design/catalogue/draw.d.ts.map

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