@code3d/core 0.0.1-alpha.0

package/bld/library/sketch.d.ts

@@ -0,0 +1,142 @@
+import { type FaceModel } from './runtime.js';
+/** Current coordinates in a sketch's local two-dimensional plane. */
+export type SketchPosition = readonly [x: number, y: number];
+export type SketchArcDirection = 'cw' | 'ccw';
+export type SketchEntry = readonly [
+    kind: 'point',
+    id: number,
+    data: SketchPosition | number | SketchPoint
+] | readonly [
+    kind: 'line',
+    id: number,
+    points: readonly [start: number | SketchPoint, end: number | SketchPoint]
+] | readonly [
+    kind: 'circle',
+    id: number,
+    data: readonly [center: number | SketchPoint, radius: number]
+] | readonly [
+    kind: 'arc',
+    id: number,
+    data: readonly [
+        center: number | SketchPoint,
+        radius: number,
+        start: number | SketchPoint,
+        end: number | SketchPoint,
+        direction: SketchArcDirection
+    ]
+];
+/** A point reference carries its defining layer, not just a numeric ID. */
+export interface SketchPoint {
+    readonly sketch: Sketch;
+    readonly id: number;
+}
+/** Constraints are separate from geometry and do not have persistent IDs. */
+export type SketchConstraint<P = number | SketchPoint> = readonly [kind: 'fixed', point: P] | readonly [kind: 'horizontal' | 'vertical', line: number] | readonly [
+    kind: 'parallel' | 'perpendicular',
+    lines: readonly [number, number]
+]
+/** Signed rotation from the first line's authored direction to the second, in degrees. */
+ | readonly [kind: 'angle', lines: readonly [number, number], value: number] | readonly [kind: 'coincident', points: readonly [P, P]] | readonly [
+    kind: 'midpoint',
+    points: readonly [midpoint: P, start: P, end: P]
+] | readonly [
+    kind: 'length' | 'angle' | 'radius' | 'sweep',
+    curve: number,
+    value: number
+] | readonly [kind: 'x' | 'y', point: P, value: number];
+export type SketchOptions = Readonly<{
+    constraints?: readonly SketchConstraint[];
+}>;
+/** An immutable sketch definition, independent of B-Rep construction. */
+export interface Sketch {
+    /** References a point defined in this layer. */
+    point(id: number): SketchPoint;
+    /** Adds a local layer while retaining the upstream sketch as read-only input. */
+    derive(entries?: readonly SketchEntry[], options?: SketchOptions): Sketch;
+    /** Creates the only closed region, including holes. Requires exactly one face. */
+    face(): FaceModel;
+    /** Creates all closed regions, including upstream boundaries. Returns an ordinary array. */
+    faces(): readonly FaceModel[];
+}
+type Definition = Readonly<{
+    base?: Sketch;
+    /** Used only to identify the authored argument during source tracing. */
+    input?: readonly SketchEntry[];
+    inputOptions?: SketchOptions;
+    entries: readonly SketchEntry[];
+    constraints: readonly SketchConstraint[];
+    points: ReadonlyMap<number, SketchPosition>;
+    radii: ReadonlyMap<number, number>;
+    degreesOfFreedom: number;
+    redundant: readonly number[];
+}>;
+/** Defines a sketch using [kind, ID, data] tuples. IDs belong to this layer. */
+export declare function sketch(entries?: readonly SketchEntry[], options?: SketchOptions): Sketch;
+export declare function isSketch(value: unknown): value is Sketch;
+export declare function sketchDefinition(value: Sketch): Definition;
+export type SketchPointSnapshot = Readonly<{
+    kind: 'point';
+    id: number;
+    position: SketchPosition;
+    /** Same geometric point, retaining this authored ID for references. */
+    alias?: SketchPointAddress;
+}>;
+export type SketchPointAddress = Readonly<{
+    layer: string;
+    id: number;
+}>;
+export type SketchLineSnapshot = Readonly<{
+    kind: 'line';
+    id: number;
+    points: readonly [SketchPointAddress, SketchPointAddress];
+}>;
+export type SketchCircleSnapshot = Readonly<{
+    kind: 'circle';
+    id: number;
+    center: SketchPointAddress;
+    radius: number;
+}>;
+export type SketchArcSnapshot = Readonly<{
+    kind: 'arc';
+    id: number;
+    center: SketchPointAddress;
+    radius: number;
+    points: readonly [SketchPointAddress, SketchPointAddress];
+    direction: SketchArcDirection;
+}>;
+export type SketchEntitySnapshot = SketchPointSnapshot | SketchLineSnapshot | SketchCircleSnapshot | SketchArcSnapshot;
+/** Numeric geometry parameters, excluding identity and point references. */
+export declare function sketchEntityParameters(entity: SketchEntitySnapshot): readonly number[];
+export declare function withSketchEntityParameters(entity: SketchEntitySnapshot, parameters: readonly number[]): SketchEntitySnapshot;
+/** Each snapshot contains only its own definitions; base retains the lineage. */
+export type SketchSnapshot = Readonly<{
+    id: string;
+    base?: string;
+    entities: readonly SketchEntitySnapshot[];
+    constraints: readonly SketchConstraint<SketchPointAddress>[];
+    degreesOfFreedom: number;
+    /** Evaluation-local indices into constraints, not persistent identity. */
+    redundant: readonly number[];
+}>;
+export declare function snapshotSketch(value: Sketch, identity: (sketch: Sketch) => string): SketchSnapshot;
+/** Resolve identity once for solving, dragging, snapping and topology edits. */
+export declare function sketchPointResolver(layers: readonly SketchSnapshot[]): (ref: SketchPointAddress) => SketchPointAddress;
+/** Includes gesture-only equations, not merely authored constraints. */
+export declare function sketchDragRequiresSolver(layers: readonly SketchSnapshot[]): boolean;
+/** Source replay must retain every gesture-start incidence, including aliases. */
+export declare function assertSketchDragConnections(layers: readonly SketchSnapshot[], reference: SketchSnapshot): void;
+/** The same solver and snapshot contract serve evaluation and interactive dragging. */
+export declare function solveSketchSnapshot(layers: readonly SketchSnapshot[], drag?: Readonly<{
+    id: number;
+    position: SketchPosition;
+    /** Gesture-start geometry; previous-frame geometry remains the numeric seed. */
+    reference?: SketchSnapshot;
+    /** Numeric, gesture-only parameter locks; never author constraints. */
+    locks?: readonly Readonly<{
+        id: number;
+        parameter: number;
+        value: number;
+    }>[];
+}>): SketchSnapshot;
+export {};
+//# sourceMappingURL=sketch.d.ts.map

package/bld/library/sketch.d.ts.map

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