@faicad/faijs 0.16.1 → 0.17.0

package/dist/result/result.d.ts

@@ -0,0 +1,213 @@
+/**
+ * Rust-inspired Result<T, E> type for explicit error handling.
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/result.ts`（同源复制，签名不变）；import 来源改为 core 第一方
+ * `result/` 内模块。Zero internal imports beyond errors — pure foundation module.
+ */
+import type { BrepError } from './errors.js';
+/** The Ok variant of a Result, holding a success value. */
+export interface Ok<T> {
+    readonly ok: true;
+    readonly value: T;
+}
+/** The Err variant of a Result, holding an error value. */
+export interface Err<E> {
+    readonly ok: false;
+    readonly error: E;
+}
+/** Discriminated union of {@link Ok} and {@link Err} for explicit error handling. */
+export type Result<T, E = BrepError> = Ok<T> | Err<E>;
+/** Type used for Results that carry no value. */
+export type Unit = undefined;
+/** Wrap a success value in an Ok Result.
+ *
+ * @param value - The success value to wrap.
+ * @returns An Ok Result containing the value.
+ */
+export declare function ok<T>(value: T): Ok<T>;
+/** Wrap an error value in an Err Result.
+ *
+ * @param error - The error value to wrap.
+ * @returns An Err Result containing the error.
+ */
+export declare function err<E>(error: E): Err<E>;
+/** Singleton Ok Result carrying no value. */
+export declare const OK: Ok<Unit>;
+/** Type guard: check whether a Result is Ok.
+ *
+ * @param result - The Result to check.
+ * @returns True if the Result is Ok.
+ */
+export declare function isOk<T, E>(result: Result<T, E>): result is Ok<T>;
+/** Type guard: check whether a Result is Err.
+ *
+ * @param result - The Result to check.
+ * @returns True if the Result is Err.
+ */
+export declare function isErr<T, E>(result: Result<T, E>): result is Err<E>;
+/** Transform the Ok value of a Result, leaving Err unchanged.
+ *
+ * @param result - The Result to transform.
+ * @param fn - Function applied to the Ok value.
+ * @returns A Result with the transformed value, or the original error.
+ */
+export declare function map<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E>;
+/** Transform the Err value of a Result, leaving Ok unchanged.
+ *
+ * @param result - The Result to transform.
+ * @param fn - Function applied to the error value.
+ * @returns A Result with the transformed error, or the original value.
+ */
+export declare function mapErr<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F>;
+/** Chain a Result-returning function onto an Ok value.
+ *
+ * @param result - The Result to chain from.
+ * @param fn - Function applied to the Ok value, returning a new Result.
+ * @returns The chained Result, or the original error.
+ */
+export declare function andThen<T, U, E>(result: Result<T, E>, fn: (value: T) => Result<U, E>): Result<U, E>;
+/** Alias for andThen */
+export declare const flatMap: typeof andThen;
+/** Return `a` if Ok, otherwise return `b`.
+ *
+ * @param a - The first Result.
+ * @param b - The fallback Result used when `a` is Err.
+ * @returns `a` if Ok, otherwise `b`.
+ */
+export declare function or<T, E, F>(a: Result<T, E>, b: Result<T, F>): Result<T, F>;
+/** Return `result` if Ok, otherwise call `fn` with the error and return its result.
+ *
+ * @param result - The Result to start from.
+ * @param fn - Recovery function receiving the error.
+ * @returns The original Result if Ok, otherwise the recovery Result.
+ */
+export declare function orElse<T, E, F>(result: Result<T, E>, fn: (error: E) => Result<T, F>): Result<T, F>;
+/** Combine two independent Results into a Result of a tuple.
+ *
+ * @param a - The first Result.
+ * @param b - The second Result.
+ * @returns Ok of the value tuple, or the first Err encountered.
+ */
+export declare function zip<A, B, E>(a: Result<A, E>, b: Result<B, E>): Result<[A, B], E>;
+/** Collect an array of Results into a Result of an array. Alias for {@link collect}. */
+export declare const all: typeof collect;
+/** Run a side-effect on an Ok value without transforming the result.
+ *
+ * @param result - The Result to tap.
+ * @param fn - Side-effect function called with the Ok value.
+ * @returns The original Result, unchanged.
+ */
+export declare function tap<T, E>(result: Result<T, E>, fn: (value: T) => void): Result<T, E>;
+/** Run a side-effect on an Err value without transforming the result.
+ *
+ * @param result - The Result to tap.
+ * @param fn - Side-effect function called with the error value.
+ * @returns The original Result, unchanged.
+ */
+export declare function tapErr<T, E>(result: Result<T, E>, fn: (error: E) => void): Result<T, E>;
+/** Flatten a nested Result<Result<T, E>, E> into Result<T, E>.
+ *
+ * @param result - The nested Result to flatten.
+ * @returns The inner Result if Ok, otherwise the outer error.
+ */
+export declare function flatten<T, E>(result: Result<Result<T, E>, E>): Result<T, E>;
+/** Map both Ok and Err variants in a single pass.
+ *
+ * @param result - The Result to transform.
+ * @param okFn - Function applied to the Ok value.
+ * @param errFn - Function applied to the error value.
+ * @returns A Result with both variants transformed.
+ */
+export declare function mapBoth<T, U, E, F>(result: Result<T, E>, okFn: (value: T) => U, errFn: (error: E) => F): Result<U, F>;
+/** Convert a nullable value to a Result, using `errorFn` to produce the error for null/undefined.
+ *
+ * @param value - The value to wrap; may be null or undefined.
+ * @param errorFn - Factory producing the error for null/undefined input.
+ * @returns Ok containing the value, or Err from `errorFn`.
+ */
+export declare function fromNullable<T, E>(value: T | null | undefined, errorFn: () => E): Result<T, E>;
+/** Extract the Ok value, throwing if the Result is Err.
+ *
+ * @param result - The Result to unwrap.
+ * @returns The Ok value.
+ */
+export declare function unwrap<T, E>(result: Result<T, E>): T;
+/** Extract the Ok value, returning a default if the Result is Err.
+ *
+ * @param result - The Result to unwrap.
+ * @param defaultValue - Value returned when the Result is Err.
+ * @returns The Ok value, or the default.
+ */
+export declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
+/** Extract the Ok value, computing a fallback from the error if the Result is Err.
+ *
+ * @param result - The Result to unwrap.
+ * @param fn - Function producing a fallback value from the error.
+ * @returns The Ok value, or the fallback.
+ */
+export declare function unwrapOrElse<T, E>(result: Result<T, E>, fn: (error: E) => T): T;
+/** Extract the Err value, throwing if the Result is Ok.
+ *
+ * @param result - The Result to unwrap.
+ * @returns The error value.
+ */
+export declare function unwrapErr<T, E>(result: Result<T, E>): E;
+/** Pattern-match a Result, applying the ok or err handler.
+ *
+ * @param result - The Result to match on.
+ * @param handlers - Object with `ok` and `err` handler functions.
+ * @returns The value produced by the matching handler.
+ */
+export declare function match<T, E, U>(result: Result<T, E>, handlers: {
+    ok: (value: T) => U;
+    err: (error: E) => U;
+}): U;
+/**
+ * Collects an array of Results into a Result of an array.
+ * Short-circuits on the first Err.
+ *
+ * @param results - The array of Results to collect.
+ * @returns Ok of all values, or the first Err.
+ */
+export declare function collect<T, E>(results: Result<T, E>[]): Result<T[], E>;
+/**
+ * Wraps a throwing function into a Result.
+ * The mapError function converts the caught exception into the error type.
+ *
+ * @param fn - The function to execute.
+ * @param mapError - Converts a caught exception into the error type.
+ * @returns Ok of the result, or Err of the mapped exception.
+ */
+export declare function tryCatch<T, E>(fn: () => T, mapError: (error: unknown) => E): Result<T, E>;
+/**
+ * Wraps an async throwing function into a Result.
+ * The mapError function converts the caught exception into the error type.
+ *
+ * @param fn - The async function to execute.
+ * @param mapError - Converts a caught exception into the error type.
+ * @returns A promise resolving to Ok of the result, or Err of the mapped exception.
+ */
+export declare function tryCatchAsync<T, E>(fn: () => Promise<T>, mapError: (error: unknown) => E): Promise<Result<T, E>>;
+/** A chainable pipeline that short-circuits on the first Err. */
+export interface ResultPipeline<T, E> {
+    /** Chain a Result-returning transform. Short-circuits on Err. */
+    then<U>(fn: (value: T) => Result<U, E>): ResultPipeline<U, E>;
+    /** Extract the final Result. */
+    readonly result: Result<T, E>;
+}
+/**
+ * Create a chainable pipeline from a value or Result.
+ *
+ * ```ts
+ * pipeline(shape)
+ *   .then(s => filletShape(s, edges, 2))
+ *   .then(s => shellShape(s, [topFace], 1))
+ *   .result  // → Result<Shape3D>
+ * ```
+ *
+ * @param input - A plain value or a Result to start the pipeline from.
+ * @returns A chainable pipeline wrapping the input.
+ */
+export declare function pipeline<T, E = BrepError>(input: T | Result<T, E>): ResultPipeline<T, E>;
+//# sourceMappingURL=result.d.ts.map

package/dist/result/result.d.ts.map

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

package/dist/result/result.js

@@ -0,0 +1,336 @@
+/**
+ * Rust-inspired Result<T, E> type for explicit error handling.
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/result.ts`（同源复制，签名不变）；import 来源改为 core 第一方
+ * `result/` 内模块。Zero internal imports beyond errors — pure foundation module.
+ */
+// ---------------------------------------------------------------------------
+// Constructors
+// ---------------------------------------------------------------------------
+/** Wrap a success value in an Ok Result.
+ *
+ * @param value - The success value to wrap.
+ * @returns An Ok Result containing the value.
+ */
+export function ok(value) {
+    return { ok: true, value };
+}
+/** Wrap an error value in an Err Result.
+ *
+ * @param error - The error value to wrap.
+ * @returns An Err Result containing the error.
+ */
+export function err(error) {
+    return { ok: false, error };
+}
+/** Singleton Ok Result carrying no value. */
+export const OK = ok(undefined);
+// ---------------------------------------------------------------------------
+// Type guards
+// ---------------------------------------------------------------------------
+/** Type guard: check whether a Result is Ok.
+ *
+ * @param result - The Result to check.
+ * @returns True if the Result is Ok.
+ */
+export function isOk(result) {
+    return result.ok;
+}
+/** Type guard: check whether a Result is Err.
+ *
+ * @param result - The Result to check.
+ * @returns True if the Result is Err.
+ */
+export function isErr(result) {
+    return !result.ok;
+}
+// ---------------------------------------------------------------------------
+// Combinators
+// ---------------------------------------------------------------------------
+/** Transform the Ok value of a Result, leaving Err unchanged.
+ *
+ * @param result - The Result to transform.
+ * @param fn - Function applied to the Ok value.
+ * @returns A Result with the transformed value, or the original error.
+ */
+export function map(result, fn) {
+    if (result.ok)
+        return ok(fn(result.value));
+    return result;
+}
+/** Transform the Err value of a Result, leaving Ok unchanged.
+ *
+ * @param result - The Result to transform.
+ * @param fn - Function applied to the error value.
+ * @returns A Result with the transformed error, or the original value.
+ */
+export function mapErr(result, fn) {
+    if (result.ok)
+        return result;
+    return err(fn(result.error));
+}
+/** Chain a Result-returning function onto an Ok value.
+ *
+ * @param result - The Result to chain from.
+ * @param fn - Function applied to the Ok value, returning a new Result.
+ * @returns The chained Result, or the original error.
+ */
+export function andThen(result, fn) {
+    if (result.ok)
+        return fn(result.value);
+    return result;
+}
+/** Alias for andThen */
+export const flatMap = andThen;
+/** Return `a` if Ok, otherwise return `b`.
+ *
+ * @param a - The first Result.
+ * @param b - The fallback Result used when `a` is Err.
+ * @returns `a` if Ok, otherwise `b`.
+ */
+export function or(a, b) {
+    if (a.ok)
+        return a;
+    return b;
+}
+/** Return `result` if Ok, otherwise call `fn` with the error and return its result.
+ *
+ * @param result - The Result to start from.
+ * @param fn - Recovery function receiving the error.
+ * @returns The original Result if Ok, otherwise the recovery Result.
+ */
+export function orElse(result, fn) {
+    if (result.ok)
+        return result;
+    return fn(result.error);
+}
+/** Combine two independent Results into a Result of a tuple.
+ *
+ * @param a - The first Result.
+ * @param b - The second Result.
+ * @returns Ok of the value tuple, or the first Err encountered.
+ */
+export function zip(a, b) {
+    if (!a.ok)
+        return a;
+    if (!b.ok)
+        return b;
+    return ok([a.value, b.value]);
+}
+/** Collect an array of Results into a Result of an array. Alias for {@link collect}. */
+export const all = collect;
+/** Run a side-effect on an Ok value without transforming the result.
+ *
+ * @param result - The Result to tap.
+ * @param fn - Side-effect function called with the Ok value.
+ * @returns The original Result, unchanged.
+ */
+export function tap(result, fn) {
+    if (result.ok)
+        fn(result.value);
+    return result;
+}
+/** Run a side-effect on an Err value without transforming the result.
+ *
+ * @param result - The Result to tap.
+ * @param fn - Side-effect function called with the error value.
+ * @returns The original Result, unchanged.
+ */
+export function tapErr(result, fn) {
+    if (!result.ok)
+        fn(result.error);
+    return result;
+}
+/** Flatten a nested Result<Result<T, E>, E> into Result<T, E>.
+ *
+ * @param result - The nested Result to flatten.
+ * @returns The inner Result if Ok, otherwise the outer error.
+ */
+export function flatten(result) {
+    return result.ok ? result.value : result;
+}
+/** Map both Ok and Err variants in a single pass.
+ *
+ * @param result - The Result to transform.
+ * @param okFn - Function applied to the Ok value.
+ * @param errFn - Function applied to the error value.
+ * @returns A Result with both variants transformed.
+ */
+export function mapBoth(result, okFn, errFn) {
+    return result.ok ? ok(okFn(result.value)) : err(errFn(result.error));
+}
+/** Convert a nullable value to a Result, using `errorFn` to produce the error for null/undefined.
+ *
+ * @param value - The value to wrap; may be null or undefined.
+ * @param errorFn - Factory producing the error for null/undefined input.
+ * @returns Ok containing the value, or Err from `errorFn`.
+ */
+export function fromNullable(value, errorFn) {
+    if (value === null || value === undefined)
+        return err(errorFn());
+    return ok(value);
+}
+// ---------------------------------------------------------------------------
+// Extraction
+// ---------------------------------------------------------------------------
+/** Format an error for display, handling BrepError objects specially */
+function formatError(error) {
+    if (typeof error === 'object' &&
+        error !== null &&
+        'kind' in error &&
+        'code' in error &&
+        'message' in error) {
+        // BrepError-like object
+        const e = error;
+        return `[${e.kind}] ${e.code}: ${e.message}`;
+    }
+    return String(error);
+}
+/** Extract the Ok value, throwing if the Result is Err.
+ *
+ * @param result - The Result to unwrap.
+ * @returns The Ok value.
+ */
+export function unwrap(result) {
+    if (result.ok)
+        return result.value;
+    throw new Error(`Called unwrap() on an Err: ${formatError(result.error)}`);
+}
+/** Extract the Ok value, returning a default if the Result is Err.
+ *
+ * @param result - The Result to unwrap.
+ * @param defaultValue - Value returned when the Result is Err.
+ * @returns The Ok value, or the default.
+ */
+export function unwrapOr(result, defaultValue) {
+    if (result.ok)
+        return result.value;
+    return defaultValue;
+}
+/** Extract the Ok value, computing a fallback from the error if the Result is Err.
+ *
+ * @param result - The Result to unwrap.
+ * @param fn - Function producing a fallback value from the error.
+ * @returns The Ok value, or the fallback.
+ */
+export function unwrapOrElse(result, fn) {
+    if (result.ok)
+        return result.value;
+    return fn(result.error);
+}
+/** Extract the Err value, throwing if the Result is Ok.
+ *
+ * @param result - The Result to unwrap.
+ * @returns The error value.
+ */
+export function unwrapErr(result) {
+    if (!result.ok)
+        return result.error;
+    throw new Error(`Called unwrapErr() on an Ok: ${String(result.value)}`);
+}
+// ---------------------------------------------------------------------------
+// Pattern matching
+// ---------------------------------------------------------------------------
+/** Pattern-match a Result, applying the ok or err handler.
+ *
+ * @param result - The Result to match on.
+ * @param handlers - Object with `ok` and `err` handler functions.
+ * @returns The value produced by the matching handler.
+ */
+export function match(result, handlers) {
+    if (result.ok)
+        return handlers.ok(result.value);
+    return handlers.err(result.error);
+}
+// ---------------------------------------------------------------------------
+// Collection
+// ---------------------------------------------------------------------------
+/**
+ * Collects an array of Results into a Result of an array.
+ * Short-circuits on the first Err.
+ *
+ * @param results - The array of Results to collect.
+ * @returns Ok of all values, or the first Err.
+ */
+export function collect(results) {
+    const values = [];
+    for (const result of results) {
+        if (!result.ok)
+            return result;
+        values.push(result.value);
+    }
+    return ok(values);
+}
+// ---------------------------------------------------------------------------
+// Try-catch boundary
+// ---------------------------------------------------------------------------
+/**
+ * Wraps a throwing function into a Result.
+ * The mapError function converts the caught exception into the error type.
+ *
+ * @param fn - The function to execute.
+ * @param mapError - Converts a caught exception into the error type.
+ * @returns Ok of the result, or Err of the mapped exception.
+ */
+export function tryCatch(fn, mapError) {
+    try {
+        return ok(fn());
+    }
+    catch (e) {
+        return err(mapError(e));
+    }
+}
+/**
+ * Wraps an async throwing function into a Result.
+ * The mapError function converts the caught exception into the error type.
+ *
+ * @param fn - The async function to execute.
+ * @param mapError - Converts a caught exception into the error type.
+ * @returns A promise resolving to Ok of the result, or Err of the mapped exception.
+ */
+export async function tryCatchAsync(fn, mapError) {
+    try {
+        return ok(await fn());
+    }
+    catch (e) {
+        return err(mapError(e));
+    }
+}
+/**
+ * Create a chainable pipeline from a value or Result.
+ *
+ * ```ts
+ * pipeline(shape)
+ *   .then(s => filletShape(s, edges, 2))
+ *   .then(s => shellShape(s, [topFace], 1))
+ *   .result  // → Result<Shape3D>
+ * ```
+ *
+ * @param input - A plain value or a Result to start the pipeline from.
+ * @returns A chainable pipeline wrapping the input.
+ */
+export function pipeline(input) {
+    // Detect Result objects by checking the 'ok' discriminant is a boolean
+    function isResult(v) {
+        return (typeof v === 'object' &&
+            v !== null &&
+            'ok' in v &&
+            typeof v['ok'] === 'boolean');
+    }
+    const initial = isResult(input) ? input : ok(input);
+    function makePipeline(current) {
+        return {
+            then(fn) {
+                if (!current.ok)
+                    return makePipeline(current);
+                return makePipeline(fn(current.value));
+            },
+            get result() {
+                return current;
+            },
+        };
+    }
+    return makePipeline(initial);
+}
+//# sourceMappingURL=result.js.map

package/dist/result/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/result/result.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Rust-inspired Result<T, E> type for explicit error handling.\r\n *\r\n * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs\r\n * `src/core/result.ts`（同源复制，签名不变）；import 来源改为 core 第一方\r\n * `result/` 内模块。Zero internal imports beyond errors — pure foundation module.\r\n */\r\n\r\nimport type { BrepError } from './errors';\r\n\r\n// ---------------------------------------------------------------------------\r\n// Core types\r\n// ---------------------------------------------------------------------------\r\n\r\n/** The Ok variant of a Result, holding a success value. */\r\nexport interface Ok<T> {\r\n  readonly ok: true;\r\n  readonly value: T;\r\n}\r\n\r\n/** The Err variant of a Result, holding an error value. */\r\nexport interface Err<E> {\r\n  readonly ok: false;\r\n  readonly error: E;\r\n}\r\n\r\n/** Discriminated union of {@link Ok} and {@link Err} for explicit error handling. */\r\nexport type Result<T, E = BrepError> = Ok<T> | Err<E>;\r\n\r\n/** Type used for Results that carry no value. */\r\nexport type Unit = undefined;\r\n\r\n// ---------------------------------------------------------------------------\r\n// Constructors\r\n// ---------------------------------------------------------------------------\r\n\r\n/** Wrap a success value in an Ok Result.\r\n *\r\n * @param value - The success value to wrap.\r\n * @returns An Ok Result containing the value.\r\n */\r\nexport function ok<T>(value: T): Ok<T> {\r\n  return { ok: true, value };\r\n}\r\n\r\n/** Wrap an error value in an Err Result.\r\n *\r\n * @param error - The error value to wrap.\r\n * @returns An Err Result containing the error.\r\n */\r\nexport function err<E>(error: E): Err<E> {\r\n  return { ok: false, error };\r\n}\r\n\r\n/** Singleton Ok Result carrying no value. */\r\nexport const OK: Ok<Unit> = ok(undefined);\r\n\r\n// ---------------------------------------------------------------------------\r\n// Type guards\r\n// ---------------------------------------------------------------------------\r\n\r\n/** Type guard: check whether a Result is Ok.\r\n *\r\n * @param result - The Result to check.\r\n * @returns True if the Result is Ok.\r\n */\r\nexport function isOk<T, E>(result: Result<T, E>): result is Ok<T> {\r\n  return result.ok;\r\n}\r\n\r\n/** Type guard: check whether a Result is Err.\r\n *\r\n * @param result - The Result to check.\r\n * @returns True if the Result is Err.\r\n */\r\nexport function isErr<T, E>(result: Result<T, E>): result is Err<E> {\r\n  return !result.ok;\r\n}\r\n\r\n// ---------------------------------------------------------------------------\r\n// Combinators\r\n// ---------------------------------------------------------------------------\r\n\r\n/** Transform the Ok value of a Result, leaving Err unchanged.\r\n *\r\n * @param result - The Result to transform.\r\n * @param fn - Function applied to the Ok value.\r\n * @returns A Result with the transformed value, or the original error.\r\n */\r\nexport function map<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E> {\r\n  if (result.ok) return ok(fn(result.value));\r\n  return result;\r\n}\r\n\r\n/** Transform the Err value of a Result, leaving Ok unchanged.\r\n *\r\n * @param result - The Result to transform.\r\n * @param fn - Function applied to the error value.\r\n * @returns A Result with the transformed error, or the original value.\r\n */\r\nexport function mapErr<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F> {\r\n  if (result.ok) return result;\r\n  return err(fn(result.error));\r\n}\r\n\r\n/** Chain a Result-returning function onto an Ok value.\r\n *\r\n * @param result - The Result to chain from.\r\n * @param fn - Function applied to the Ok value, returning a new Result.\r\n * @returns The chained Result, or the original error.\r\n */\r\nexport function andThen<T, U, E>(\r\n  result: Result<T, E>,\r\n  fn: (value: T) => Result<U, E>\r\n): Result<U, E> {\r\n  if (result.ok) return fn(result.value);\r\n  return result;\r\n}\r\n\r\n/** Alias for andThen */\r\nexport const flatMap = andThen;\r\n\r\n/** Return `a` if Ok, otherwise return `b`.\r\n *\r\n * @param a - The first Result.\r\n * @param b - The fallback Result used when `a` is Err.\r\n * @returns `a` if Ok, otherwise `b`.\r\n */\r\nexport function or<T, E, F>(a: Result<T, E>, b: Result<T, F>): Result<T, F> {\r\n  if (a.ok) return a;\r\n  return b;\r\n}\r\n\r\n/** Return `result` if Ok, otherwise call `fn` with the error and return its result.\r\n *\r\n * @param result - The Result to start from.\r\n * @param fn - Recovery function receiving the error.\r\n * @returns The original Result if Ok, otherwise the recovery Result.\r\n */\r\nexport function orElse<T, E, F>(\r\n  result: Result<T, E>,\r\n  fn: (error: E) => Result<T, F>\r\n): Result<T, F> {\r\n  if (result.ok) return result;\r\n  return fn(result.error);\r\n}\r\n\r\n/** Combine two independent Results into a Result of a tuple.\r\n *\r\n * @param a - The first Result.\r\n * @param b - The second Result.\r\n * @returns Ok of the value tuple, or the first Err encountered.\r\n */\r\nexport function zip<A, B, E>(a: Result<A, E>, b: Result<B, E>): Result<[A, B], E> {\r\n  if (!a.ok) return a;\r\n  if (!b.ok) return b;\r\n  return ok([a.value, b.value]);\r\n}\r\n\r\n/** Collect an array of Results into a Result of an array. Alias for {@link collect}. */\r\nexport const all = collect;\r\n\r\n/** Run a side-effect on an Ok value without transforming the result.\r\n *\r\n * @param result - The Result to tap.\r\n * @param fn - Side-effect function called with the Ok value.\r\n * @returns The original Result, unchanged.\r\n */\r\nexport function tap<T, E>(result: Result<T, E>, fn: (value: T) => void): Result<T, E> {\r\n  if (result.ok) fn(result.value);\r\n  return result;\r\n}\r\n\r\n/** Run a side-effect on an Err value without transforming the result.\r\n *\r\n * @param result - The Result to tap.\r\n * @param fn - Side-effect function called with the error value.\r\n * @returns The original Result, unchanged.\r\n */\r\nexport function tapErr<T, E>(result: Result<T, E>, fn: (error: E) => void): Result<T, E> {\r\n  if (!result.ok) fn(result.error);\r\n  return result;\r\n}\r\n\r\n/** Flatten a nested Result<Result<T, E>, E> into Result<T, E>.\r\n *\r\n * @param result - The nested Result to flatten.\r\n * @returns The inner Result if Ok, otherwise the outer error.\r\n */\r\nexport function flatten<T, E>(result: Result<Result<T, E>, E>): Result<T, E> {\r\n  return result.ok ? result.value : result;\r\n}\r\n\r\n/** Map both Ok and Err variants in a single pass.\r\n *\r\n * @param result - The Result to transform.\r\n * @param okFn - Function applied to the Ok value.\r\n * @param errFn - Function applied to the error value.\r\n * @returns A Result with both variants transformed.\r\n */\r\nexport function mapBoth<T, U, E, F>(\r\n  result: Result<T, E>,\r\n  okFn: (value: T) => U,\r\n  errFn: (error: E) => F\r\n): Result<U, F> {\r\n  return result.ok ? ok(okFn(result.value)) : err(errFn(result.error));\r\n}\r\n\r\n/** Convert a nullable value to a Result, using `errorFn` to produce the error for null/undefined.\r\n *\r\n * @param value - The value to wrap; may be null or undefined.\r\n * @param errorFn - Factory producing the error for null/undefined input.\r\n * @returns Ok containing the value, or Err from `errorFn`.\r\n */\r\nexport function fromNullable<T, E>(value: T | null | undefined, errorFn: () => E): Result<T, E> {\r\n  if (value === null || value === undefined) return err(errorFn());\r\n  return ok(value);\r\n}\r\n\r\n// ---------------------------------------------------------------------------\r\n// Extraction\r\n// ---------------------------------------------------------------------------\r\n\r\n/** Format an error for display, handling BrepError objects specially */\r\nfunction formatError(error: unknown): string {\r\n  if (\r\n    typeof error === 'object' &&\r\n    error !== null &&\r\n    'kind' in error &&\r\n    'code' in error &&\r\n    'message' in error\r\n  ) {\r\n    // BrepError-like object\r\n    const e = error as { kind: string; code: string; message: string };\r\n    return `[${e.kind}] ${e.code}: ${e.message}`;\r\n  }\r\n  return String(error);\r\n}\r\n\r\n/** Extract the Ok value, throwing if the Result is Err.\r\n *\r\n * @param result - The Result to unwrap.\r\n * @returns The Ok value.\r\n */\r\nexport function unwrap<T, E>(result: Result<T, E>): T {\r\n  if (result.ok) return result.value;\r\n  throw new Error(`Called unwrap() on an Err: ${formatError(result.error)}`);\r\n}\r\n\r\n/** Extract the Ok value, returning a default if the Result is Err.\r\n *\r\n * @param result - The Result to unwrap.\r\n * @param defaultValue - Value returned when the Result is Err.\r\n * @returns The Ok value, or the default.\r\n */\r\nexport function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T {\r\n  if (result.ok) return result.value;\r\n  return defaultValue;\r\n}\r\n\r\n/** Extract the Ok value, computing a fallback from the error if the Result is Err.\r\n *\r\n * @param result - The Result to unwrap.\r\n * @param fn - Function producing a fallback value from the error.\r\n * @returns The Ok value, or the fallback.\r\n */\r\nexport function unwrapOrElse<T, E>(result: Result<T, E>, fn: (error: E) => T): T {\r\n  if (result.ok) return result.value;\r\n  return fn(result.error);\r\n}\r\n\r\n/** Extract the Err value, throwing if the Result is Ok.\r\n *\r\n * @param result - The Result to unwrap.\r\n * @returns The error value.\r\n */\r\nexport function unwrapErr<T, E>(result: Result<T, E>): E {\r\n  if (!result.ok) return result.error;\r\n  throw new Error(`Called unwrapErr() on an Ok: ${String(result.value)}`);\r\n}\r\n\r\n// ---------------------------------------------------------------------------\r\n// Pattern matching\r\n// ---------------------------------------------------------------------------\r\n\r\n/** Pattern-match a Result, applying the ok or err handler.\r\n *\r\n * @param result - The Result to match on.\r\n * @param handlers - Object with `ok` and `err` handler functions.\r\n * @returns The value produced by the matching handler.\r\n */\r\nexport function match<T, E, U>(\r\n  result: Result<T, E>,\r\n  handlers: { ok: (value: T) => U; err: (error: E) => U }\r\n): U {\r\n  if (result.ok) return handlers.ok(result.value);\r\n  return handlers.err(result.error);\r\n}\r\n\r\n// ---------------------------------------------------------------------------\r\n// Collection\r\n// ---------------------------------------------------------------------------\r\n\r\n/**\r\n * Collects an array of Results into a Result of an array.\r\n * Short-circuits on the first Err.\r\n *\r\n * @param results - The array of Results to collect.\r\n * @returns Ok of all values, or the first Err.\r\n */\r\nexport function collect<T, E>(results: Result<T, E>[]): Result<T[], E> {\r\n  const values: T[] = [];\r\n  for (const result of results) {\r\n    if (!result.ok) return result;\r\n    values.push(result.value);\r\n  }\r\n  return ok(values);\r\n}\r\n\r\n// ---------------------------------------------------------------------------\r\n// Try-catch boundary\r\n// ---------------------------------------------------------------------------\r\n\r\n/**\r\n * Wraps a throwing function into a Result.\r\n * The mapError function converts the caught exception into the error type.\r\n *\r\n * @param fn - The function to execute.\r\n * @param mapError - Converts a caught exception into the error type.\r\n * @returns Ok of the result, or Err of the mapped exception.\r\n */\r\nexport function tryCatch<T, E>(fn: () => T, mapError: (error: unknown) => E): Result<T, E> {\r\n  try {\r\n    return ok(fn());\r\n  } catch (e: unknown) {\r\n    return err(mapError(e));\r\n  }\r\n}\r\n\r\n/**\r\n * Wraps an async throwing function into a Result.\r\n * The mapError function converts the caught exception into the error type.\r\n *\r\n * @param fn - The async function to execute.\r\n * @param mapError - Converts a caught exception into the error type.\r\n * @returns A promise resolving to Ok of the result, or Err of the mapped exception.\r\n */\r\nexport async function tryCatchAsync<T, E>(\r\n  fn: () => Promise<T>,\r\n  mapError: (error: unknown) => E\r\n): Promise<Result<T, E>> {\r\n  try {\r\n    return ok(await fn());\r\n  } catch (e: unknown) {\r\n    return err(mapError(e));\r\n  }\r\n}\r\n\r\n// ---------------------------------------------------------------------------\r\n// Pipeline combinator\r\n// ---------------------------------------------------------------------------\r\n\r\n/** A chainable pipeline that short-circuits on the first Err. */\r\nexport interface ResultPipeline<T, E> {\r\n  /** Chain a Result-returning transform. Short-circuits on Err. */\r\n  then<U>(fn: (value: T) => Result<U, E>): ResultPipeline<U, E>;\r\n  /** Extract the final Result. */\r\n  readonly result: Result<T, E>;\r\n}\r\n\r\n/**\r\n * Create a chainable pipeline from a value or Result.\r\n *\r\n * ```ts\r\n * pipeline(shape)\r\n *   .then(s => filletShape(s, edges, 2))\r\n *   .then(s => shellShape(s, [topFace], 1))\r\n *   .result  // → Result<Shape3D>\r\n * ```\r\n *\r\n * @param input - A plain value or a Result to start the pipeline from.\r\n * @returns A chainable pipeline wrapping the input.\r\n */\r\nexport function pipeline<T, E = BrepError>(input: T | Result<T, E>): ResultPipeline<T, E> {\r\n  // Detect Result objects by checking the 'ok' discriminant is a boolean\r\n  function isResult(v: unknown): v is Result<T, E> {\r\n    return (\r\n      typeof v === 'object' &&\r\n      v !== null &&\r\n      'ok' in v &&\r\n      typeof (v as Record<string, unknown>)['ok'] === 'boolean'\r\n    );\r\n  }\r\n\r\n  const initial: Result<T, E> = isResult(input) ? input : ok(input);\r\n\r\n  function makePipeline<U>(current: Result<U, E>): ResultPipeline<U, E> {\r\n    return {\r\n      then<V>(fn: (value: U) => Result<V, E>): ResultPipeline<V, E> {\r\n        if (!current.ok) return makePipeline(current as Result<V, E>);\r\n        return makePipeline(fn(current.value));\r\n      },\r\n      get result(): Result<U, E> {\r\n        return current;\r\n      },\r\n    };\r\n  }\r\n\r\n  return makePipeline(initial);\r\n}\r\n"]}

package/dist/result/vec3.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：`wasmIndex` 复制自 brepjs
+ * `src/utils/vec3.ts`（同源复制，仅提取 errors.ts 依赖的最小符号）。
+ */
+/** Safe typed array index access（brepjs 原语义：`arr[i] as T`）。
+ *
+ * @param arr - The array to index into.
+ * @param i - The index to access.
+ * @returns The element at index `i`.
+ */
+export declare function wasmIndex<T>(arr: ArrayLike<T>, i: number): T;
+//# sourceMappingURL=vec3.d.ts.map

package/dist/result/vec3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vec3.d.ts","sourceRoot":"","sources":["../../src/result/vec3.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAE5D"}

package/dist/result/vec3.js

@@ -0,0 +1,14 @@
+/**
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：`wasmIndex` 复制自 brepjs
+ * `src/utils/vec3.ts`（同源复制，仅提取 errors.ts 依赖的最小符号）。
+ */
+/** Safe typed array index access（brepjs 原语义：`arr[i] as T`）。
+ *
+ * @param arr - The array to index into.
+ * @param i - The index to access.
+ * @returns The element at index `i`.
+ */
+export function wasmIndex(arr, i) {
+    return arr[i];
+}
+//# sourceMappingURL=vec3.js.map

package/dist/result/vec3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vec3.js","sourceRoot":"","sources":["../../src/result/vec3.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAI,GAAiB,EAAE,CAAS;IACvD,OAAO,GAAG,CAAC,CAAC,CAAM,CAAC;AACrB,CAAC","sourcesContent":["/**\n * 第一方模块（2026-09-25 core-decouple Phase 1）：`wasmIndex` 复制自 brepjs\n * `src/utils/vec3.ts`（同源复制，仅提取 errors.ts 依赖的最小符号）。\n */\n\n/** Safe typed array index access（brepjs 原语义：`arr[i] as T`）。\n *\n * @param arr - The array to index into.\n * @param i - The index to access.\n * @returns The element at index `i`.\n */\nexport function wasmIndex<T>(arr: ArrayLike<T>, i: number): T {\n  return arr[i] as T;\n}\n"]}

package/dist/runtime-state.d.ts

@@ -55,6 +55,15 @@ export interface Backends {
          */
         brepCapabilities?: {
             evolution?: readonly string[];
+            /**
+             * 非演化内核方法名（D5）：本引擎**实际提供**的 L1 中立方法名
+             * （`getBoundingBox` / `getVolume` / `getSurfaceArea` / `getLength` /
+             * `getCenterOfMass` 等）。2026-09-24 narrowing plan §2.4：与
+             * `backend-dispatch.EngineCapabilitiesLike` 对齐（该类型有 `methods`，
+             * 运行时配置镜像此前缺失——非字面量赋值不做 excess property 检查，
+             * `methods` 判定"能用但没被契约钉住"）。
+             */
+            methods?: readonly string[];
             heal?: boolean;
             directEdit?: boolean;
             advSurface?: boolean;