@ifc-lite/flow-nodes 0.2.0 → 0.5.0

package/dist/secrets.js

@@ -0,0 +1,202 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Secrets from the host environment (#5167 phase 3.5).
+ *
+ * A node param references a secret with `{{secret:NAME}}` inside a
+ * string value (or a string nested inside a `json`-kind param, e.g. a
+ * header map). The grammar itself is recognised by `@ifc-lite/flow`'s
+ * `referencedSecrets` (availability needs it too); this module is the one
+ * place declared-vs-referenced is cross-checked and `process.env` is read —
+ * shared by `packages/cli/src/commands/flow.ts` (`flow run`) and
+ * `packages/mcp/src/tools/flow.ts` (`run_flow`), the only two callers
+ * allowed to read `process.env` for a flow graph. The viewer never calls
+ * this module: `HostFeatures.secrets` is always the empty set there, so
+ * a graph referencing a secret shows `unavailable` before it runs (see
+ * `availability.ts`), not this module's validation error.
+ *
+ * Two checks run BEFORE any node executes:
+ *   1. every `{{secret:NAME}}` reference must be covered by a declared
+ *      `secret.read:NAME` capability in the graph — an undeclared
+ *      reference is a validation error, not a silently-empty string;
+ *   2. every declared-and-referenced secret must actually be set in the
+ *      environment — a referenced-but-unset secret is also a validation
+ *      error, not an empty string interpolated into a request.
+ *
+ * Redaction (`buildRedactionMap` / `redactDeep`) is a separate, later
+ * step the caller applies at the OUTER boundary — right before writing
+ * to stdout, an MCP response, or a log sink — so a secret value that
+ * reaches a remote response body (a server echoing back an Authorization
+ * header) and comes back into the run's own output is still caught, not
+ * just the point where `{{secret:NAME}}` was first substituted. See the
+ * module doc trade-offs below on the minimum-length cutoff.
+ */
+import { referencedSecrets, replaceSecretRefs } from '@ifc-lite/flow';
+export { referencedSecrets };
+import { parseCapabilities } from '@ifc-lite/extensions';
+/** Every `secret:NAME` the graph's capabilities declare (from `secret.read:<NAME>` grants). */
+export function declaredSecrets(doc) {
+    const parsed = parseCapabilities(doc.capabilities);
+    const names = new Set();
+    if (!parsed.ok)
+        return names;
+    for (const cap of parsed.value) {
+        if (cap.scope === 'secret' && cap.action === 'read' && cap.target?.segments.length === 1) {
+            const seg = cap.target.segments[0];
+            if (seg.kind === 'literal')
+                names.add(seg.value);
+        }
+    }
+    return names;
+}
+/**
+ * Validate every `{{secret:NAME}}` reference against the graph's declared
+ * capabilities AND the environment, before any node runs. Returns an empty
+ * array when the graph is clean (including "no secrets used at all").
+ */
+export function validateSecretReferences(doc, env) {
+    const declared = declaredSecrets(doc);
+    const errors = [];
+    for (const ref of referencedSecrets(doc)) {
+        if (!declared.has(ref.name)) {
+            errors.push({
+                nodeId: ref.nodeId,
+                param: ref.param,
+                name: ref.name,
+                reason: 'undeclared',
+                message: `node "${ref.nodeId}" param "${ref.param}" references {{secret:${ref.name}}}, but the graph does not declare "secret.read:${ref.name}"`,
+            });
+            continue;
+        }
+        if (env[ref.name] === undefined) {
+            errors.push({
+                nodeId: ref.nodeId,
+                param: ref.param,
+                name: ref.name,
+                reason: 'unset',
+                message: `node "${ref.nodeId}" param "${ref.param}" references {{secret:${ref.name}}}, which is declared but not set in the environment`,
+            });
+        }
+    }
+    return errors;
+}
+/** Resolve every declared-and-referenced secret's value from `env`. Call only after `validateSecretReferences` returns no errors. */
+export function resolveSecretValues(doc, env) {
+    const values = new Map();
+    for (const ref of referencedSecrets(doc)) {
+        const v = env[ref.name];
+        if (v === undefined)
+            continue;
+        // Redaction is a substring scrub, and a very short value cannot be
+        // scrubbed without mangling ordinary output — so rather than resolve a
+        // secret that would then travel unredacted, refuse it. The message names
+        // the variable, never the value.
+        if (v.length < MIN_REDACTED_SECRET_LENGTH) {
+            throw new Error(`secret ${ref.name} is shorter than ${MIN_REDACTED_SECRET_LENGTH} characters, so it could not be `
+                + 'redacted from run output; refusing to use it');
+        }
+        values.set(ref.name, v);
+    }
+    return values;
+}
+function substitute(value, values) {
+    if (typeof value === 'string') {
+        return replaceSecretRefs(value, (name, whole) => values.get(name) ?? whole);
+    }
+    if (Array.isArray(value))
+        return value.map((v) => substitute(v, values));
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, substitute(v, values)]));
+    }
+    return value;
+}
+/** Return a new document with every `{{secret:NAME}}` reference in node params replaced by its resolved value. The input document is never mutated. */
+export function interpolateSecrets(doc, values) {
+    if (values.size === 0)
+        return doc;
+    const nodes = doc.nodes.map((node) => {
+        if (!node.params)
+            return node;
+        const params = Object.fromEntries(Object.entries(node.params).map(([k, v]) => [k, substitute(v, values)]));
+        return { ...node, params };
+    });
+    return { ...doc, nodes };
+}
+/** Minimum secret length worth redacting (see module doc): shorter values risk mass-redacting incidental substrings of ordinary text. */
+export const MIN_REDACTED_SECRET_LENGTH = 6;
+/**
+ * Reverse map (value → marker) for every resolved secret at least
+ * `MIN_REDACTED_SECRET_LENGTH` characters long. A secret shorter than
+ * that is a real gap (documented, not silently accepted): a 4-character
+ * token could coincide with ordinary text often enough that scrubbing it
+ * everywhere would make legitimate output unreadable, so this module
+ * accepts that a very short secret is not redactable by substring match
+ * at all.
+ */
+export function buildRedactionMap(values) {
+    // Secrets sharing one value share one marker naming all of them, rather
+    // than the last silently taking the value over (#5446 review).
+    const names = new Map();
+    for (const [name, value] of values) {
+        if (value.length < MIN_REDACTED_SECRET_LENGTH)
+            continue;
+        names.set(value, [...(names.get(value) ?? []), name]);
+    }
+    // Longest value first, so a secret containing another is matched whole.
+    const ordered = [...names].sort(([a], [b]) => b.length - a.length);
+    return new Map(ordered.map(([value, owners]) => [value, `<secret:${[...owners].sort().join('|')}>`]));
+}
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Replace every occurrence of a redacted secret value with its marker, in ONE
+ * pass, trying the longest value first at each position. Sequential
+ * replacement let a shorter secret inside a longer one match first
+ * (`abcdef` inside `abcdefghi` left `<secret:A>ghi`, exposing B's suffix),
+ * and could match inside a marker already written (#5446 review).
+ */
+export function redactText(text, redaction) {
+    if (redaction.size === 0)
+        return text;
+    const values = [...redaction.keys()].sort((a, b) => b.length - a.length);
+    const pattern = new RegExp(values.map(escapeRegExp).join('|'), 'g');
+    return text.replace(pattern, (match) => redaction.get(match) ?? match);
+}
+/**
+ * Walk an arbitrary JSON-ish value (a run summary, a log entry, a thrown
+ * error's message) and redact every string found, at any depth — this is
+ * what catches a secret that travelled through a response body and back
+ * into the run's own output, not just the literal param it was
+ * interpolated into.
+ */
+/**
+ * The env names a host may report as available secrets: set, and long
+ * enough to be redacted. `resolveSecretValues` refuses a shorter value, so
+ * counting it as available made `flow validate` pass a graph the run then
+ * refused (#5446 review).
+ */
+export function usableSecretNames(env) {
+    return Object.entries(env)
+        .filter(([, value]) => typeof value === 'string' && value.length >= MIN_REDACTED_SECRET_LENGTH)
+        .map(([name]) => name);
+}
+export function redactDeep(value, redaction) {
+    if (redaction.size === 0)
+        return value;
+    if (typeof value === 'string')
+        return redactText(value, redaction);
+    if (Array.isArray(value))
+        return value.map((v) => redactDeep(v, redaction));
+    // Keys too: a script can return an object keyed by a secret, and
+    // `core.groupBy` can group by one (#5446 review).
+    if (value instanceof Map) {
+        return new Map([...value.entries()].map(([k, v]) => [redactDeep(k, redaction), redactDeep(v, redaction)]));
+    }
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [redactText(k, redaction), redactDeep(v, redaction)]));
+    }
+    return value;
+}
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

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

package/dist/speckle/client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The Speckle wire protocol, spoken ONLY through `coreNetworkRequest` (the
+ * gated, https-only, exact-host-grant request function every flow node
+ * uses). Nothing here calls `fetch`: the transport comes from the host, and
+ * the grant check runs before any byte moves.
+ *
+ * Three requests, the same three Speckle's own object loader makes:
+ *
+ *   POST /graphql                               version → `referencedObject` (root object id)
+ *   GET  /objects/<project>/<object>/single     the root object alone
+ *   POST /api/getobjects/<project>              a batch of objects by id, one `id\tjson` per line
+ *
+ * The walk is lazy and iterative: a round fetches only the ids the previous
+ * round referenced and has not yet seen, so display meshes and their data
+ * chunks (the bulk of any commit) are never downloaded — `speckle.receive`
+ * does not write them (see `mapping.ts`). A visited set stops cycles and
+ * revisits, and `maxObjects` bounds the total, failing loudly when reached.
+ */
+import { type FetchTransport } from '@ifc-lite/sandbox';
+import type { Capability } from '@ifc-lite/extensions';
+import type { SpeckleTarget } from './url.js';
+export type SpeckleObject = Readonly<Record<string, unknown>> & {
+    readonly id: string;
+};
+export interface SpeckleClientOptions {
+    readonly grants: readonly Capability[];
+    readonly transport?: FetchTransport;
+    /** Personal access token; sent as `Authorization: Bearer`. Empty = anonymous (public projects). */
+    readonly token?: string;
+    readonly timeoutMs: number;
+    /** Per-response byte cap. A response that hits it fails the receive: a truncated batch is missing objects. */
+    readonly maxBytes: number;
+    /** Upper bound on the number of objects fetched. */
+    readonly maxObjects: number;
+    readonly signal?: AbortSignal;
+}
+/** Keys whose values are display geometry: never followed, never fetched. */
+export declare const DISPLAY_KEYS: ReadonlySet<string>;
+/** The root object id a target points at, and the version it came from (if any). */
+export declare function resolveRoot(opts: SpeckleClientOptions, target: SpeckleTarget): Promise<{
+    objectId: string;
+    versionId?: string;
+}>;
+/** Every `referencedId` in an object's own JSON tree, except under display keys. */
+export declare function referencedIds(value: unknown, out?: Set<string>): Set<string>;
+/**
+ * Fetch the root object and everything it references (display geometry
+ * excepted), keyed by id. Throws when an id the graph references is not
+ * returned by the server, or when `maxObjects` is reached.
+ */
+export declare function fetchObjectGraph(opts: SpeckleClientOptions, target: SpeckleTarget, rootId: string): Promise<Map<string, SpeckleObject>>;
+//# sourceMappingURL=client.d.ts.map

package/dist/speckle/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/speckle/client.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAA0C,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,mGAAmG;IACnG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8GAA8G;IAC9G,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,6EAA6E;AAC7E,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAA6E,CAAC;AA4C3H,oFAAoF;AACpF,wBAAsB,WAAW,CAAC,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBtI;AAOD,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,GAAG,CAAC,MAAM,CAAC,CAgBvF;AA0BD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CA0B7I"}

package/dist/speckle/client.js

@@ -0,0 +1,153 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * The Speckle wire protocol, spoken ONLY through `coreNetworkRequest` (the
+ * gated, https-only, exact-host-grant request function every flow node
+ * uses). Nothing here calls `fetch`: the transport comes from the host, and
+ * the grant check runs before any byte moves.
+ *
+ * Three requests, the same three Speckle's own object loader makes:
+ *
+ *   POST /graphql                               version → `referencedObject` (root object id)
+ *   GET  /objects/<project>/<object>/single     the root object alone
+ *   POST /api/getobjects/<project>              a batch of objects by id, one `id\tjson` per line
+ *
+ * The walk is lazy and iterative: a round fetches only the ids the previous
+ * round referenced and has not yet seen, so display meshes and their data
+ * chunks (the bulk of any commit) are never downloaded — `speckle.receive`
+ * does not write them (see `mapping.ts`). A visited set stops cycles and
+ * revisits, and `maxObjects` bounds the total, failing loudly when reached.
+ */
+import { coreNetworkRequest, NetworkDeniedError } from '@ifc-lite/sandbox';
+/** Keys whose values are display geometry: never followed, never fetched. */
+export const DISPLAY_KEYS = new Set(['displayValue', '@displayValue', 'displayMesh', '@displayMesh']);
+const BATCH_SIZE = 500;
+function headers(opts, extra) {
+    const h = { ...extra };
+    if (opts.token && opts.token.length > 0)
+        h.Authorization = `Bearer ${opts.token}`;
+    return h;
+}
+async function request(opts, url, method, extra, body) {
+    let res;
+    try {
+        res = await coreNetworkRequest({ url, method, headers: headers(opts, extra), body, timeoutMs: opts.timeoutMs, maxBytes: opts.maxBytes, signal: opts.signal }, opts.grants, opts.transport);
+    }
+    catch (err) {
+        if (err instanceof NetworkDeniedError)
+            throw new Error(`speckle.receive: ${err.message}`);
+        throw err;
+    }
+    if (res.status === 401 || res.status === 403) {
+        throw new Error(`speckle.receive: ${method} ${url} was refused (${res.status}); the project is private or the token lacks access`);
+    }
+    if (res.status < 200 || res.status >= 300)
+        throw new Error(`speckle.receive: ${method} ${url} failed with status ${res.status}`);
+    if (res.truncated)
+        throw new Error(`speckle.receive: the response from ${url} exceeded maxBytes (${opts.maxBytes}); raise maxBytes to receive this model`);
+    return res.body;
+}
+function parseJson(text, what) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new Error(`speckle.receive: ${what} is not valid JSON`);
+    }
+}
+const VERSION_QUERY = 'query ($projectId: String!, $versionId: String!) { project(id: $projectId) { version(id: $versionId) { id referencedObject } } }';
+const LATEST_QUERY = 'query ($projectId: String!, $modelId: String!) { project(id: $projectId) { model(id: $modelId) { versions(limit: 1) { items { id referencedObject } } } } }';
+/** The root object id a target points at, and the version it came from (if any). */
+export async function resolveRoot(opts, target) {
+    if (target.kind === 'object')
+        return { objectId: target.objectId };
+    const pinned = target.versionId !== undefined;
+    const body = JSON.stringify(pinned
+        ? { query: VERSION_QUERY, variables: { projectId: target.projectId, versionId: target.versionId } }
+        : { query: LATEST_QUERY, variables: { projectId: target.projectId, modelId: target.modelId } });
+    const text = await request(opts, `${target.server}/graphql`, 'POST', { 'Content-Type': 'application/json', Accept: 'application/json' }, body);
+    const res = parseJson(text, 'the GraphQL response');
+    if (res.errors && res.errors.length > 0) {
+        throw new Error(`speckle.receive: the server answered the version query with an error: ${res.errors.map((e) => e.message ?? '?').join('; ')}`);
+    }
+    const version = pinned ? res.data?.project?.version : res.data?.project?.model?.versions?.items?.[0];
+    if (!version) {
+        throw new Error(pinned ? `speckle.receive: version ${target.versionId} was not found in project ${target.projectId}` : `speckle.receive: model ${target.modelId} has no versions`);
+    }
+    if (typeof version.referencedObject !== 'string' || version.referencedObject.length === 0) {
+        throw new Error(`speckle.receive: version ${version.id} carries no referencedObject`);
+    }
+    return { objectId: version.referencedObject, versionId: version.id };
+}
+/** Every `referencedId` in an object's own JSON tree, except under display keys. */
+export function referencedIds(value, out = new Set()) {
+    const stack = [value];
+    while (stack.length > 0) {
+        const v = stack.pop();
+        if (Array.isArray(v)) {
+            for (const x of v)
+                stack.push(x);
+        }
+        else if (v !== null && typeof v === 'object') {
+            const o = v;
+            if (typeof o.referencedId === 'string')
+                out.add(o.referencedId);
+            for (const [k, child] of Object.entries(o)) {
+                if (k === '__closure' || DISPLAY_KEYS.has(k))
+                    continue;
+                if (child !== null && typeof child === 'object')
+                    stack.push(child);
+            }
+        }
+    }
+    return out;
+}
+function asObject(value, what) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value) || typeof value.id !== 'string') {
+        throw new Error(`speckle.receive: ${what} is not a Speckle object`);
+    }
+    return value;
+}
+async function fetchBatch(opts, target, ids) {
+    const text = await request(opts, `${target.server}/api/getobjects/${encodeURIComponent(target.projectId)}`, 'POST', { 'Content-Type': 'application/json', Accept: 'text/plain' }, JSON.stringify({ objects: JSON.stringify(ids) }));
+    const out = [];
+    for (const line of text.split('\n')) {
+        if (line.trim().length === 0)
+            continue;
+        const tab = line.indexOf('\t');
+        out.push(asObject(parseJson(tab >= 0 ? line.slice(tab + 1) : line, `object line "${line.slice(0, 40)}"`), 'a batch line'));
+    }
+    return out;
+}
+/**
+ * Fetch the root object and everything it references (display geometry
+ * excepted), keyed by id. Throws when an id the graph references is not
+ * returned by the server, or when `maxObjects` is reached.
+ */
+export async function fetchObjectGraph(opts, target, rootId) {
+    const objects = new Map();
+    const rootText = await request(opts, `${target.server}/objects/${encodeURIComponent(target.projectId)}/${encodeURIComponent(rootId)}/single`, 'GET', { Accept: 'text/plain' });
+    const root = asObject(parseJson(rootText, `root object ${rootId}`), `root object ${rootId}`);
+    objects.set(rootId, root);
+    let frontier = [...referencedIds(root)].filter((id) => !objects.has(id));
+    while (frontier.length > 0) {
+        if (objects.size + frontier.length > opts.maxObjects) {
+            throw new Error(`speckle.receive: the model references more than maxObjects (${opts.maxObjects}) objects; raise maxObjects to receive it`);
+        }
+        const next = new Set();
+        for (let i = 0; i < frontier.length; i += BATCH_SIZE) {
+            const ids = frontier.slice(i, i + BATCH_SIZE);
+            for (const obj of await fetchBatch(opts, target, ids))
+                objects.set(obj.id, obj);
+            const missing = ids.filter((id) => !objects.has(id));
+            if (missing.length > 0)
+                throw new Error(`speckle.receive: the server did not return ${missing.length} referenced object(s), e.g. ${missing[0]}`);
+            for (const id of ids)
+                referencedIds(objects.get(id), next);
+        }
+        frontier = [...next].filter((id) => !objects.has(id));
+    }
+    return objects;
+}
+//# sourceMappingURL=client.js.map

package/dist/speckle/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/speckle/client.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAuB,MAAM,mBAAmB,CAAC;AAmBhG,6EAA6E;AAC7E,MAAM,CAAC,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;AAE3H,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,SAAS,OAAO,CAAC,IAA0B,EAAE,KAA6B;IACxE,MAAM,CAAC,GAA2B,EAAE,GAAG,KAAK,EAAE,CAAC;IAC/C,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,CAAC,CAAC,aAAa,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;IAClF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,IAA0B,EAAE,GAAW,EAAE,MAAsB,EAAE,KAA6B,EAAE,IAAa;IAE7G,IAAI,GAAG,CAAC;IACR,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,kBAAkB,CAC5B,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAC7H,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,SAAS,CACf,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,kBAAkB;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1F,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,IAAI,GAAG,iBAAiB,GAAG,CAAC,MAAM,qDAAqD,CAAC,CAAC;IACrI,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,IAAI,GAAG,uBAAuB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACjI,IAAI,GAAG,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,uBAAuB,IAAI,CAAC,QAAQ,yCAAyC,CAAC,CAAC;IAC3J,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,IAAY;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,oBAAoB,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,MAAM,aAAa,GAAG,kIAAkI,CAAC;AACzJ,MAAM,YAAY,GAChB,6JAA6J,CAAC;AAEhK,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAA0B,EAAE,MAAqB;IACjF,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IACnE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CACzB,MAAM;QACJ,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE;QACnG,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CACjG,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,UAAU,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,IAAI,CAAC,CAAC;IAC/I,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,sBAAsB,CAGjD,CAAC;IACF,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,yEAAyE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjJ,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACrG,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,4BAA4B,MAAM,CAAC,SAAS,6BAA6B,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,0BAA0B,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;IACrL,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,gBAAgB,KAAK,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,CAAC,EAAE,8BAA8B,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,gBAAgB,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;AACvE,CAAC;AAOD,oFAAoF;AACpF,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,MAAmB,IAAI,GAAG,EAAE;IACxE,MAAM,KAAK,GAAc,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACtB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,KAAK,MAAM,CAAC,IAAI,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC/C,MAAM,CAAC,GAAG,CAA4B,CAAC;YACvC,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ;gBAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;YAChE,KAAK,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,KAAK,WAAW,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAE,SAAS;gBACvD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;oBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,IAAY;IAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAQ,KAA0B,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC9H,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,0BAA0B,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,KAAsB,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAA0B,EAAE,MAAqB,EAAE,GAAsB;IACjG,MAAM,IAAI,GAAG,MAAM,OAAO,CACxB,IAAI,EACJ,GAAG,MAAM,CAAC,MAAM,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,EACzE,MAAM,EACN,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,EAAE,YAAY,EAAE,EAC5D,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CACjD,CAAC;IACF,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,gBAAgB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IAC7H,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAA0B,EAAE,MAAqB,EAAE,MAAc;IACtG,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,IAAI,EACJ,GAAG,MAAM,CAAC,MAAM,YAAY,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,SAAS,EACvG,KAAK,EACL,EAAE,MAAM,EAAE,YAAY,EAAE,CACzB,CAAC;IACF,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,eAAe,MAAM,EAAE,CAAC,EAAE,eAAe,MAAM,EAAE,CAAC,CAAC;IAC7F,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC1B,IAAI,QAAQ,GAAG,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,+DAA+D,IAAI,CAAC,UAAU,2CAA2C,CAAC,CAAC;QAC7I,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC;YACrD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC;YAC9C,KAAK,MAAM,GAAG,IAAI,MAAM,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YAChF,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACrD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,OAAO,CAAC,MAAM,+BAA+B,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjJ,KAAK,MAAM,EAAE,IAAI,GAAG;gBAAE,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAC7D,CAAC;QACD,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/speckle/geometry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Reading Speckle geometry primitives into metres: points, straight lines,
+ * and polygonal outlines. Anything that is not exactly one of those (an
+ * arc, a NURBS curve, a gap between polycurve segments) is reported as
+ * `undefined` with a reason, so the caller refuses the element rather than
+ * approximating its shape.
+ */
+import type { SpeckleObject } from './client.js';
+export type Vec3 = [number, number, number];
+export type Resolver = (value: unknown) => Record<string, unknown> | undefined;
+/** Resolve a detached `{ speckle_type: 'reference', referencedId }` against the fetched graph; inline objects pass through. */
+export declare function resolverFor(objects: ReadonlyMap<string, SpeckleObject>): Resolver;
+/** `speckle_type` is a `:`-joined inheritance chain; true when `base` is one of its links. */
+export declare function isA(obj: Record<string, unknown> | undefined, base: string): boolean;
+/** The most-derived link of the chain, the name refusals use. */
+export declare function leafType(obj: Record<string, unknown>): string;
+/** A Speckle point in metres; its own `units` win over the owner's. */
+export declare function pointOf(resolve: Resolver, value: unknown, ownerUnits: unknown): Vec3 | undefined;
+/** Start/end of an `Objects.Geometry.Line`, in metres. */
+export declare function lineOf(resolve: Resolver, value: unknown, ownerUnits: unknown): {
+    start: Vec3;
+    end: Vec3;
+} | {
+    reason: string;
+};
+/**
+ * The vertices of a closed, planar-horizontal outline (a `Polycurve` of
+ * `Line` segments, or a closed `Polyline`), in metres, without the closing
+ * duplicate. Everything else — arcs, open or gapped outlines, outlines whose
+ * vertices do not share one elevation — returns a reason.
+ */
+export declare function outlineOf(resolve: Resolver, value: unknown, ownerUnits: unknown): {
+    points: Vec3[];
+} | {
+    reason: string;
+};
+//# sourceMappingURL=geometry.d.ts.map

package/dist/speckle/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/speckle/geometry.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5C,MAAM,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;AAE/E,+HAA+H;AAC/H,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,QAAQ,CAOjF;AAED,8FAA8F;AAC9F,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnF;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAK7D;AAOD,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAMhG;AAED,0DAA0D;AAC1D,wBAAgB,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAS9H;AAuBD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAgCzH"}

package/dist/speckle/geometry.js

@@ -0,0 +1,126 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { lengthScale } from './units.js';
+/** Resolve a detached `{ speckle_type: 'reference', referencedId }` against the fetched graph; inline objects pass through. */
+export function resolverFor(objects) {
+    return (value) => {
+        if (value === null || typeof value !== 'object' || Array.isArray(value))
+            return undefined;
+        const o = value;
+        if (typeof o.referencedId === 'string')
+            return objects.get(o.referencedId);
+        return o;
+    };
+}
+/** `speckle_type` is a `:`-joined inheritance chain; true when `base` is one of its links. */
+export function isA(obj, base) {
+    return typeof obj?.speckle_type === 'string' && obj.speckle_type.split(':').includes(base);
+}
+/** The most-derived link of the chain, the name refusals use. */
+export function leafType(obj) {
+    const t = typeof obj.speckle_type === 'string' ? obj.speckle_type : 'Base';
+    const chain = t.split(':');
+    const leaf = chain[chain.length - 1];
+    return leaf.slice(leaf.lastIndexOf('.') + 1);
+}
+/** `a Line`, `an Arc`. */
+const withArticle = (word) => `${/^[AEIOU]/i.test(word) ? 'an' : 'a'} ${word}`;
+const finite = (v) => typeof v === 'number' && Number.isFinite(v);
+/** A Speckle point in metres; its own `units` win over the owner's. */
+export function pointOf(resolve, value, ownerUnits) {
+    const p = resolve(value);
+    if (!p || !finite(p.x) || !finite(p.y) || !finite(p.z))
+        return undefined;
+    const s = lengthScale(p.units) ?? lengthScale(ownerUnits);
+    if (s === undefined)
+        return undefined;
+    return [p.x * s, p.y * s, p.z * s];
+}
+/** Start/end of an `Objects.Geometry.Line`, in metres. */
+export function lineOf(resolve, value, ownerUnits) {
+    const line = resolve(value);
+    if (!line)
+        return { reason: 'has no location line' };
+    if (!isA(line, 'Objects.Geometry.Line'))
+        return { reason: `has ${withArticle(leafType(line))} location, not a straight line` };
+    const units = line.units ?? ownerUnits;
+    const start = pointOf(resolve, line.start, units);
+    const end = pointOf(resolve, line.end, units);
+    if (!start || !end)
+        return { reason: 'has a location line without numeric points in a length unit' };
+    return { start, end };
+}
+/** A flat number list, possibly chunked into `DataChunk` references. */
+function numbers(resolve, value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const out = [];
+    for (const item of value) {
+        if (finite(item))
+            out.push(item);
+        else {
+            const chunk = resolve(item);
+            if (!chunk || !Array.isArray(chunk.data) || !chunk.data.every(finite))
+                return undefined;
+            out.push(...chunk.data);
+        }
+    }
+    return out;
+}
+const TOL = 1e-4; // metres: 0.1 mm
+function near(a, b) {
+    return Math.abs(a[0] - b[0]) <= TOL && Math.abs(a[1] - b[1]) <= TOL && Math.abs(a[2] - b[2]) <= TOL;
+}
+/**
+ * The vertices of a closed, planar-horizontal outline (a `Polycurve` of
+ * `Line` segments, or a closed `Polyline`), in metres, without the closing
+ * duplicate. Everything else — arcs, open or gapped outlines, outlines whose
+ * vertices do not share one elevation — returns a reason.
+ */
+export function outlineOf(resolve, value, ownerUnits) {
+    const curve = resolve(value);
+    if (!curve)
+        return { reason: 'has no outline' };
+    const units = curve.units ?? ownerUnits;
+    let points = [];
+    if (isA(curve, 'Objects.Geometry.Polycurve')) {
+        const segments = Array.isArray(curve.segments) ? curve.segments : [];
+        for (const [i, seg] of segments.entries()) {
+            const line = lineOf(resolve, seg, units);
+            if ('reason' in line) {
+                const s = resolve(seg);
+                return { reason: `has an outline with ${withArticle(s ? leafType(s) : 'missing')} segment, not only straight lines` };
+            }
+            if (i > 0 && !near(points[points.length - 1], line.start))
+                return { reason: 'has an outline with a gap between segments' };
+            if (i === 0)
+                points.push(line.start);
+            points.push(line.end);
+        }
+    }
+    else if (isA(curve, 'Objects.Geometry.Polyline')) {
+        const flat = numbers(resolve, curve.value);
+        const s = lengthScale(units);
+        if (!flat || flat.length % 3 !== 0 || s === undefined)
+            return { reason: 'has a polyline outline without numeric coordinates in a length unit' };
+        for (let i = 0; i < flat.length; i += 3)
+            points.push([flat[i] * s, flat[i + 1] * s, flat[i + 2] * s]);
+        if (curve.closed !== true && !(points.length > 1 && near(points[0], points[points.length - 1])))
+            return { reason: 'has an open polyline outline' };
+        if (curve.closed === true)
+            points.push(points[0]);
+    }
+    else {
+        return { reason: `has ${withArticle(leafType(curve))} outline, not line segments` };
+    }
+    if (points.length < 2 || !near(points[0], points[points.length - 1]))
+        return { reason: 'has an outline that does not close' };
+    points = points.slice(0, -1);
+    if (points.length < 3)
+        return { reason: 'has an outline with fewer than three vertices' };
+    if (points.some((p) => Math.abs(p[2] - points[0][2]) > TOL))
+        return { reason: 'has an outline that is not horizontal (sloped)' };
+    return { points };
+}
+//# sourceMappingURL=geometry.js.map

package/dist/speckle/geometry.js.map

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