@faicad/faijs-sketch 0.18.0

package/dist/node.js

@@ -0,0 +1,34 @@
+/**
+ * @faicad/faijs-sketch/node — Node-only entry.
+ *
+ * Resolves the planegcs WASM binary from the installed package and hands it to
+ * the environment-agnostic solver factory. Browser/worker hosts must not import
+ * this subpath — they inject wasm bytes through `HostPorts.assets` and call
+ * `createPlanegcsSolver({ wasmBytes })` from the main entry instead.
+ */
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { createPlanegcsSolver } from './planegcs-backend.js';
+const require = createRequire(import.meta.url);
+let wasmPathCache;
+/**
+ * Resolve the planegcs WASM binary path from the installed package.
+ *
+ * @returns the absolute path of `planegcs.wasm` inside `@salusoft89/planegcs`.
+ */
+export function planegcsWasmPath() {
+    if (!wasmPathCache) {
+        const pkgDir = dirname(require.resolve('@salusoft89/planegcs/package.json'));
+        wasmPathCache = join(pkgDir, 'dist', 'planegcs_dist', 'planegcs.wasm');
+    }
+    return wasmPathCache;
+}
+/**
+ * Instantiate the planegcs solver using the installed wasm binary.
+ *
+ * @returns a `SketchSolver` backed by the planegcs WASM module.
+ */
+export async function createNodePlanegcsSolver() {
+    return createPlanegcsSolver({ wasmPath: planegcsWasmPath() });
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAG5D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAE9C,IAAI,aAAiC,CAAA;AAErC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,CAAA;QAC5E,aAAa,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,CAAC,CAAA;IACxE,CAAC;IACD,OAAO,aAAa,CAAA;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,OAAO,oBAAoB,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAA;AAC/D,CAAC","sourcesContent":["/**\n * @faicad/faijs-sketch/node — Node-only entry.\n *\n * Resolves the planegcs WASM binary from the installed package and hands it to\n * the environment-agnostic solver factory. Browser/worker hosts must not import\n * this subpath — they inject wasm bytes through `HostPorts.assets` and call\n * `createPlanegcsSolver({ wasmBytes })` from the main entry instead.\n */\nimport { createRequire } from 'node:module'\nimport { dirname, join } from 'node:path'\nimport { createPlanegcsSolver } from './planegcs-backend.js'\nimport type { SketchSolver } from './solver.js'\n\nconst require = createRequire(import.meta.url)\n\nlet wasmPathCache: string | undefined\n\n/**\n * Resolve the planegcs WASM binary path from the installed package.\n *\n * @returns the absolute path of `planegcs.wasm` inside `@salusoft89/planegcs`.\n */\nexport function planegcsWasmPath(): string {\n  if (!wasmPathCache) {\n    const pkgDir = dirname(require.resolve('@salusoft89/planegcs/package.json'))\n    wasmPathCache = join(pkgDir, 'dist', 'planegcs_dist', 'planegcs.wasm')\n  }\n  return wasmPathCache\n}\n\n/**\n * Instantiate the planegcs solver using the installed wasm binary.\n *\n * @returns a `SketchSolver` backed by the planegcs WASM module.\n */\nexport async function createNodePlanegcsSolver(): Promise<SketchSolver> {\n  return createPlanegcsSolver({ wasmPath: planegcsWasmPath() })\n}"]}

package/dist/op.d.ts

@@ -0,0 +1,67 @@
+import type { Shape } from '@faicad/faijs/mesh/types';
+import type { SketchConstraint, SketchGeom, SolveOutcome } from './canonical.js';
+import type { SketchSolver } from './solver.js';
+/** The op name `cad.sketch`. */
+export declare const SKETCH_OP_NAME: "sketch";
+/**
+ * Install the host's planegcs solver factory.
+ *
+ * Node hosts pass `createNodePlanegcsSolver` from `@faicad/faijs-sketch/node`;
+ * browser hosts pass a factory that resolves the wasm bytes through
+ * `HostPorts.assets` and calls `createPlanegcsSolver({ wasmBytes })`.
+ *
+ * @param factory - async factory returning a `SketchSolver`.
+ */
+export declare function installSketchSolver(factory: () => Promise<SketchSolver>): void;
+/** Undo {@link installSketchSolver}. */
+export declare function uninstallSketchSolver(): void;
+/**
+ * Install a diagnostics sink for non-`solved` outcomes (§5: allow ≠ silent).
+ *
+ * Hosts bridge this to their `HostPorts.events` sink / UI. Under-, redundant-
+ * and conflicting-constraint sketches still produce geometry, but the
+ * diagnostic must reach the host.
+ *
+ * @param sink - receives every non-`solved` solve outcome; `null` clears it.
+ */
+export declare function setSketchDiagnosticSink(sink: ((outcome: SolveOutcome) => void) | null): void;
+/** `cad.sketch` parameters. */
+export interface SketchParams {
+    geoms: SketchGeom[];
+    /** Optional — a constraint-free sketch is equivalent to `cad.profile` usage. */
+    constraints?: SketchConstraint[];
+    /** Product form: `'face'` (default) or `'wire'` (outer wire for sweep spines). */
+    as?: 'face' | 'wire';
+}
+/**
+ * Validate `cad.sketch` parameters: `geoms` must be a non-empty array and
+ * `constraints`, when present, an array.
+ *
+ * @param params - the raw sketch operation parameters.
+ */
+export declare function assertSketchParams(params: Record<string, unknown>): void;
+/**
+ * Sketch (geometry + constraints) → solve → face / outer wire.
+ *
+ * brep-only in the first release (D5): the mesh path reports
+ * `E_MESH_UNSUPPORTED`, matching `cad.profile` / `cad.extrude`.
+ *
+ * @group 创建
+ * @inputs 0
+ * @async true
+ * @qual ok
+ * @name sketch
+ * @returns Shape 平面几何（求解后构面）；`as:'wire'` 时返回外环 1D 曲线。
+ * @param params.geoms - 草图几何（线段/圆/圆弧）。type:SketchGeom[] required:true
+ * @param params.constraints - 草图约束（可空）。type:SketchConstraint[] required:false
+ * @param params.as - 产物形态：'face'（默认）构面；'wire' 只交外环 wire。type:'face'|'wire' required:false
+ * @example
+ * const f = cad.sketch({
+ *   geoms: [{ tag:'bottom', kind:'line', x1:0, y1:0, x2:80, y2:3 }],
+ *   constraints: [{ kind:'horizontal', of: { tag:'bottom' } }, { kind:'length', of: { tag:'bottom' }, value: 80 }],
+ * })
+ */
+export declare const sketch: ((params: Record<string, unknown>) => Promise<Shape>) & {
+    __faijs__dualOp?: import("@faicad/faijs/sdk").DualOpMeta;
+};
+//# sourceMappingURL=op.d.ts.map

package/dist/op.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"op.d.ts","sourceRoot":"","sources":["../src/op.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAEhF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,gCAAgC;AAChC,eAAO,MAAM,cAAc,EAAG,QAAiB,CAAA;AAK/C;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAE9E;AAED,wCAAwC;AACxC,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAE5F;AAED,+BAA+B;AAC/B,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,gFAAgF;IAChF,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAChC,kFAAkF;IAClF,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQxE;AASD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,MAAM;;CAgBjB,CAAA"}

package/dist/op.js

@@ -0,0 +1,104 @@
+/**
+ * op — the `cad.sketch` script-face op (sketch geometry + constraints → face).
+ *
+ * This op is provided by the sketch library, not core: a host merges it into
+ * the `cad` namespace (see `./namespace`) only when it wants sketch support.
+ * The planegcs solver is host-injected (`installSketchSolver`) because the wasm
+ * source differs between Node and browser hosts — the library itself never
+ * imports `node:*`.
+ */
+import { defineOp } from '@faicad/faijs/sdk';
+import { sketchFaces } from './faces.js';
+/** The op name `cad.sketch`. */
+export const SKETCH_OP_NAME = 'sketch';
+let solverFactory;
+let diagnosticSink;
+/**
+ * Install the host's planegcs solver factory.
+ *
+ * Node hosts pass `createNodePlanegcsSolver` from `@faicad/faijs-sketch/node`;
+ * browser hosts pass a factory that resolves the wasm bytes through
+ * `HostPorts.assets` and calls `createPlanegcsSolver({ wasmBytes })`.
+ *
+ * @param factory - async factory returning a `SketchSolver`.
+ */
+export function installSketchSolver(factory) {
+    solverFactory = factory;
+}
+/** Undo {@link installSketchSolver}. */
+export function uninstallSketchSolver() {
+    solverFactory = undefined;
+}
+/**
+ * Install a diagnostics sink for non-`solved` outcomes (§5: allow ≠ silent).
+ *
+ * Hosts bridge this to their `HostPorts.events` sink / UI. Under-, redundant-
+ * and conflicting-constraint sketches still produce geometry, but the
+ * diagnostic must reach the host.
+ *
+ * @param sink - receives every non-`solved` solve outcome; `null` clears it.
+ */
+export function setSketchDiagnosticSink(sink) {
+    diagnosticSink = sink ?? undefined;
+}
+/**
+ * Validate `cad.sketch` parameters: `geoms` must be a non-empty array and
+ * `constraints`, when present, an array.
+ *
+ * @param params - the raw sketch operation parameters.
+ */
+export function assertSketchParams(params) {
+    const geoms = params.geoms;
+    if (!Array.isArray(geoms) || geoms.length === 0) {
+        throw new Error('E_SKETCHC_NO_GEOMS: sketch requires at least one geometry');
+    }
+    if (params.constraints !== undefined && !Array.isArray(params.constraints)) {
+        throw new Error('E_SKETCHC_BAD_CONSTRAINTS: constraints must be an array');
+    }
+}
+async function resolveSolver() {
+    if (!solverFactory) {
+        throw new Error('E_SKETCHC_NO_SOLVER: no sketch solver installed (call installSketchSolver)');
+    }
+    return solverFactory();
+}
+/**
+ * Sketch (geometry + constraints) → solve → face / outer wire.
+ *
+ * brep-only in the first release (D5): the mesh path reports
+ * `E_MESH_UNSUPPORTED`, matching `cad.profile` / `cad.extrude`.
+ *
+ * @group 创建
+ * @inputs 0
+ * @async true
+ * @qual ok
+ * @name sketch
+ * @returns Shape 平面几何（求解后构面）；`as:'wire'` 时返回外环 1D 曲线。
+ * @param params.geoms - 草图几何（线段/圆/圆弧）。type:SketchGeom[] required:true
+ * @param params.constraints - 草图约束（可空）。type:SketchConstraint[] required:false
+ * @param params.as - 产物形态：'face'（默认）构面；'wire' 只交外环 wire。type:'face'|'wire' required:false
+ * @example
+ * const f = cad.sketch({
+ *   geoms: [{ tag:'bottom', kind:'line', x1:0, y1:0, x2:80, y2:3 }],
+ *   constraints: [{ kind:'horizontal', of: { tag:'bottom' } }, { kind:'length', of: { tag:'bottom' }, value: 80 }],
+ * })
+ */
+export const sketch = defineOp({
+    name: SKETCH_OP_NAME,
+    capabilities: ['directEdit'],
+    async brep(params) {
+        assertSketchParams(params);
+        const solver = await resolveSolver();
+        const p = params;
+        return sketchFaces(p.geoms, p.constraints ?? [], {
+            solver,
+            as: p.as,
+            onDiagnostic: (outcome) => {
+                if (outcome.status !== 'solved')
+                    diagnosticSink?.(outcome);
+            },
+        });
+    },
+    naming: { kind: 'construct', newFaces: { via: 'explicit', vocab: [] } },
+});
+//# sourceMappingURL=op.js.map

package/dist/op.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"op.js","sourceRoot":"","sources":["../src/op.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAI5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,gCAAgC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,QAAiB,CAAA;AAE/C,IAAI,aAAwD,CAAA;AAC5D,IAAI,cAA6D,CAAA;AAEjE;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAoC;IACtE,aAAa,GAAG,OAAO,CAAA;AACzB,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,qBAAqB;IACnC,aAAa,GAAG,SAAS,CAAA;AAC3B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAA8C;IACpF,cAAc,GAAG,IAAI,IAAI,SAAS,CAAA;AACpC,CAAC;AAWD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA+B;IAChE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC9E,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAA;IAC5E,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAA;IAC/F,CAAC;IACD,OAAO,aAAa,EAAE,CAAA;AACxB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,CAAC;IAC7B,IAAI,EAAE,cAAc;IACpB,YAAY,EAAE,CAAC,YAAY,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,MAA+B;QACxC,kBAAkB,CAAC,MAAM,CAAC,CAAA;QAC1B,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAA;QACpC,MAAM,CAAC,GAAG,MAAiC,CAAA;QAC3C,OAAO,WAAW,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE,EAAE;YAC/C,MAAM;YACN,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE;gBACxB,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ;oBAAE,cAAc,EAAE,CAAC,OAAO,CAAC,CAAA;YAC5D,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,EAAgB;CACtF,CAAC,CAAA","sourcesContent":["/**\n * op — the `cad.sketch` script-face op (sketch geometry + constraints → face).\n *\n * This op is provided by the sketch library, not core: a host merges it into\n * the `cad` namespace (see `./namespace`) only when it wants sketch support.\n * The planegcs solver is host-injected (`installSketchSolver`) because the wasm\n * source differs between Node and browser hosts — the library itself never\n * imports `node:*`.\n */\nimport { defineOp } from '@faicad/faijs/sdk'\nimport type { Provenance } from '@faicad/faijs/topology/naming'\nimport type { Shape } from '@faicad/faijs/mesh/types'\nimport type { SketchConstraint, SketchGeom, SolveOutcome } from './canonical.js'\nimport { sketchFaces } from './faces.js'\nimport type { SketchSolver } from './solver.js'\n\n/** The op name `cad.sketch`. */\nexport const SKETCH_OP_NAME = 'sketch' as const\n\nlet solverFactory: (() => Promise<SketchSolver>) | undefined\nlet diagnosticSink: ((outcome: SolveOutcome) => void) | undefined\n\n/**\n * Install the host's planegcs solver factory.\n *\n * Node hosts pass `createNodePlanegcsSolver` from `@faicad/faijs-sketch/node`;\n * browser hosts pass a factory that resolves the wasm bytes through\n * `HostPorts.assets` and calls `createPlanegcsSolver({ wasmBytes })`.\n *\n * @param factory - async factory returning a `SketchSolver`.\n */\nexport function installSketchSolver(factory: () => Promise<SketchSolver>): void {\n  solverFactory = factory\n}\n\n/** Undo {@link installSketchSolver}. */\nexport function uninstallSketchSolver(): void {\n  solverFactory = undefined\n}\n\n/**\n * Install a diagnostics sink for non-`solved` outcomes (§5: allow ≠ silent).\n *\n * Hosts bridge this to their `HostPorts.events` sink / UI. Under-, redundant-\n * and conflicting-constraint sketches still produce geometry, but the\n * diagnostic must reach the host.\n *\n * @param sink - receives every non-`solved` solve outcome; `null` clears it.\n */\nexport function setSketchDiagnosticSink(sink: ((outcome: SolveOutcome) => void) | null): void {\n  diagnosticSink = sink ?? undefined\n}\n\n/** `cad.sketch` parameters. */\nexport interface SketchParams {\n  geoms: SketchGeom[]\n  /** Optional — a constraint-free sketch is equivalent to `cad.profile` usage. */\n  constraints?: SketchConstraint[]\n  /** Product form: `'face'` (default) or `'wire'` (outer wire for sweep spines). */\n  as?: 'face' | 'wire'\n}\n\n/**\n * Validate `cad.sketch` parameters: `geoms` must be a non-empty array and\n * `constraints`, when present, an array.\n *\n * @param params - the raw sketch operation parameters.\n */\nexport function assertSketchParams(params: Record<string, unknown>): void {\n  const geoms = params.geoms\n  if (!Array.isArray(geoms) || geoms.length === 0) {\n    throw new Error('E_SKETCHC_NO_GEOMS: sketch requires at least one geometry')\n  }\n  if (params.constraints !== undefined && !Array.isArray(params.constraints)) {\n    throw new Error('E_SKETCHC_BAD_CONSTRAINTS: constraints must be an array')\n  }\n}\n\nasync function resolveSolver(): Promise<SketchSolver> {\n  if (!solverFactory) {\n    throw new Error('E_SKETCHC_NO_SOLVER: no sketch solver installed (call installSketchSolver)')\n  }\n  return solverFactory()\n}\n\n/**\n * Sketch (geometry + constraints) → solve → face / outer wire.\n *\n * brep-only in the first release (D5): the mesh path reports\n * `E_MESH_UNSUPPORTED`, matching `cad.profile` / `cad.extrude`.\n *\n * @group 创建\n * @inputs 0\n * @async true\n * @qual ok\n * @name sketch\n * @returns Shape 平面几何（求解后构面）；`as:'wire'` 时返回外环 1D 曲线。\n * @param params.geoms - 草图几何（线段/圆/圆弧）。type:SketchGeom[] required:true\n * @param params.constraints - 草图约束（可空）。type:SketchConstraint[] required:false\n * @param params.as - 产物形态：'face'（默认）构面；'wire' 只交外环 wire。type:'face'|'wire' required:false\n * @example\n * const f = cad.sketch({\n *   geoms: [{ tag:'bottom', kind:'line', x1:0, y1:0, x2:80, y2:3 }],\n *   constraints: [{ kind:'horizontal', of: { tag:'bottom' } }, { kind:'length', of: { tag:'bottom' }, value: 80 }],\n * })\n */\nexport const sketch = defineOp({\n  name: SKETCH_OP_NAME,\n  capabilities: ['directEdit'],\n  async brep(params: Record<string, unknown>): Promise<Shape> {\n    assertSketchParams(params)\n    const solver = await resolveSolver()\n    const p = params as unknown as SketchParams\n    return sketchFaces(p.geoms, p.constraints ?? [], {\n      solver,\n      as: p.as,\n      onDiagnostic: (outcome) => {\n        if (outcome.status !== 'solved') diagnosticSink?.(outcome)\n      },\n    })\n  },\n  naming: { kind: 'construct', newFaces: { via: 'explicit', vocab: [] } } as Provenance,\n})"]}

package/dist/planegcs-backend.d.ts

@@ -0,0 +1,46 @@
+import type { GcsWrapper } from '@salusoft89/planegcs';
+import { type Result } from '@faicad/faijs/api/result';
+import type { FcstdSketchGeom, FcstdSketchCon } from './fcstd-types.js';
+import type { FcstdSolveOutcome, SketchSolver } from './solver.js';
+/** Options for instantiating the planegcs WASM solver. */
+export interface PlanegcsSolverOptions {
+    /** Absolute filesystem path to `planegcs.wasm` (Node hosts). */
+    wasmPath?: string;
+    /** Raw wasm bytes (browser/worker hosts, injected via HostPorts.assets). */
+    wasmBytes?: Uint8Array | ArrayBuffer;
+}
+/**
+ * Instantiate the planegcs WASM solver.
+ *
+ * Environment-agnostic: the host supplies the wasm source. Node hosts use
+ * `createNodePlanegcsSolver()` from `@faicad/faijs-sketch/node`; browser hosts
+ * pass bytes resolved through `HostPorts.assets`.
+ *
+ * @param options - wasm path (Node) or bytes (browser).
+ * @returns a `SketchSolver` backed by the planegcs WASM module.
+ */
+export declare function createPlanegcsSolver(options: PlanegcsSolverOptions): Promise<SketchSolver>;
+/**
+ * planegcs WASM implementation of the `SketchSolver` interface (M3.2–M3.4):
+ * pushes geometry/constraints into the GCS, solves, and pulls the solved
+ * parameters back into `FcstdSketchGeom` values.
+ */
+export declare class PlanegcsSolver implements SketchSolver {
+    private wrapper;
+    constructor(wrapper: GcsWrapper);
+    solve(geoms: FcstdSketchGeom[], constraints: FcstdSketchCon[], external?: import('./solver.js').ExternalFixedSeg[]): Promise<Result<FcstdSolveOutcome, never>>;
+    /**
+     * Remaining degrees of freedom after a successful solve (-1 if unavailable).
+     *
+     * @returns the DoF count, or -1 if the backend does not report it.
+     */
+    getDof(): number;
+    private constraintToPrimitives;
+    private pullBack;
+    /** Read a point's solved coordinates from the sketch index.
+     * apply_solution() already pulled every primitive's solved values back into
+     * sketch_index (gcs_wrapper.js:104-108), so get_primitive is authoritative. */
+    private readPoint;
+    private readCircleRadius;
+}
+//# sourceMappingURL=planegcs-backend.d.ts.map

package/dist/planegcs-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planegcs-backend.d.ts","sourceRoot":"","sources":["../src/planegcs-backend.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAExE,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEnE,0DAA0D;AAC1D,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,UAAU,GAAG,WAAW,CAAA;CACrC;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAOhG;AAOD;;;;GAIG;AACH,qBAAa,cAAe,YAAW,YAAY;IACrC,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,UAAU;IAEjC,KAAK,CACT,KAAK,EAAE,eAAe,EAAE,EACxB,WAAW,EAAE,cAAc,EAAE,EAC7B,QAAQ,CAAC,EAAE,OAAO,aAAa,EAAE,gBAAgB,EAAE,GAClD,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAwQ5C;;;;OAIG;IACH,MAAM,IAAI,MAAM;IAShB,OAAO,CAAC,sBAAsB;IAyR9B,OAAO,CAAC,QAAQ;IA0EhB;;mFAE+E;IAC/E,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,gBAAgB;CAIzB"}