@toolpath/tool-support 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -48,7 +48,7 @@ export { MM_PER_INCH, UNIT_ABBREVIATION, UNIT_SYSTEMS, convertArea, convertLengt
 export { PROVENANCE, type Provenance, type ProvenanceMap } from './provenance.js';
 export { GEOMETRY_FIELDS, convertGeometry, geometryField, isLengthField, type Geometry, type GeometryCode, type GeometryField, type GeometryUnit, } from './geometry.js';
 export { MILLING_FORMS, TOOL_FORMS, isToolForm, type ToolForm, type ToolFormEntry, } from './forms.js';
-export { hasNeck, shankOf, type Shank, type Tool } from './tool.js';
+export { THREAD_METHODS, hasNeck, isThreadMethod, shankOf, type Shank, type ThreadMethod, type Tool, } from './tool.js';
 export { PROFILES_VERSION, belowGageLine, type HolderProfile, type ProfileDatum, type ProfilePoint, } from './profile.js';
 export { canHold, colletFitsHolder, defaultStickout, gripRanges, gripsAnyShank, gripsShank, holdBand, holderTakesTool, isHolderProfile, maxStickout, stickoutLimits, type Assembly, type Clamping, type Collet, type GripRanges, type HoldBand, type Holder, } from './holding.js';
 export { DEFAULT_CLAMPING, clampShortfall, clampWanted, headLength, heldDiameter, type ClampingRule, } from './clamping.js';

package/dist/index.js

@@ -48,7 +48,7 @@ export { MM_PER_INCH, UNIT_ABBREVIATION, UNIT_SYSTEMS, convertArea, convertLengt
 export { PROVENANCE } from './provenance.js';
 export { GEOMETRY_FIELDS, convertGeometry, geometryField, isLengthField, } from './geometry.js';
 export { MILLING_FORMS, TOOL_FORMS, isToolForm, } from './forms.js';
-export { hasNeck, shankOf } from './tool.js';
+export { THREAD_METHODS, hasNeck, isThreadMethod, shankOf, } from './tool.js';
 export { PROFILES_VERSION, belowGageLine, } from './profile.js';
 export { canHold, colletFitsHolder, defaultStickout, gripRanges, gripsAnyShank, gripsShank, holdBand, holderTakesTool, isHolderProfile, maxStickout, stickoutLimits, } from './holding.js';
 export { DEFAULT_CLAMPING, clampShortfall, clampWanted, headLength, heldDiameter, } from './clamping.js';

package/dist/tool.d.ts

@@ -24,11 +24,49 @@
  */
 import type { Geometry } from './geometry.js';
 import type { ProvenanceMap } from './provenance.js';
+/**
+ * How a tap makes its thread: by cutting it away, or by displacing material
+ * into it.
+ *
+ * **A second axis beside {@link Tool.form}, not two more forms.**
+ * `forms.ts`'s vocabulary is Fusion's own, so that a tool exported there lands
+ * on the type it already has, and Fusion has no form-tap type — a form tap is a
+ * `tap right hand` there like any other. Adding `form tap right hand` would buy
+ * a filter chip and cost that guarantee. It is the same call
+ * `tool-scraper`'s `families/kennametal.ts` makes for keeping a holder's
+ * `contact` off its `taper`: two facts about one part are two fields.
+ *
+ * The two are genuinely different tools. A former needs a larger hole, evacuates
+ * no chip, and runs at its own feed; a cut tap does none of that. Nothing here
+ * branches on it yet — a tap goes in on the hole's axis either way, and
+ * `tool-drawing` has no publishable shape for either one's lead — but a
+ * consumer choosing or feeding a tool cannot ask the question at all until the
+ * fact is carried.
+ */
+export type ThreadMethod = 'cutting' | 'forming';
+/**
+ * The methods, in the order a control offers them.
+ *
+ * A list beside the union for the reason `PROVENANCE` is one: `tool-scraper`
+ * validates a family's declared value against it rather than redeclaring the
+ * two strings, and a filter panel offers it. Cutting leads because it is what
+ * most of a catalog is.
+ */
+export declare const THREAD_METHODS: readonly ["cutting", "forming"];
+export declare const isThreadMethod: (value: string) => value is ThreadMethod;
 export interface Tool {
     /** The CAM-library name for what the tool is: `flat end mill`, `drill`, `slot mill`. */
     readonly form: string;
     /** What a machinist calls this one tool — a catalog number, usually. */
     readonly label?: string;
+    /**
+     * How this tap makes its thread, where it is a tap and somebody has said.
+     *
+     * Optional, and **absent is nobody having said** rather than a claim of
+     * cutting — the rule `holding.ts`'s `Clamping` keeps on a holder and `shankOf` keeps
+     * on a shank. A non-tap carries none, because the question does not apply.
+     */
+    readonly threadMethod?: ThreadMethod;
     readonly geometry: Geometry;
     readonly provenance?: ProvenanceMap;
 }

package/dist/tool.js

@@ -28,6 +28,16 @@
  * 9.525 on the collet's sheet and 9.524999999999999 on the tool's.
  */
 const EPSILON = 1e-6;
+/**
+ * The methods, in the order a control offers them.
+ *
+ * A list beside the union for the reason `PROVENANCE` is one: `tool-scraper`
+ * validates a family's declared value against it rather than redeclaring the
+ * two strings, and a filter panel offers it. Cutting leads because it is what
+ * most of a catalog is.
+ */
+export const THREAD_METHODS = ['cutting', 'forming'];
+export const isThreadMethod = (value) => THREAD_METHODS.some((method) => method === value);
 /**
  * Whether the section between the flutes and the shank is a neck: a stated
  * shoulder past the flutes, narrower than the shank.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolpath/tool-support",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "The cutting-tool domain: what a tool, holder, collet and assembly are",
   "license": "MIT",
   "engines": {
@@ -35,14 +35,14 @@
     "README.md"
   ],
   "sideEffects": false,
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "check-types": "tsc --noEmit",
-    "test": "vitest run"
-  },
   "devDependencies": {
     "@types/node": "24.10.1",
     "typescript": "5.9.3",
     "vitest": "4.1.10"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run"
   }
-}
+}