@toolpath/tool-scraper 2.3.0 → 2.5.0

package/dist/vendors/kennametal/holding.js

@@ -30,7 +30,7 @@
  *   and dropped under `records.ToolRecord`'s standing rule: add a field when
  *   something displays it, not before.
  */
-import { CAD_COLUMN, COLLET_DESIGNATION_COLUMN, COLLET_SERIES_COLUMN } from '../../conventions.js';
+import { CAD_COLUMN, COLLET_DESIGNATION_COLUMN, COLLET_SERIES_COLUMN, dimensionalColumn, } from '../../conventions.js';
 import { familyBrand } from '../../family.js';
 import { checkUnitAgreement, clampingMode, colletRecord, contactMode, dim, holderRecord, holdingFact, published, } from '../../holding.js';
 import { consoleWarn } from '../../scrape.js';
@@ -44,7 +44,19 @@ import { CATALOG_NUMBER, MATERIAL_NUMBER } from './records.js';
  * report rather than a gate.
  */
 const HOLDER_LABELS = ['D1', 'L1', 'L2', 'L9', 'V', 'D2', 'D11'];
-const COLLET_LABELS = ['CCCN', 'CCCX', 'D1', 'BDX', 'LF', 'L'];
+const COLLET_LABELS = ['CCCN', 'CCCX', 'D1', 'BDX', 'LF', 'L', 'L9', 'S10'];
+/**
+ * The square drive a tap collet's bore carries, across flats.
+ *
+ * Kennametal's own label, and it is what tells a tap collet from a round one —
+ * see {@link colletCapacity}. Local to this adapter rather than in
+ * `conventions.ts` for the reason that module states: a column two vendors
+ * write is neutral, and this one is published by Kennametal's tap families and
+ * by nothing else in the catalog.
+ */
+const SQUARE_LABEL = 'S10';
+/** The vendor's own designation of the taps a tap collet is for. */
+const TAP_RANGE_LABEL = 'Tap Range';
 /** How a part names itself in a warning or a refusal. */
 function subject(row) {
     return `${row[CATALOG_NUMBER] ?? ''} (${row[MATERIAL_NUMBER] ?? ''})`;
@@ -85,6 +97,34 @@ function holder(row, family, options = {}) {
         cadDxfUrl: null,
     });
 }
+/**
+ * A collet's clamping capacity, from whichever pair of columns the family
+ * publishes.
+ *
+ * The ER collet families state `CCCN`/`CCCX` and that is what is read. **The
+ * tap families state neither**, and they are not incomplete rows: a square-drive
+ * collet holds one exact shank, and `D1` is it — `16ERTC025` publishes 6.477 mm,
+ * which is 0.255 in, the ANSI shank of a 1/4-20 tap. So the honest capacity is a
+ * zero-width band at `D1`, the same shape a sealed coolant-through collet
+ * already carries and `holding.checkCollet` already permits.
+ *
+ * Keyed on the vendor publishing a **square size** rather than on the family's
+ * `style` string: the square is Kennametal saying this part drives a tap, and a
+ * style is this package's config. A tap family that started publishing a real
+ * band would simply be read from it, which is the right answer either way.
+ */
+function colletCapacity(row, what, unit) {
+    const min = dim(row, 'CCCN', unit);
+    const max = dim(row, 'CCCX', unit);
+    if (min !== null || max !== null || dim(row, SQUARE_LABEL, unit) === null) {
+        return {
+            clampMin: published(min, what, 'CCCN clamping minimum'),
+            clampMax: published(max, what, 'CCCX clamping maximum'),
+        };
+    }
+    const exact = published(dim(row, 'D1', unit), what, 'D1 clamping diameter');
+    return { clampMin: exact, clampMax: exact };
+}
 /** One Kennametal or WIDIA collet row -> one {@link ColletRecord}. */
 function collet(row, family, options = {}) {
     const warn = options.warn ?? consoleWarn;
@@ -101,11 +141,17 @@ function collet(row, family, options = {}) {
         series: published(row[COLLET_DESIGNATION_COLUMN], what, 'collet series'),
         style: holdingFact(family, 'style', family.style),
         nominal: dim(row, 'D1', unit),
-        clampMin: published(dim(row, 'CCCN', unit), what, 'CCCN clamping minimum'),
-        clampMax: published(dim(row, 'CCCX', unit), what, 'CCCX clamping maximum'),
+        ...colletCapacity(row, what, unit),
         bodyDiameter: dim(row, 'BDX', unit),
         functionalLength: dim(row, 'LF', unit),
         overallLength: dim(row, 'L', unit),
+        clampingLength: dim(row, 'L9', unit),
+        // Verbatim, in the family's own unit, and never converted: it is two thread
+        // designations rather than a dimension. The metric families print it in the
+        // metric column and the ANSI ones in the inch column, and a row where the
+        // vendor filled neither says nothing rather than the wrong one.
+        tapRange: row[dimensionalColumn(TAP_RANGE_LABEL, unit)] || null,
+        squareSize: dim(row, SQUARE_LABEL, unit),
     });
 }
 /** The toolholding half of the adapter contract `registry` looks up by brand. */

package/dist/vendors/kennametal/index.d.ts

@@ -15,6 +15,7 @@
  * code here at all.
  */
 export * from './cad.js';
+export * from './catalog.js';
 export * from './family.js';
 export * from './holding.js';
 export * from './materials.js';

package/dist/vendors/kennametal/index.js

@@ -15,6 +15,7 @@
  * code here at all.
  */
 export * from './cad.js';
+export * from './catalog.js';
 export * from './family.js';
 export * from './holding.js';
 export * from './materials.js';

package/dist/vendors/kennametal/records.js

@@ -247,6 +247,7 @@ export function tapRecord(row, family, columns) {
         coating: row[COATING] ?? '',
         ...materialGroups(row),
         coolantThrough: fact(family, 'coolantThrough', family.coolantThrough),
+        threadMethod: fact(family, 'threadMethod', family.threadMethod),
         geometry: {
             DC: threadMajorDiameter(tdz, system),
             TP: require_(row, columns, 'TP', unit, what),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolpath/tool-scraper",
-  "version": "2.3.0",
+  "version": "2.5.0",
   "description": "Scrape cutting-tool geometry from vendor catalogs into records and CSVs",
   "license": "MIT",
   "engines": {
@@ -83,7 +83,7 @@
   ],
   "dependencies": {
     "htmlparser2": "12.0.0",
-    "@toolpath/tool-support": "^0.1.0"
+    "@toolpath/tool-support": "^0.3.0"
   },
   "devDependencies": {
     "@types/node": "24.10.1",