@toolpath/tool-scraper 0.1.0

package/dist/families/regofix.d.ts

@@ -0,0 +1,185 @@
+/**
+ * REGO-FIX's families — toolholding only.
+ *
+ * There is no `FAMILIES` table here: REGO-FIX publishes no cutting tools, so this
+ * vendor never goes through a column map. What it publishes is powRgrip holders
+ * and the PG collets that press into them, and both are scraped from the
+ * ProductFinder's Elasticsearch index rather than from a family page — which is
+ * why there is no `familyCode` either. The scrape target is a set of index
+ * filters, and it lives with the scraper that posts them.
+ */
+export declare const HOLDER_FAMILIES: {
+    readonly 'regofix_bt30_pg_holders.csv': {
+        readonly catalogName: "REGO-FIX powRgrip BT30 Toolholders";
+        readonly rows: 21;
+        readonly brand: "regofix";
+        readonly facts: {
+            readonly taper: {
+                readonly value: "BT30";
+                readonly source: "vendor-stated";
+                readonly cite: "every row's DIN 4000 J1 property is DINISO7388-2 — the same 7/24 cone whether or not the flange face seats";
+            };
+            readonly clamping: {
+                readonly value: "collet";
+                readonly source: "vendor-stated";
+                readonly cite: "the holder publishes a CST collet series, so it grips through a collet";
+            };
+            readonly style: {
+                readonly value: "pg-collet-chuck";
+                readonly source: "vendor-stated";
+                readonly cite: "REGO-FIX's own system name, /products/system/powrgrip";
+            };
+            readonly unit: {
+                readonly value: "millimeters";
+                readonly source: "vendor-stated";
+                readonly cite: "the family is titled and catalogued in this system; both unit columns are usually published, so this decides which is displayed";
+            };
+        };
+    };
+};
+export declare const COLLET_FAMILIES: {
+    readonly 'regofix_pg_collets_standard.csv': {
+        readonly catalogName: "REGO-FIX powRgrip PG Standard Collets";
+        readonly rows: 71;
+        readonly brand: "regofix";
+        readonly facts: {
+            readonly style: {
+                readonly value: "pg-standard";
+                readonly source: "vendor-stated";
+                readonly cite: "the ProductFinder index groups these under product_group_name 'Standard'";
+            };
+        };
+    };
+    readonly 'regofix_pg_collets_coolant_flush.csv': {
+        readonly catalogName: "REGO-FIX powRgrip PG Coolant Flush Collets";
+        readonly rows: 51;
+        readonly brand: "regofix";
+        readonly facts: {
+            readonly style: {
+                readonly value: "pg-coolant-flush";
+                readonly source: "vendor-stated";
+                readonly cite: "the ProductFinder index groups these under product_group_name 'Coolant flush'";
+            };
+        };
+    };
+    readonly 'regofix_pg_collets_short.csv': {
+        readonly catalogName: "REGO-FIX powRgrip PG Short Collets";
+        readonly rows: 34;
+        readonly brand: "regofix";
+        readonly facts: {
+            readonly style: {
+                readonly value: "pg-short";
+                readonly source: "vendor-stated";
+                readonly cite: "the ProductFinder index groups these under product_group_name 'Short'";
+            };
+        };
+    };
+    readonly 'regofix_pg_collets_cool_bore.csv': {
+        readonly catalogName: "REGO-FIX powRgrip PG Cool Bore Collets";
+        readonly rows: 30;
+        readonly brand: "regofix";
+        readonly facts: {
+            readonly style: {
+                readonly value: "pg-cool-bore";
+                readonly source: "vendor-stated";
+                readonly cite: "the ProductFinder index groups these under product_group_name 'Cool bore'";
+            };
+        };
+    };
+    readonly 'regofix_pgst_collets.csv': {
+        readonly catalogName: "REGO-FIX powRgrip PGST Short Tail Collets";
+        readonly rows: 28;
+        readonly brand: "regofix";
+        readonly facts: {
+            readonly style: {
+                readonly value: "pgst-short-tail";
+                readonly source: "vendor-stated";
+                readonly cite: "the ProductFinder index groups these under product_group_name 'PGST'";
+            };
+        };
+    };
+    readonly 'regofix_pg_collets_tap.csv': {
+        readonly catalogName: "REGO-FIX powRgrip PG Tapping Collets";
+        readonly rows: 26;
+        readonly brand: "regofix";
+        readonly facts: {
+            readonly style: {
+                readonly value: "pg-tap";
+                readonly source: "vendor-stated";
+                readonly cite: "the ProductFinder index groups these under product_group_name 'Tapping collet TAP'";
+            };
+        };
+    };
+    readonly 'regofix_pg_collets_long.csv': {
+        readonly catalogName: "REGO-FIX powRgrip PG Long Collets";
+        readonly rows: 21;
+        readonly brand: "regofix";
+        readonly facts: {
+            readonly style: {
+                readonly value: "pg-long";
+                readonly source: "vendor-stated";
+                readonly cite: "the ProductFinder index groups these under product_group_name 'Long'";
+            };
+        };
+    };
+    readonly 'regofix_pg_collets_microbore.csv': {
+        readonly catalogName: "REGO-FIX powRgrip PG Microbore Collets";
+        readonly rows: 16;
+        readonly brand: "regofix";
+        readonly facts: {
+            readonly style: {
+                readonly value: "pg-microbore";
+                readonly source: "vendor-stated";
+                readonly cite: "the ProductFinder index groups these under product_group_name 'Microbore'";
+            };
+        };
+    };
+    readonly 'regofix_pg_collets_turning.csv': {
+        readonly catalogName: "REGO-FIX powRgrip PG Turning Collets";
+        readonly rows: 16;
+        readonly brand: "regofix";
+        readonly facts: {
+            readonly style: {
+                readonly value: "pg-turning";
+                readonly source: "vendor-stated";
+                readonly cite: "the ProductFinder index groups these under product_group_name 'PG-T'";
+            };
+        };
+    };
+    readonly 'regofix_pg_collets_mql.csv': {
+        readonly catalogName: "REGO-FIX powRgrip PG MQL Collets";
+        readonly rows: 11;
+        readonly brand: "regofix";
+        readonly facts: {
+            readonly style: {
+                readonly value: "pg-mql";
+                readonly source: "vendor-stated";
+                readonly cite: "the ProductFinder index groups these under product_group_name 'PG-MQL'";
+            };
+        };
+    };
+    readonly 'regofix_pg_collets_securgrip.csv': {
+        readonly catalogName: "REGO-FIX powRgrip PG secuRgrip Collets";
+        readonly rows: 10;
+        readonly brand: "regofix";
+        readonly facts: {
+            readonly style: {
+                readonly value: "pg-securgrip";
+                readonly source: "vendor-stated";
+                readonly cite: "the ProductFinder index groups these under product_group_name 'secuRgrip'";
+            };
+        };
+    };
+    readonly 'regofix_pg_collets_sealed_cap.csv': {
+        readonly catalogName: "REGO-FIX powRgrip PG Sealed Cap Collets";
+        readonly rows: 7;
+        readonly brand: "regofix";
+        readonly facts: {
+            readonly style: {
+                readonly value: "pg-sealed-cap";
+                readonly source: "vendor-stated";
+                readonly cite: "the ProductFinder index groups these under product_group_name 'PG-SC'";
+            };
+        };
+    };
+};

package/dist/families/regofix.js

@@ -0,0 +1,250 @@
+/**
+ * REGO-FIX's families — toolholding only.
+ *
+ * There is no `FAMILIES` table here: REGO-FIX publishes no cutting tools, so this
+ * vendor never goes through a column map. What it publishes is powRgrip holders
+ * and the PG collets that press into them, and both are scraped from the
+ * ProductFinder's Elasticsearch index rather than from a family page — which is
+ * why there is no `familyCode` either. The scrape target is a set of index
+ * filters, and it lives with the scraper that posts them.
+ */
+export const HOLDER_FAMILIES = {
+    // ── REGO-FIX powRgrip, BT 30 (JG 2026-08-07) ───────────────────────────
+    // The first non-Kennametal toolholding family, and the first one whose
+    // `contact` is **not** here. REGO-FIX publishes plain and dual-contact BT30
+    // in one product group — `BT 30 / PG 25 x 080 H` and `BT+ 30 / PG 25 x 080
+    // H` are two rows of one table — and states which is which in a `form_name`
+    // field. So the CSV carries a `contact` column, and the rule is that a
+    // scraped fact beats a family constant. There is deliberately no `contact`
+    // key below; supplying one would silently mask a scrape that lost the
+    // column.
+    //
+    // `clamping: 'collet'` and `style: 'pg-collet-chuck'`. A powRgrip holder
+    // takes a PG collet, which is pressed in with a hydraulic clamping unit
+    // rather than closed by a nut — so it grips through a collet exactly as an
+    // ER chuck does, and the picker asks it the same question. What differs is
+    // that seating one needs a PGU/PGS press on the bench, which is why it is
+    // its own `style` and not `er-collet-chuck` with a different series.
+    // REGO-FIX's own words for the line are "powRgrip" and "PG toolholders"
+    // (`/en/products/system/powrgrip`, `/en/products/components/toolholders/
+    // powRgrip`).
+    //
+    // **`taper: 'BT30'` covers BT+ 30 too**, the same call BTKV30 got and for
+    // the same reason: the vendor's own `J1` property is `DINISO7388-2` on
+    // every one of these rows, plus-form included, so the cone is identical and
+    // the plus is a face that also seats. Recording `BT+30` as a taper would
+    // hide ten holders from every BT30 filter.
+    //
+    // `rows` is 21 against 22 in the vendor's group: `4130.71506` (BT+ 30 / PG
+    // 15 x 075 H) has DXF and PDF drawings but no DIN 4000 document, so it has
+    // no published gage length and is skipped by the scraper with a message.
+    // The three `BT-OM 30` parts are excluded at a different level — see
+    // `vendors/regofix/scrape.ts`'s `SCRAPED_TAPERS` — because nothing on the
+    // vendor's site says what OM designates.
+    'regofix_bt30_pg_holders.csv': {
+        catalogName: 'REGO-FIX powRgrip BT30 Toolholders',
+        rows: 21,
+        brand: 'regofix',
+        facts: {
+            taper: {
+                value: 'BT30',
+                source: 'vendor-stated',
+                cite: "every row's DIN 4000 J1 property is DINISO7388-2 — the same 7/24 cone whether or not the flange face seats",
+            },
+            clamping: {
+                value: 'collet',
+                source: 'vendor-stated',
+                cite: 'the holder publishes a CST collet series, so it grips through a collet',
+            },
+            style: {
+                value: 'pg-collet-chuck',
+                source: 'vendor-stated',
+                cite: "REGO-FIX's own system name, /products/system/powrgrip",
+            },
+            unit: {
+                value: 'millimeters',
+                source: 'vendor-stated',
+                cite: 'the family is titled and catalogued in this system; both unit columns are usually published, so this decides which is displayed',
+            },
+        },
+    },
+};
+export const COLLET_FAMILIES = {
+    // ── REGO-FIX powRgrip PG collets (JG 2026-08-07) ───────────────────────
+    // Twelve product groups, restricted to the PG series a BT30 holder takes
+    // (6, 10, 15, 25). PG 32 and PG 48 collets exist and no BT30 holder in this
+    // catalog accepts one.
+    //
+    // **None of these declares a `unit`, and that is the change this package
+    // promised itself.** Every group holds metric and fractional-inch collets
+    // side by side — `PG 25 Ø 6.0 mm` and `PG 25 Ø 1/4"` are two rows of one
+    // group — so there is no family-level answer to declare. The unit is a
+    // column. Kennametal's TT HPV family is the one place a mixed family was
+    // handled by splitting the CSV, and the note there says a second one means
+    // making the unit per-record instead of splitting twice. This is that
+    // second one, twelve times over.
+    //
+    // **`style` is the vendor's own product group**, not a coinage: each value
+    // below is a slug of `product_group_name` in the ProductFinder index, and
+    // a consumer's label for it comes from the matching
+    // `product_category_name`. Both are re-checkable with one POST to the
+    // endpoint in `REGOFIX_PRODUCTFINDER_API.md` — no browser, no scraper
+    // change. They are config rather than a scraped column for the same reason
+    // Kennametal's are: constant per family, and this table is where per-family
+    // constants live.
+    //
+    // **PGST is a separate series, not a PG collet.** Its parts are designated
+    // `PGST 15`, REGO-FIX sells dedicated `.../PGST Short Tail` toolholders for
+    // them, and nothing published says whether a PGST collet also seats in a
+    // plain PG holder. `collet_row` therefore writes the series exactly as the
+    // vendor designates it, so a PGST collet matches no PG holder. That is the
+    // conservative direction on purpose: hiding a collet that would have fitted
+    // costs an option, while offering one that does not fit costs a machinist a
+    // purchase. Resolve it by asking REGO-FIX, not by widening the string.
+    // Today no BT30 short-tail holder exists either way, so all 28 sit in the
+    // catalog fitting nothing.
+    'regofix_pg_collets_standard.csv': {
+        catalogName: 'REGO-FIX powRgrip PG Standard Collets',
+        rows: 71,
+        brand: 'regofix',
+        facts: {
+            style: {
+                value: 'pg-standard',
+                source: 'vendor-stated',
+                cite: "the ProductFinder index groups these under product_group_name 'Standard'",
+            },
+        },
+    },
+    'regofix_pg_collets_coolant_flush.csv': {
+        catalogName: 'REGO-FIX powRgrip PG Coolant Flush Collets',
+        rows: 51,
+        brand: 'regofix',
+        facts: {
+            style: {
+                value: 'pg-coolant-flush',
+                source: 'vendor-stated',
+                cite: "the ProductFinder index groups these under product_group_name 'Coolant flush'",
+            },
+        },
+    },
+    'regofix_pg_collets_short.csv': {
+        catalogName: 'REGO-FIX powRgrip PG Short Collets',
+        rows: 34,
+        brand: 'regofix',
+        facts: {
+            style: {
+                value: 'pg-short',
+                source: 'vendor-stated',
+                cite: "the ProductFinder index groups these under product_group_name 'Short'",
+            },
+        },
+    },
+    'regofix_pg_collets_cool_bore.csv': {
+        catalogName: 'REGO-FIX powRgrip PG Cool Bore Collets',
+        rows: 30,
+        brand: 'regofix',
+        facts: {
+            style: {
+                value: 'pg-cool-bore',
+                source: 'vendor-stated',
+                cite: "the ProductFinder index groups these under product_group_name 'Cool bore'",
+            },
+        },
+    },
+    'regofix_pgst_collets.csv': {
+        catalogName: 'REGO-FIX powRgrip PGST Short Tail Collets',
+        rows: 28,
+        brand: 'regofix',
+        facts: {
+            style: {
+                value: 'pgst-short-tail',
+                source: 'vendor-stated',
+                cite: "the ProductFinder index groups these under product_group_name 'PGST'",
+            },
+        },
+    },
+    'regofix_pg_collets_tap.csv': {
+        catalogName: 'REGO-FIX powRgrip PG Tapping Collets',
+        rows: 26,
+        brand: 'regofix',
+        facts: {
+            style: {
+                value: 'pg-tap',
+                source: 'vendor-stated',
+                cite: "the ProductFinder index groups these under product_group_name 'Tapping collet TAP'",
+            },
+        },
+    },
+    'regofix_pg_collets_long.csv': {
+        catalogName: 'REGO-FIX powRgrip PG Long Collets',
+        rows: 21,
+        brand: 'regofix',
+        facts: {
+            style: {
+                value: 'pg-long',
+                source: 'vendor-stated',
+                cite: "the ProductFinder index groups these under product_group_name 'Long'",
+            },
+        },
+    },
+    'regofix_pg_collets_microbore.csv': {
+        catalogName: 'REGO-FIX powRgrip PG Microbore Collets',
+        rows: 16,
+        brand: 'regofix',
+        facts: {
+            style: {
+                value: 'pg-microbore',
+                source: 'vendor-stated',
+                cite: "the ProductFinder index groups these under product_group_name 'Microbore'",
+            },
+        },
+    },
+    'regofix_pg_collets_turning.csv': {
+        catalogName: 'REGO-FIX powRgrip PG Turning Collets',
+        rows: 16,
+        brand: 'regofix',
+        facts: {
+            style: {
+                value: 'pg-turning',
+                source: 'vendor-stated',
+                cite: "the ProductFinder index groups these under product_group_name 'PG-T'",
+            },
+        },
+    },
+    'regofix_pg_collets_mql.csv': {
+        catalogName: 'REGO-FIX powRgrip PG MQL Collets',
+        rows: 11,
+        brand: 'regofix',
+        facts: {
+            style: {
+                value: 'pg-mql',
+                source: 'vendor-stated',
+                cite: "the ProductFinder index groups these under product_group_name 'PG-MQL'",
+            },
+        },
+    },
+    'regofix_pg_collets_securgrip.csv': {
+        catalogName: 'REGO-FIX powRgrip PG secuRgrip Collets',
+        rows: 10,
+        brand: 'regofix',
+        facts: {
+            style: {
+                value: 'pg-securgrip',
+                source: 'vendor-stated',
+                cite: "the ProductFinder index groups these under product_group_name 'secuRgrip'",
+            },
+        },
+    },
+    'regofix_pg_collets_sealed_cap.csv': {
+        catalogName: 'REGO-FIX powRgrip PG Sealed Cap Collets',
+        rows: 7,
+        brand: 'regofix',
+        facts: {
+            style: {
+                value: 'pg-sealed-cap',
+                source: 'vendor-stated',
+                cite: "the ProductFinder index groups these under product_group_name 'PG-SC'",
+            },
+        },
+    },
+};

package/dist/family.d.ts

@@ -0,0 +1,130 @@
+/**
+ * What a family declares, and what it looks like once the registry has bound it.
+ *
+ * `families/` is the config table: what to fetch, how its columns are
+ * labelled, and the per-family constants no vendor table states. This module
+ * is the *shape* of one, kept apart from the tables themselves so that
+ * `families/` stays data and `registry` stays the only module that knows both
+ * halves.
+ *
+ * ## Facts are the only place a constant is authored
+ *
+ * A constant is authored as a {@link Fact} and nowhere else:
+ * {@link FamilyDefinition} declares `facts` and no constant keys, so setting
+ * one directly does not compile. The projection still happens —
+ * {@link BoundFamily} carries the values under their own names, and a mapper
+ * says `family.pointAngle` and never learns about provenance — but there is
+ * only ever one authored copy to drift from.
+ */
+import type { UnitSystem } from './conventions.js';
+import type { BrandName } from './identity.js';
+import type { Fact } from './provenance.js';
+import type { ColumnMap, ToolKind, ToolRecord } from './records.js';
+import type { MapperOptions, ScrapedRow } from './scrape.js';
+/**
+ * The per-family constants a fact can carry, and their types.
+ *
+ * Ten keys, which is the whole vocabulary the catalog uses. Naming them rather
+ * than accepting any string is what lets a mapper read `family.coolantThrough`
+ * as a `boolean` instead of casting an `unknown` out of a bag — and what makes
+ * a fact whose value is the wrong type a compile error where the family is
+ * written.
+ */
+export interface FamilyFacts {
+    /** Which unit system this family's dimensional columns are published in. */
+    unit?: UnitSystem;
+    /** Cutting-material code — `carbide`, `hss`, `diamond`. */
+    bmc?: string;
+    coolantThrough?: boolean;
+    flutes?: number;
+    /** Degrees included. */
+    pointAngle?: number;
+    nonFerrous?: boolean;
+    /** The holder or collet product style, as the vendor names it. */
+    style?: string;
+    /** `BT30`, `CAT40` — the spindle interface. */
+    taper?: string;
+    /** How the holder grips: `collet`, `hydraulic`, `shrink`. */
+    clamping?: string;
+    /** `taper` or `face` — whether the flange face seats as well as the cone. */
+    contact?: string;
+}
+/** A family's facts, each carrying the type its projected value will have. */
+export type FactSet = {
+    [K in keyof FamilyFacts]?: Fact<NonNullable<FamilyFacts[K]>>;
+};
+/** One CSV row -> one record. An adapter supplies these, keyed by tool kind. */
+export type RecordMapper = (row: ScrapedRow, family: BoundFamily, columns: ColumnMap, options?: MapperOptions) => ToolRecord;
+/** A vendor adapter's mappers, by the kind of tool they build. */
+export type RecordMappers = Partial<Record<ToolKind, RecordMapper>>;
+/** What every family declares, cutting tool or toolholding alike. */
+interface CommonDefinition {
+    /**
+     * How many rows a human counted in this CSV at scrape time.
+     *
+     * The one key here that no code needs. It is an independent restatement,
+     * which is the whole value: every other count is computed from the same file
+     * it is checking, so a scrape that silently lost rows agrees with itself. It
+     * is per family and not a total, because a total hides the case it exists to
+     * catch — one family gaining a row while another loses one sums to no change.
+     */
+    readonly rows: number;
+    /** Defaults to `kennametal` when a family does not name one. */
+    readonly brand?: BrandName;
+    readonly facts?: FactSet;
+}
+/**
+ * A cutting-tool family: something with a column map and a record mapper.
+ *
+ * `columns` holds the vendor's own column labels keyed by canonical ISO 13399
+ * name, *without* a unit suffix — `registry` runs each through
+ * `records.checkColumnMap`, so a typo fails when the registry binds, naming
+ * the family.
+ */
+export interface FamilyDefinition extends CommonDefinition {
+    /**
+     * The vendor-local half of the family id, kebab-cased.
+     *
+     * What lets a REGO-FIX family be called whatever REGO-FIX calls it without
+     * checking Kennametal's list first — see {@link familyId}.
+     */
+    readonly id: string;
+    readonly kind: ToolKind;
+    /**
+     * The vendor's own code for the family, where the scrape target is a family
+     * page. Absent where it is a set of index filters instead.
+     */
+    readonly familyCode?: string;
+    readonly columns: Readonly<Record<string, string>>;
+}
+/** A holder or collet family: no column map, no record mapper, no kind. */
+export interface ToolholdingDefinition extends CommonDefinition {
+    /** What a human calls this family. Holders and collets have no `id`. */
+    readonly catalogName: string;
+}
+/** A cutting-tool family after {@link FamilyDefinition} has been validated. */
+export type BoundFamily = Omit<FamilyDefinition, 'columns'> & FamilyFacts & {
+    /** The validated map. Only `checkColumnMap` can produce one. */
+    readonly columns: ColumnMap;
+    /** The adapter that turns this family's rows into records. */
+    readonly records: RecordMapper;
+};
+/** A toolholding family after its facts have been checked and projected. */
+export type BoundToolholding = ToolholdingDefinition & FamilyFacts;
+/**
+ * A family's id: `<brand>:<vendor-local id>`.
+ *
+ * Bare filename stems were the id in the source package until 2026-08-08 —
+ * `godrill_3xd_metric` — and they are a route parameter and a join key
+ * downstream. With one vendor there was no collision to fix; with four there
+ * is a latent one the moment two ship a family called `endmills_metric`, and
+ * it would land as a route that resolves to whichever library was read last.
+ *
+ * The **colon** is deliberate: it is a legal `pchar` in a URL path segment
+ * (RFC 3986), so `/family/kennametal:godrill-3xd-metric` needs no encoding and
+ * stays one route parameter.
+ */
+export declare function familyId(cfg: FamilyDefinition | BoundFamily): string;
+/** The brand that published a family, defaulting as the catalog does. */
+export declare function familyBrand(cfg: CommonDefinition | BoundFamily | BoundToolholding): BrandName;
+export {};

package/dist/family.js

@@ -0,0 +1,38 @@
+/**
+ * What a family declares, and what it looks like once the registry has bound it.
+ *
+ * `families/` is the config table: what to fetch, how its columns are
+ * labelled, and the per-family constants no vendor table states. This module
+ * is the *shape* of one, kept apart from the tables themselves so that
+ * `families/` stays data and `registry` stays the only module that knows both
+ * halves.
+ *
+ * ## Facts are the only place a constant is authored
+ *
+ * A constant is authored as a {@link Fact} and nowhere else:
+ * {@link FamilyDefinition} declares `facts` and no constant keys, so setting
+ * one directly does not compile. The projection still happens —
+ * {@link BoundFamily} carries the values under their own names, and a mapper
+ * says `family.pointAngle` and never learns about provenance — but there is
+ * only ever one authored copy to drift from.
+ */
+/**
+ * A family's id: `<brand>:<vendor-local id>`.
+ *
+ * Bare filename stems were the id in the source package until 2026-08-08 —
+ * `godrill_3xd_metric` — and they are a route parameter and a join key
+ * downstream. With one vendor there was no collision to fix; with four there
+ * is a latent one the moment two ship a family called `endmills_metric`, and
+ * it would land as a route that resolves to whichever library was read last.
+ *
+ * The **colon** is deliberate: it is a legal `pchar` in a URL path segment
+ * (RFC 3986), so `/family/kennametal:godrill-3xd-metric` needs no encoding and
+ * stays one route parameter.
+ */
+export function familyId(cfg) {
+    return `${cfg.brand ?? 'kennametal'}:${cfg.id}`;
+}
+/** The brand that published a family, defaulting as the catalog does. */
+export function familyBrand(cfg) {
+    return cfg.brand ?? 'kennametal';
+}