@faicad/faijs 0.22.2 → 0.29.5

package/dist/api/cadquery-selectors/entity.d.ts

@@ -0,0 +1,121 @@
+/**
+ * cadquery-selectors/entity — projection of kernel handles into the geometric
+ * quantities the selector predicates need.
+ *
+ * Each helper mirrors the CadQuery shape method it stands in for (plan §4.3):
+ *   · `Vertex.Center()`      → vertex position
+ *   · `Edge.Center()`        → linear centre of mass (LinearProperties centroid)
+ *   · `Face.Center()`        → surface centre of mass (SurfaceProperties centroid)
+ *   · `Face.normalAt(None)`  → parametric surface normal at the uv midpoint,
+ *                              oriented outward via `containsPoint` on the owner
+ *   · `Edge.tangentAt()`     → curve tangent at the parameter midpoint,
+ *                              oriented along the edge parameter direction
+ *   · `Face/Edge.geomType()` → kernel surface/curve kind mapped to the CadQuery
+ *                              geom_LUT uppercased names
+ *
+ * These are deliberately decoupled from any single entity type so the
+ * predicates (predicates.ts) and the narrowing engine (resolve.ts) stay
+ * type-agnostic. All quantities are computed lazily by the caller via the
+ * projection object below.
+ *
+ * @platform occt — the projection resolves occt-wasm `ShapeHandle`s via the
+ * native kernel (`getKernel()`: getSubShapes / hashCode / isSame / bounds /
+ * surface & curve queries), so this module is occt-coupled by nature.
+ */
+import type { OcctKernel, ShapeHandle } from 'occt-wasm';
+/** Resolve the kernel geometry-kind → CadQuery LUT upcased name. */
+export interface GeomKindMap {
+    surface: Record<string, string>;
+    curve: Record<string, string>;
+}
+/**
+ * Map a kernel surface-kind string to the CadQuery `geomType()` name.
+ *
+ * @param kind - The kernel surface kind (e.g. `plane`, `cylinder`, `torus`).
+ * @returns The uppercased CadQuery geometry name, or `OTHER` when unmapped.
+ */
+export declare function faceGeomType(kind: string): string;
+/**
+ * Map a kernel curve-kind string to the CadQuery `geomType()` name.
+ *
+ * @param kind - The kernel curve kind (e.g. `line`, `circle`, `bspline`).
+ * @returns The uppercased CadQuery geometry name, or `OTHER` when unmapped.
+ */
+export declare function edgeGeomType(kind: string): string;
+/** World-space cartesian coordinates of an entity center point. */
+export interface EntityCenter {
+    x: number;
+    y: number;
+    z: number;
+}
+/** Plain 3-D vector in faijs' internal convention. */
+export type P3 = {
+    x: number;
+    y: number;
+    z: number;
+};
+export type { ShapeHandle };
+/**
+ * The lazily-evaluable geometry of one candidate entity. Predicates only access
+ * the fields they need so the heavy computation (surface normal, etc.) is only
+ * paid for when a direction/parallel filter is actually applied.
+ */
+export interface EntityGeom {
+    kind: 'face' | 'edge' | 'vertex';
+    /** Internal kernel handle for identity comparison (not part of the public surface). */
+    _handle: ShapeHandle;
+    /** Kernel handle box-identity hash (stable key across narrowing). */
+    hash(): number;
+    /** Kernel handle `isSame(...)` equality predicate. */
+    same(other: EntityGeom): boolean;
+    /** CadQuery `Shape.Center()` for this entity kind. */
+    center(): P3;
+    /**
+     * The direction used by direction-motivated selectors: the outward normal for
+     * a face (requires the owning shape for orientation) or the mid-parameter
+     * tangent for an edge. Null for vertices (no usable direction, upstream
+     * `BaseSelector` drops them).
+     */
+    direction(owner: ShapeHandle): P3 | null;
+    /** Face/Edge geometry type (upcased LUT name), or undefined for vertices. */
+    geomType(): string | undefined;
+}
+/**
+ * Project a face handle into its `EntityGeom`.
+ *
+ * @param face - The kernel face handle to project.
+ * @returns The lazily-evaluable face geometry (normal oriented on demand).
+ */
+export declare function faceGeom(face: ShapeHandle): EntityGeom;
+/**
+ * Orient a parametric face normal outward: offset probe → inside ⇒ flip.
+ *
+ * @param k - The active kernel instance used for surface/containment queries.
+ * @param face - The kernel face handle whose normal is oriented.
+ * @param owner - The owning shape handle used for the containment probe.
+ * @returns The outward-facing unit normal of `face`.
+ */
+export declare function orientedFaceNormal(k: OcctKernel, face: ShapeHandle, owner: ShapeHandle): P3;
+/**
+ * Project an edge handle into its `EntityGeom`.
+ *
+ * @param edge - The kernel edge handle to project.
+ * @returns The lazily-evaluable edge geometry (mid-parameter tangent).
+ */
+export declare function edgeGeom(edge: ShapeHandle): EntityGeom;
+/**
+ * Project a vertex handle into its `EntityGeom`.
+ *
+ * @param vertex - The kernel vertex handle to project.
+ * @returns The lazily-evaluable vertex geometry (no direction / type).
+ */
+export declare function vertexGeom(vertex: ShapeHandle): EntityGeom;
+/**
+ * Get the sub-entity handles of the given topological type from a shape.
+ *
+ * @param shape - The kernel handle to query.
+ * @param type - The topological type to enumerate.
+ * @returns The ordered kernel sub-shape handles of that type.
+ */
+export declare function subShapeHandles(shape: ShapeHandle, type: 'face' | 'edge' | 'vertex'): ShapeHandle[];
+//# sourceMappingURL=entity.d.ts.map

package/dist/api/cadquery-selectors/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../src/api/cadquery-selectors/entity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAQ,MAAM,WAAW,CAAA;AAE9D,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B;AA2BD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,sDAAsD;AACtD,MAAM,MAAM,EAAE,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpD,YAAY,EAAE,WAAW,EAAE,CAAA;AAM3B;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;IAChC,uFAAuF;IACvF,OAAO,EAAE,WAAW,CAAA;IACpB,qEAAqE;IACrE,IAAI,IAAI,MAAM,CAAA;IACd,sDAAsD;IACtD,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAA;IAChC,sDAAsD;IACtD,MAAM,IAAI,EAAE,CAAA;IACZ;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,EAAE,GAAG,IAAI,CAAA;IACxC,6EAA6E;IAC7E,QAAQ,IAAI,MAAM,GAAG,SAAS,CAAA;CAC/B;AAID;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAWtD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,UAAU,EACb,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,WAAW,GACjB,EAAE,CAgBJ;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAetD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAY1D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,EAAE,CAGnG"}

package/dist/api/cadquery-selectors/entity.js

@@ -0,0 +1,167 @@
+/**
+ * cadquery-selectors/entity — projection of kernel handles into the geometric
+ * quantities the selector predicates need.
+ *
+ * Each helper mirrors the CadQuery shape method it stands in for (plan §4.3):
+ *   · `Vertex.Center()`      → vertex position
+ *   · `Edge.Center()`        → linear centre of mass (LinearProperties centroid)
+ *   · `Face.Center()`        → surface centre of mass (SurfaceProperties centroid)
+ *   · `Face.normalAt(None)`  → parametric surface normal at the uv midpoint,
+ *                              oriented outward via `containsPoint` on the owner
+ *   · `Edge.tangentAt()`     → curve tangent at the parameter midpoint,
+ *                              oriented along the edge parameter direction
+ *   · `Face/Edge.geomType()` → kernel surface/curve kind mapped to the CadQuery
+ *                              geom_LUT uppercased names
+ *
+ * These are deliberately decoupled from any single entity type so the
+ * predicates (predicates.ts) and the narrowing engine (resolve.ts) stay
+ * type-agnostic. All quantities are computed lazily by the caller via the
+ * projection object below.
+ *
+ * @platform occt — the projection resolves occt-wasm `ShapeHandle`s via the
+ * native kernel (`getKernel()`: getSubShapes / hashCode / isSame / bounds /
+ * surface & curve queries), so this module is occt-coupled by nature.
+ */
+import { getKernel } from '../../occt-kernel/occtKernel.js';
+const NAMED_GEOM = {
+    surface: {
+        plane: 'PLANE',
+        cylinder: 'CYLINDER',
+        cone: 'CONE',
+        sphere: 'SPHERE',
+        torus: 'TORUS',
+        bspline: 'BSPLINE',
+        bezier: 'BEZIER',
+        offset: 'OFFSET',
+        revolution: 'REVOLUTION',
+        extrusion: 'EXTRUSION',
+    },
+    curve: {
+        line: 'LINE',
+        circle: 'CIRCLE',
+        ellipse: 'ELLIPSE',
+        hyperbola: 'HYPERBOLA',
+        parabola: 'PARABOLA',
+        bspline: 'BSPLINE',
+        bezier: 'BEZIER',
+        offset: 'OFFSET',
+    },
+};
+/**
+ * Map a kernel surface-kind string to the CadQuery `geomType()` name.
+ *
+ * @param kind - The kernel surface kind (e.g. `plane`, `cylinder`, `torus`).
+ * @returns The uppercased CadQuery geometry name, or `OTHER` when unmapped.
+ */
+export function faceGeomType(kind) {
+    return NAMED_GEOM.surface[kind] ?? 'OTHER';
+}
+/**
+ * Map a kernel curve-kind string to the CadQuery `geomType()` name.
+ *
+ * @param kind - The kernel curve kind (e.g. `line`, `circle`, `bspline`).
+ * @returns The uppercased CadQuery geometry name, or `OTHER` when unmapped.
+ */
+export function edgeGeomType(kind) {
+    return NAMED_GEOM.curve[kind] ?? 'OTHER';
+}
+function v(v) {
+    return { x: v.x, y: v.y, z: v.z };
+}
+const kern = () => getKernel();
+/**
+ * Project a face handle into its `EntityGeom`.
+ *
+ * @param face - The kernel face handle to project.
+ * @returns The lazily-evaluable face geometry (normal oriented on demand).
+ */
+export function faceGeom(face) {
+    const k = kern();
+    return {
+        kind: 'face',
+        _handle: face,
+        hash: () => k.hashCode(face, 1e9),
+        same: (other) => k.isSame(face, other._handle),
+        center: () => v(k.getSurfaceCenterOfMass(face)),
+        direction: (owner) => orientedFaceNormal(k, face, owner),
+        geomType: () => faceGeomType(k.surfaceType(face)),
+    };
+}
+/**
+ * Orient a parametric face normal outward: offset probe → inside ⇒ flip.
+ *
+ * @param k - The active kernel instance used for surface/containment queries.
+ * @param face - The kernel face handle whose normal is oriented.
+ * @param owner - The owning shape handle used for the containment probe.
+ * @returns The outward-facing unit normal of `face`.
+ */
+export function orientedFaceNormal(k, face, owner) {
+    const uv = k.uvBounds(face);
+    const u = (uv.uMin + uv.uMax) / 2;
+    const vv = (uv.vMin + uv.vMax) / 2;
+    const n = k.surfaceNormal(face, u, vv);
+    const db = k.getBoundingBox(face);
+    const ext = [db.xmax - db.xmin, db.ymax - db.ymin, db.zmax - db.zmin];
+    const minExt = Math.min(...ext, 1);
+    const eps = minExt * 1e-3 + 1e-6;
+    const center = k.pointOnSurface(face, u, vv);
+    const probe = { x: center.x + n.x * eps, y: center.y + n.y * eps, z: center.z + n.z * eps };
+    // inside owner ⇒ the candidate normal points inward, so flip it.
+    if (k.containsPoint(owner, probe, 1e-9)) {
+        return { x: -n.x, y: -n.y, z: -n.z };
+    }
+    return v(n);
+}
+/**
+ * Project an edge handle into its `EntityGeom`.
+ *
+ * @param edge - The kernel edge handle to project.
+ * @returns The lazily-evaluable edge geometry (mid-parameter tangent).
+ */
+export function edgeGeom(edge) {
+    const k = kern();
+    const midParams = () => {
+        const cp = k.curveParameters(edge);
+        return (cp.first + cp.last) / 2;
+    };
+    return {
+        kind: 'edge',
+        _handle: edge,
+        hash: () => k.hashCode(edge, 1e9),
+        same: (other) => k.isSame(edge, other._handle),
+        center: () => v(k.curvePointAtParam(edge, midParams())),
+        direction: () => v(k.curveTangent(edge, midParams())),
+        geomType: () => edgeGeomType(k.curveType(edge)),
+    };
+}
+/**
+ * Project a vertex handle into its `EntityGeom`.
+ *
+ * @param vertex - The kernel vertex handle to project.
+ * @returns The lazily-evaluable vertex geometry (no direction / type).
+ */
+export function vertexGeom(vertex) {
+    const k = kern();
+    const p = k.vertexPosition(vertex);
+    return {
+        kind: 'vertex',
+        _handle: vertex,
+        hash: () => k.hashCode(vertex, 1e9),
+        same: (other) => k.isSame(vertex, other._handle),
+        center: () => v(p),
+        direction: () => null,
+        geomType: () => undefined,
+    };
+}
+/**
+ * Get the sub-entity handles of the given topological type from a shape.
+ *
+ * @param shape - The kernel handle to query.
+ * @param type - The topological type to enumerate.
+ * @returns The ordered kernel sub-shape handles of that type.
+ */
+export function subShapeHandles(shape, type) {
+    const k = kern();
+    return k.getSubShapes(shape, type);
+}
+//# sourceMappingURL=entity.js.map

package/dist/api/cadquery-selectors/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../src/api/cadquery-selectors/entity.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * cadquery-selectors/entity — projection of kernel handles into the geometric\n * quantities the selector predicates need.\n *\n * Each helper mirrors the CadQuery shape method it stands in for (plan §4.3):\n *   · `Vertex.Center()`      → vertex position\n *   · `Edge.Center()`        → linear centre of mass (LinearProperties centroid)\n *   · `Face.Center()`        → surface centre of mass (SurfaceProperties centroid)\n *   · `Face.normalAt(None)`  → parametric surface normal at the uv midpoint,\n *                              oriented outward via `containsPoint` on the owner\n *   · `Edge.tangentAt()`     → curve tangent at the parameter midpoint,\n *                              oriented along the edge parameter direction\n *   · `Face/Edge.geomType()` → kernel surface/curve kind mapped to the CadQuery\n *                              geom_LUT uppercased names\n *\n * These are deliberately decoupled from any single entity type so the\n * predicates (predicates.ts) and the narrowing engine (resolve.ts) stay\n * type-agnostic. All quantities are computed lazily by the caller via the\n * projection object below.\n *\n * @platform occt — the projection resolves occt-wasm `ShapeHandle`s via the\n * native kernel (`getKernel()`: getSubShapes / hashCode / isSame / bounds /\n * surface & curve queries), so this module is occt-coupled by nature.\n */\n\nimport { getKernel } from '../../occt-kernel/occtKernel'\nimport type { OcctKernel, ShapeHandle, Vec3 } from 'occt-wasm'\n\n/** Resolve the kernel geometry-kind → CadQuery LUT upcased name. */\nexport interface GeomKindMap {\n  surface: Record<string, string>\n  curve: Record<string, string>\n}\n\nconst NAMED_GEOM: { surface: Record<string, string>; curve: Record<string, string> } = {\n  surface: {\n    plane: 'PLANE',\n    cylinder: 'CYLINDER',\n    cone: 'CONE',\n    sphere: 'SPHERE',\n    torus: 'TORUS',\n    bspline: 'BSPLINE',\n    bezier: 'BEZIER',\n    offset: 'OFFSET',\n    revolution: 'REVOLUTION',\n    extrusion: 'EXTRUSION',\n  },\n  curve: {\n    line: 'LINE',\n    circle: 'CIRCLE',\n    ellipse: 'ELLIPSE',\n    hyperbola: 'HYPERBOLA',\n    parabola: 'PARABOLA',\n    bspline: 'BSPLINE',\n    bezier: 'BEZIER',\n    offset: 'OFFSET',\n  },\n}\n\n/**\n * Map a kernel surface-kind string to the CadQuery `geomType()` name.\n *\n * @param kind - The kernel surface kind (e.g. `plane`, `cylinder`, `torus`).\n * @returns The uppercased CadQuery geometry name, or `OTHER` when unmapped.\n */\nexport function faceGeomType(kind: string): string {\n  return NAMED_GEOM.surface[kind] ?? 'OTHER'\n}\n\n/**\n * Map a kernel curve-kind string to the CadQuery `geomType()` name.\n *\n * @param kind - The kernel curve kind (e.g. `line`, `circle`, `bspline`).\n * @returns The uppercased CadQuery geometry name, or `OTHER` when unmapped.\n */\nexport function edgeGeomType(kind: string): string {\n  return NAMED_GEOM.curve[kind] ?? 'OTHER'\n}\n\n/** World-space cartesian coordinates of an entity center point. */\nexport interface EntityCenter {\n  x: number\n  y: number\n  z: number\n}\n\n/** Plain 3-D vector in faijs' internal convention. */\nexport type P3 = { x: number; y: number; z: number }\n\nexport type { ShapeHandle }\n\nfunction v(v: Vec3 | P3): P3 {\n  return { x: v.x, y: v.y, z: v.z }\n}\n\n/**\n * The lazily-evaluable geometry of one candidate entity. Predicates only access\n * the fields they need so the heavy computation (surface normal, etc.) is only\n * paid for when a direction/parallel filter is actually applied.\n */\nexport interface EntityGeom {\n  kind: 'face' | 'edge' | 'vertex'\n  /** Internal kernel handle for identity comparison (not part of the public surface). */\n  _handle: ShapeHandle\n  /** Kernel handle box-identity hash (stable key across narrowing). */\n  hash(): number\n  /** Kernel handle `isSame(...)` equality predicate. */\n  same(other: EntityGeom): boolean\n  /** CadQuery `Shape.Center()` for this entity kind. */\n  center(): P3\n  /**\n   * The direction used by direction-motivated selectors: the outward normal for\n   * a face (requires the owning shape for orientation) or the mid-parameter\n   * tangent for an edge. Null for vertices (no usable direction, upstream\n   * `BaseSelector` drops them).\n   */\n  direction(owner: ShapeHandle): P3 | null\n  /** Face/Edge geometry type (upcased LUT name), or undefined for vertices. */\n  geomType(): string | undefined\n}\n\nconst kern = (): OcctKernel => getKernel() as unknown as OcctKernel\n\n/**\n * Project a face handle into its `EntityGeom`.\n *\n * @param face - The kernel face handle to project.\n * @returns The lazily-evaluable face geometry (normal oriented on demand).\n */\nexport function faceGeom(face: ShapeHandle): EntityGeom {\n  const k = kern()\n  return {\n    kind: 'face',\n    _handle: face,\n    hash: () => k.hashCode(face, 1e9),\n    same: (other: EntityGeom) => k.isSame(face, other._handle),\n    center: () => v(k.getSurfaceCenterOfMass(face)),\n    direction: (owner: ShapeHandle) => orientedFaceNormal(k, face, owner),\n    geomType: () => faceGeomType(k.surfaceType(face)),\n  }\n}\n\n/**\n * Orient a parametric face normal outward: offset probe → inside ⇒ flip.\n *\n * @param k - The active kernel instance used for surface/containment queries.\n * @param face - The kernel face handle whose normal is oriented.\n * @param owner - The owning shape handle used for the containment probe.\n * @returns The outward-facing unit normal of `face`.\n */\nexport function orientedFaceNormal(\n  k: OcctKernel,\n  face: ShapeHandle,\n  owner: ShapeHandle,\n): P3 {\n  const uv = k.uvBounds(face)\n  const u = (uv.uMin + uv.uMax) / 2\n  const vv = (uv.vMin + uv.vMax) / 2\n  const n = k.surfaceNormal(face, u, vv)\n  const db = k.getBoundingBox(face)\n  const ext = [db.xmax - db.xmin, db.ymax - db.ymin, db.zmax - db.zmin]\n  const minExt = Math.min(...ext, 1)\n  const eps = minExt * 1e-3 + 1e-6\n  const center = k.pointOnSurface(face, u, vv)\n  const probe = { x: center.x + n.x * eps, y: center.y + n.y * eps, z: center.z + n.z * eps }\n  // inside owner ⇒ the candidate normal points inward, so flip it.\n  if (k.containsPoint(owner, probe, 1e-9)) {\n    return { x: -n.x, y: -n.y, z: -n.z }\n  }\n  return v(n)\n}\n\n/**\n * Project an edge handle into its `EntityGeom`.\n *\n * @param edge - The kernel edge handle to project.\n * @returns The lazily-evaluable edge geometry (mid-parameter tangent).\n */\nexport function edgeGeom(edge: ShapeHandle): EntityGeom {\n  const k = kern()\n  const midParams = () => {\n    const cp = k.curveParameters(edge)\n    return (cp.first + cp.last) / 2\n  }\n  return {\n    kind: 'edge',\n    _handle: edge,\n    hash: () => k.hashCode(edge, 1e9),\n    same: (other: EntityGeom) => k.isSame(edge, other._handle),\n    center: () => v(k.curvePointAtParam(edge, midParams())),\n    direction: () => v(k.curveTangent(edge, midParams())),\n    geomType: () => edgeGeomType(k.curveType(edge)),\n  }\n}\n\n/**\n * Project a vertex handle into its `EntityGeom`.\n *\n * @param vertex - The kernel vertex handle to project.\n * @returns The lazily-evaluable vertex geometry (no direction / type).\n */\nexport function vertexGeom(vertex: ShapeHandle): EntityGeom {\n  const k = kern()\n  const p = k.vertexPosition(vertex)\n  return {\n    kind: 'vertex',\n    _handle: vertex,\n    hash: () => k.hashCode(vertex, 1e9),\n    same: (other: EntityGeom) => k.isSame(vertex, other._handle),\n    center: () => v(p),\n    direction: () => null,\n    geomType: () => undefined,\n  }\n}\n\n/**\n * Get the sub-entity handles of the given topological type from a shape.\n *\n * @param shape - The kernel handle to query.\n * @param type - The topological type to enumerate.\n * @returns The ordered kernel sub-shape handles of that type.\n */\nexport function subShapeHandles(shape: ShapeHandle, type: 'face' | 'edge' | 'vertex'): ShapeHandle[] {\n  const k = kern()\n  return k.getSubShapes(shape, type) as ShapeHandle[]\n}"]}

package/dist/api/cadquery-selectors/face.d.ts

@@ -0,0 +1,33 @@
+/**
+ * cadquery-selectors/face — CadQuery face 字符串选择器
+ *
+ * 等价搬运自 `packages/faijs-cadquery/src/workplane.ts` 的 `resolveFaceSelector`
+ * （含其私有 `NAMED_VIEW_TO_AXIS`、`bboxMax`/`bboxMin`、`cad` 单例）。仅 import
+ * 路径改为 core 内部相对路径，逻辑逐行不变，零功能增减。
+ *
+ * @platform occt — face 选择对 BREP 面做枚举/比较，经 `getKernel()` 与
+ * `getBrepApi()` 访问 occt 原生内核（getSubShapes / surface 查询等）。
+ */
+import type { Shape } from '../../mesh/types.js';
+/**
+ * Resolve a CadQuery-style face selector string to the selected face's center
+ * point and outward normal.
+ *
+ * Supported forms: ">Z", "<Z", ">X", "<X", ">Y", "<Y", each with an optional
+ * CadQuery-style index suffix like ">Z[-2]", plus the six named views
+ * ("front"/"back"/"left"/"right"/"top"/"bottom") which are aliases for the
+ * corresponding axis selectors per cadquery/selectors.py:687-694.
+ * @param shape - Shape whose BREP faces are enumerated for selection.
+ * @param sel - Selector string, e.g. ">Z", "front", ">Z[-2]".
+ * @param centerOption - Optional center computation option forwarded to the
+ *   face-center evaluation.
+ * @returns Promise resolving to the selected face's center point and outward
+ *   normal.
+ * @throws Error when the selector matches no face or has unknown syntax
+ *   (never falls back silently).
+ */
+export declare function resolveFaceSelector(shape: Shape, sel: string, centerOption?: string): Promise<{
+    center: [number, number, number];
+    normal: [number, number, number];
+}>;
+//# sourceMappingURL=face.d.ts.map

package/dist/api/cadquery-selectors/face.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"face.d.ts","sourceRoot":"","sources":["../../../src/api/cadquery-selectors/face.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAuE7C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAsQjF"}