@finbheara/names 0.16.0 → 0.18.0

package/dist/cli/bin.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/tables.ts", "../src/cli/bin.ts"],
+  "sourcesContent": [
+    "/**\n * tables.ts — the package's data tables, printed for a consumer in any language.\n *\n *   names tables given-name [--output json] [--schema 1] > given-name-tables.json\n *\n * THE PRINTED FORM IS THE CONTRACT, not the files the tables are stored in. Each table has\n * numbered schemas; a schema, once released, prints the same shape for as long as the\n * package offers it, and a new shape is a new schema. `--schema` defaults to 1 and\n * `--output` to `json`, so a command written against the first release keeps working.\n * (`--schema`, not `--version`: the number is the output's shape, not the package's.)\n */\n\nimport { givenDiminutiveTable } from \"../normalize/given-diminutives.ts\";\nimport { givenFamilyTiers } from \"../normalize/given-families.ts\";\n\n/** table -> schema -> its printed value */\nconst TABLES: Record<string, Record<string, () => unknown>> = {\n\t\"given-name\": { \"1\": givenNameV1 },\n};\n\nconst OUTPUTS = [\"json\"];\n\n/**\n * `given-name` schema 1: the curated gate table and the extended family list, with the\n * rules a reader needs to answer as `givenFamilyTable` and `givenFamilyList` do.\n */\nfunction givenNameV1() {\n\tconst gate = givenDiminutiveTable();\n\treturn {\n\t\t$comment: [\n\t\t\t\"@finbheara/names given-name tables, schema 1. Every name is NN3: upper case, letters only.\",\n\t\t\t\"`variants`: canonical -> its other spellings. Read each name as its canonical spelling first;\",\n\t\t\t\"two names with one canonical are `given-variant`. `families` and `notAtGate` hold canonical\",\n\t\t\t\"spellings only.\",\n\t\t\t\"`families`: root -> its familiar forms, the curated gate tier. A root belongs to its own family.\",\n\t\t\t\"A form may sit under several roots and meets EVERY one of them; nothing is transitive, so two\",\n\t\t\t\"names relate only when they share a root. They are `given-family` when, for some shared root,\",\n\t\t\t\"neither name is a `notAtGate` form of it (a name that IS the root always passes), else\",\n\t\t\t\"`given-family-not-gate`, which an identity gate must refuse.\",\n\t\t\t\"`extended`: root -> form -> tier (1 common, 2 uncommon, 3 rare), the extended list. Two names\",\n\t\t\t\"relate when they share a root; the pair's tier is its rarer member's, the root counting as 1.\",\n\t\t\t\"Every pair here is `given-maybe`: a lead, never a gate. It is asked after `families`.\",\n\t\t\t\"Two equal names are none of these: equality is the caller's own test.\",\n\t\t],\n\t\ttable: \"given-name\",\n\t\tschema: 1,\n\t\tvariants: gate.variants,\n\t\tfamilies: gate.families,\n\t\tnotAtGate: gate.notAtGate,\n\t\textended: givenFamilyTiers(),\n\t};\n}\n\nconst USAGE = [\n\t\"usage: names tables <table> [--output json] [--schema N]\",\n\t`tables: ${Object.entries(TABLES)\n\t\t.map(([t, v]) => `${t} (schemas ${Object.keys(v).join(\", \")})`)\n\t\t.join(\"; \")}`,\n\t\"defaults: --output json --schema 1\",\n].join(\"\\n\");\n\n/** `names tables …`: prints one table to stdout. Returns the exit code. */\nexport function tables(argv: readonly string[]): number {\n\tconst options: Record<string, string> = { output: \"json\", schema: \"1\" };\n\tconst positional: string[] = [];\n\tfor (let i = 0; i < argv.length; i++) {\n\t\tconst a = argv[i]!;\n\t\tif (a === \"--help\" || a === \"-h\") {\n\t\t\tconsole.log(USAGE);\n\t\t\treturn 0;\n\t\t}\n\t\tconst m = /^--([a-z]+)(?:=(.*))?$/.exec(a);\n\t\tif (m === null) {\n\t\t\tpositional.push(a);\n\t\t\tcontinue;\n\t\t}\n\t\tconst [, key, inline] = m as unknown as [string, string, string | undefined];\n\t\tif (!(key in options)) return fail(`unknown option --${key}`);\n\t\tconst value = inline ?? argv[++i];\n\t\tif (value === undefined) return fail(`--${key} needs a value`);\n\t\toptions[key] = value;\n\t}\n\tif (positional.length !== 1) return fail(\"name one table\");\n\tconst schemas = TABLES[positional[0]!];\n\tif (schemas === undefined) return fail(`unknown table \"${positional[0]}\"`);\n\tconst print = schemas[options.schema!];\n\tif (print === undefined) return fail(`${positional[0]} has no schema ${options.schema}`);\n\tif (!OUTPUTS.includes(options.output!)) return fail(`unknown output \"${options.output}\"`);\n\tconsole.log(JSON.stringify(print(), null, \"\\t\"));\n\treturn 0;\n}\n\nfunction fail(message: string): number {\n\tconsole.error(`names tables: ${message}\\n${USAGE}`);\n\treturn 2;\n}\n",
+    "#!/usr/bin/env node\n/**\n * names — the package's command, run as `npx @finbheara/names …` or `bunx @finbheara/names …`.\n *\n *   names tables <table> [--output json] [--schema N]   print a data table\n *\n * Runs under Node or Bun. (`bun run names` in this repository is the lexicon curation CLI,\n * `./names.ts`, which is not shipped.)\n */\n\nimport { tables } from \"./tables.ts\";\n\nconst COMMANDS: Record<string, (argv: readonly string[]) => number> = { tables };\n\nconst USAGE = \"usage: names tables <table> [--output json] [--schema N]\";\n\nfunction main(argv: readonly string[]): number {\n\tconst [command, ...rest] = argv;\n\tif (command === \"--help\" || command === \"-h\") {\n\t\tconsole.log(USAGE);\n\t\treturn 0;\n\t}\n\tif (command === undefined) {\n\t\tconsole.error(USAGE);\n\t\treturn 2;\n\t}\n\tconst run = COMMANDS[command];\n\tif (run === undefined) {\n\t\tconsole.error(`names: unknown command \"${command}\"\\n${USAGE}`);\n\t\treturn 2;\n\t}\n\treturn run(rest);\n}\n\n// Run unconditionally: this module is only ever the entry (a `.bin` symlink makes an\n// `import.meta.url === argv[1]` test unreliable).\nprocess.exitCode = main(process.argv.slice(2));\n"
+  ],
+  "mappings": "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",
+  "debugId": "E2CE232D305113AE64756E2164756E21",
+  "names": []
+}

package/dist/cli/census.js

@@ -2,8 +2,8 @@
 import"../chunks/index-0wpvbdgh.js";
 import {
   createNameCensus2
-} from "../chunks/index-ye6j60jn.js";
-import"../chunks/index-tk01chxw.js";
+} from "../chunks/index-17zzg7f3.js";
+import"../chunks/index-gxw36cg3.js";
 import { createRequire } from "node:module";
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
@@ -20,7 +20,7 @@ async function main(argv) {
   const limit = Number(value("limit") ?? 25);
   const field = value("field") ?? "name";
   const orderField = value("order-field") ?? "order";
-  const classifier = flag("classify") ? (await import("../chunks/phrase-2hj26asc.js")).phraseClassifier() : undefined;
+  const classifier = flag("classify") ? (await import("../chunks/phrase-hze7av6y.js")).phraseClassifier() : undefined;
   const census = createNameCensus2(classifier === undefined ? {} : { classifier });
   for await (const line of createInterface({
     input: process.stdin,

package/dist/index.js

@@ -38,14 +38,11 @@ import {
   createSegmenter2,
   createClassifier2,
   phraseClassifier2
-} from "./chunks/index-ky754nsf.js";
+} from "./chunks/index-7j32khen.js";
 import"./chunks/index-jwx1mm4k.js";
 import {
   repairMojibake2,
-  sameGivenFamily2,
-  givenFamilyTable2,
-  createGivenFamilyList2,
-  givenFamilyList2,
+  middleFields2,
   comparePosition2,
   nameRelation2,
   MAX_READINGS2,
@@ -93,19 +90,25 @@ import {
   readNameCell2,
   DEFAULT_NAME_FORMAT_THRESHOLD2,
   deriveNameFormat2
-} from "./chunks/index-74fyytnh.js";
+} from "./chunks/index-xtwbdzy1.js";
 import"./chunks/index-qsznkk4s.js";
 import {
   composeEvalSet2,
   evaluateClassifier2
 } from "./chunks/index-a6f2y4aa.js";
-import"./chunks/index-tqdbxd92.js";
+import {
+  sameGivenFamily2,
+  givenFamilyTable2,
+  createGivenFamilyList2,
+  givenFamilyList2
+} from "./chunks/index-qmn87bdh.js";
+import"./chunks/index-18z8akw8.js";
 import {
   doubleMetaphone2
 } from "./chunks/index-ebebeamh.js";
 import {
   createNameCensus2
-} from "./chunks/index-ye6j60jn.js";
+} from "./chunks/index-17zzg7f3.js";
 import {
   NAME_REFUSED2,
   stripEveryAside2,
@@ -122,10 +125,15 @@ import {
   COMPOUND_SURNAMES2,
   isCompoundSurname2,
   spaceAfterComma2,
+  NAME_SUFFIXES2,
+  isNameSuffix2,
   inferNameOrder2,
   commaReading2,
+  lexiconNameOrder2,
+  tippedNameOrder2,
   resolveNameOrder2,
   splitPersonName2,
+  givenNameGroups2,
   classifyCell2,
   capitalise2,
   nameCase2,
@@ -150,7 +158,7 @@ import {
   defaultPersonNameFactory2,
   personName2,
   personNameFromIcao2
-} from "./chunks/index-tk01chxw.js";
+} from "./chunks/index-gxw36cg3.js";
 import {
   TEAM_WORD2,
   TEAM_DESIGNATION_WORDS2,
@@ -191,6 +199,7 @@ export {
   NAME_LEVEL_COLUMNS2 as NAME_LEVEL_COLUMNS,
   NAME_PLACEHOLDERS2 as NAME_PLACEHOLDERS,
   NAME_REFUSED2 as NAME_REFUSED,
+  NAME_SUFFIXES2 as NAME_SUFFIXES,
   NAME_TRADITIONS2 as NAME_TRADITIONS,
   ORDER_READINGS2 as ORDER_READINGS,
   PARTICLE_SECTION2 as PARTICLE_SECTION,
@@ -239,6 +248,7 @@ export {
   givenFamilyList2 as givenFamilyList,
   givenFamilyTable2 as givenFamilyTable,
   givenKeyAbbreviates2 as givenKeyAbbreviates,
+  givenNameGroups2 as givenNameGroups,
   infeasibleClass2 as infeasibleClass,
   inferNameOrder2 as inferNameOrder,
   initialsBlock2 as initialsBlock,
@@ -255,6 +265,7 @@ export {
   isMale2 as isMale,
   isMultiWord2 as isMultiWord,
   isNameParticle2 as isNameParticle,
+  isNameSuffix2 as isNameSuffix,
   isNeutral2 as isNeutral,
   isNoNamePrint2 as isNoNamePrint,
   isPerson2 as isPerson,
@@ -269,10 +280,12 @@ export {
   isTradename2 as isTradename,
   levelOf2 as levelOf,
   lexiconKey2 as lexiconKey,
+  lexiconNameOrder2 as lexiconNameOrder,
   lookupKey2 as lookupKey,
   meetReading2 as meetReading,
   meetReadings2 as meetReadings,
   metaphoneBlocks2 as metaphoneBlocks,
+  middleFields2 as middleFields,
   middleForm2 as middleForm,
   nameBlockKeys2 as nameBlockKeys,
   nameCase2 as nameCase,
@@ -319,6 +332,7 @@ export {
   surnameParts2 as surnameParts,
   teamLetter2 as teamLetter,
   teamRowDesignation2 as teamRowDesignation,
+  tippedNameOrder2 as tippedNameOrder,
   titleCaseNamePart2 as titleCaseNamePart,
   toAscii2 as toAscii,
   traditionFromIndex2 as traditionFromIndex,
@@ -326,5 +340,5 @@ export {
   traditionOf2 as traditionOf
 };
 
-//# debugId=C060D5DD49C57FA364756E2164756E21
+//# debugId=05E6D5B79CEDF96564756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "C060D5DD49C57FA364756E2164756E21",
+  "debugId": "05E6D5B79CEDF96564756E2164756E21",
   "names": []
 }

package/dist/measure/index.js

@@ -4,8 +4,8 @@ import {
 } from "../chunks/index-a6f2y4aa.js";
 import {
   createNameCensus2
-} from "../chunks/index-ye6j60jn.js";
-import"../chunks/index-tk01chxw.js";
+} from "../chunks/index-17zzg7f3.js";
+import"../chunks/index-gxw36cg3.js";
 import"../chunks/index-0wpvbdgh.js";
 export {
   composeEvalSet2 as composeEvalSet,

package/dist/normalize/index.js

@@ -1,9 +1,6 @@
 import {
   repairMojibake2,
-  sameGivenFamily2,
-  givenFamilyTable2,
-  createGivenFamilyList2,
-  givenFamilyList2,
+  middleFields2,
   comparePosition2,
   nameRelation2,
   MAX_READINGS2,
@@ -51,8 +48,14 @@ import {
   readNameCell2,
   DEFAULT_NAME_FORMAT_THRESHOLD2,
   deriveNameFormat2
-} from "../chunks/index-74fyytnh.js";
-import"../chunks/index-tqdbxd92.js";
+} from "../chunks/index-xtwbdzy1.js";
+import {
+  sameGivenFamily2,
+  givenFamilyTable2,
+  createGivenFamilyList2,
+  givenFamilyList2
+} from "../chunks/index-qmn87bdh.js";
+import"../chunks/index-18z8akw8.js";
 import {
   NAME_REFUSED2,
   stripEveryAside2,
@@ -69,10 +72,15 @@ import {
   COMPOUND_SURNAMES2,
   isCompoundSurname2,
   spaceAfterComma2,
+  NAME_SUFFIXES2,
+  isNameSuffix2,
   inferNameOrder2,
   commaReading2,
+  lexiconNameOrder2,
+  tippedNameOrder2,
   resolveNameOrder2,
   splitPersonName2,
+  givenNameGroups2,
   classifyCell2,
   capitalise2,
   nameCase2,
@@ -97,7 +105,7 @@ import {
   defaultPersonNameFactory2,
   personName2,
   personNameFromIcao2
-} from "../chunks/index-tk01chxw.js";
+} from "../chunks/index-gxw36cg3.js";
 import {
   TEAM_WORD2,
   TEAM_DESIGNATION_WORDS2,
@@ -124,6 +132,7 @@ export {
   NAME_LEVEL_COLUMNS2 as NAME_LEVEL_COLUMNS,
   NAME_PLACEHOLDERS2 as NAME_PLACEHOLDERS,
   NAME_REFUSED2 as NAME_REFUSED,
+  NAME_SUFFIXES2 as NAME_SUFFIXES,
   NAME_TRADITIONS2 as NAME_TRADITIONS,
   ORDER_READINGS2 as ORDER_READINGS,
   PLATFORM_PLACEHOLDERS2 as PLATFORM_PLACEHOLDERS,
@@ -158,6 +167,7 @@ export {
   givenFamilyList2 as givenFamilyList,
   givenFamilyTable2 as givenFamilyTable,
   givenKeyAbbreviates2 as givenKeyAbbreviates,
+  givenNameGroups2 as givenNameGroups,
   infeasibleClass2 as infeasibleClass,
   inferNameOrder2 as inferNameOrder,
   initialsBlock2 as initialsBlock,
@@ -165,14 +175,17 @@ export {
   isCompoundSurname2 as isCompoundSurname,
   isIcaoName2 as isIcaoName,
   isListJoiner2 as isListJoiner,
+  isNameSuffix2 as isNameSuffix,
   isNoNamePrint2 as isNoNamePrint,
   isPlaceholderPrint2 as isPlaceholderPrint,
   isTeamPrint2 as isTeamPrint,
   levelOf2 as levelOf,
   lexiconKey2 as lexiconKey,
+  lexiconNameOrder2 as lexiconNameOrder,
   meetReading2 as meetReading,
   meetReadings2 as meetReadings,
   metaphoneBlocks2 as metaphoneBlocks,
+  middleFields2 as middleFields,
   middleForm2 as middleForm,
   nameBlockKeys2 as nameBlockKeys,
   nameCase2 as nameCase,
@@ -213,10 +226,11 @@ export {
   surnameParts2 as surnameParts,
   teamLetter2 as teamLetter,
   teamRowDesignation2 as teamRowDesignation,
+  tippedNameOrder2 as tippedNameOrder,
   titleCaseNamePart2 as titleCaseNamePart,
   traditionFromIndex2 as traditionFromIndex,
   traditionLookupOf2 as traditionLookupOf
 };
 
-//# debugId=9549507E34EB444A64756E2164756E21
+//# debugId=2FD5851B5C07803564756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/normalize/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "9549507E34EB444A64756E2164756E21",
+  "debugId": "2FD5851B5C07803564756E2164756E21",
   "names": []
 }

package/dist/types/classifier/features.d.ts

@@ -6,9 +6,9 @@
  * `FEATURE_NAMES` stays in the weights file it was generated with; a weights
  * object is valid for this code only when its vectors are that long.
  */
-import { isPlacePhrase } from "../lexicon/place.ts";
+import { isCommaPlacePhrase, isPlacePhrase } from "../lexicon/place.ts";
 import { FEATURE_NAMES } from "./weights-v4.ts";
-export { FEATURE_NAMES, isPlacePhrase };
+export { FEATURE_NAMES, isCommaPlacePhrase, isPlacePhrase };
 /** The three phrase categories, as the weights and the exact-match short-circuit name them. */
 export interface CategoryScores {
     person: number;

package/dist/types/cli/bin.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * names — the package's command, run as `npx @finbheara/names …` or `bunx @finbheara/names …`.
+ *
+ *   names tables <table> [--output json] [--schema N]   print a data table
+ *
+ * Runs under Node or Bun. (`bun run names` in this repository is the lexicon curation CLI,
+ * `./names.ts`, which is not shipped.)
+ */
+export {};

package/dist/types/cli/tables.d.ts

@@ -0,0 +1,13 @@
+/**
+ * tables.ts — the package's data tables, printed for a consumer in any language.
+ *
+ *   names tables given-name [--output json] [--schema 1] > given-name-tables.json
+ *
+ * THE PRINTED FORM IS THE CONTRACT, not the files the tables are stored in. Each table has
+ * numbered schemas; a schema, once released, prints the same shape for as long as the
+ * package offers it, and a new shape is a new schema. `--schema` defaults to 1 and
+ * `--output` to `json`, so a command written against the first release keeps working.
+ * (`--schema`, not `--version`: the number is the output's shape, not the package's.)
+ */
+/** `names tables …`: prints one table to stdout. Returns the exit code. */
+export declare function tables(argv: readonly string[]): number;

package/dist/types/lexicon/place.d.ts

@@ -31,3 +31,19 @@ export declare function isPlaceWordFlags(flags: string): boolean;
  * phrase `location` without the regression, as it answers one word flagged G.
  */
 export declare function isPlacePhrase(phrase: string, getFlags: (name: string) => string | null): boolean;
+/**
+ * A place cut by a comma: two or more printed words, every one a place (`G`), at least one
+ * before the last ending its field with `,`, and every word after the last such comma a
+ * place and nothing else (`isPlaceWordFlags`). The words before the comma may also be a
+ * given name or a school's name: `Victoria, Australia` (`Victoria:FG`, `Australia:G`) and
+ * `Sydney, Australia` (`Sydney:FGT`) are ones; `Victoria Australia` (no comma) and
+ * `Australia, Victoria` (a given name after the comma) are not.
+ *
+ * The comma is the signal only where the document prints given names first. A person is
+ * printed `Surname, Given`, and under a surname-first or an undeclared order a given name
+ * that is also a place may follow the comma; a school is printed `School, State`
+ * (`Claddagh, Utah`) in surname-first documents. So the runtime answers this phrase
+ * `location` only for a document that declares `given-first`; `isPlacePhrase` answers
+ * under every order.
+ */
+export declare function isCommaPlacePhrase(phrase: string, getFlags: (name: string) => string | null): boolean;

package/dist/types/normalize/given-diminutives.d.ts

@@ -1,12 +1,12 @@
 /**
  * given-diminutives.ts — ONE GIVEN-NAME DIMINUTIVE TABLE, read by the TypeScript side.
  *
- * `./given-diminutives.json` is the table and this file is its reader. A Python linkage
- * lane reads the same JSON for its `givenRoot` comparison level, so the two languages
- * share one copy and no second one exists. An earlier adjudicator carried a `FAMILIAR`
- * map of eight entries and said *"the name primitives are where it belongs once a second
- * consumer wants one"*; the teachers-directory gate is that second consumer, and the eight
- * entries are in the table.
+ * `./given-diminutives.json` is the table and this file is its reader. A consumer in another
+ * language reads the table as `names tables given-name` prints it (`../cli/tables.ts`), never
+ * this file, so the file's layout may change and no second copy exists. An earlier
+ * adjudicator carried a `FAMILIAR` map of eight entries and said *"the name primitives are
+ * where it belongs once a second consumer wants one"*; the teachers-directory gate is that
+ * second consumer, and the eight entries are in the table.
  *
  * A RELATION OF A PAIR AND NEVER A KEY. Nothing here rewrites a given name: a stored key,
  * a filing key and every rendering keep the print's own spelling. A caller asks whether
@@ -32,6 +32,15 @@
  * `Eve` and `Eva` share none, though `Evie` meets both. A `notAtGate` form is refused AS A
  * FORM: where it is the root itself (`Caitlin` / `Cait`), its own forms meet it at a gate.
  */
+/**
+ * The table as this module reads it, for `names tables given-name`, which prints it. Not a
+ * package export: the printed form is the contract, and this file's layout may change.
+ */
+export declare function givenDiminutiveTable(): {
+    readonly variants: Readonly<Record<string, readonly string[]>>;
+    readonly families: Readonly<Record<string, readonly string[]>>;
+    readonly notAtGate: readonly string[];
+};
 /**
  * Do two DIFFERENT given names (NN3, letters only) stand for one another at a gate?
  *

package/dist/types/normalize/given-families.d.ts

@@ -44,5 +44,10 @@ export type GivenFamilyList = (a: string, b: string) => "given-maybe" | null;
  * The list is parsed on the first question, once per provider.
  */
 export declare function createGivenFamilyList(options?: GivenFamilyListOptions): GivenFamilyList;
+/**
+ * The shipped list as root -> form -> tier, roots and forms sorted, for `names tables
+ * given-name`, which prints it. Not a package export: the printed form is the contract.
+ */
+export declare function givenFamilyTiers(): Record<string, Record<string, GivenFamilyTier>>;
 /** The shipped list, every tier: the second given-name provider of `nameKinship`. */
 export declare const givenFamilyList: GivenFamilyList;

package/dist/types/normalize/index.d.ts

@@ -14,14 +14,14 @@ export { type CellVerdict, type NameRefusalRule, type Refusal, classifyCell, } f
 export { NAME_PLACEHOLDERS, type NamePlaceholder, PLATFORM_PLACEHOLDERS, isNoNamePrint, isPlaceholderPrint, placeholderOf, } from "./name-placeholder.ts";
 export { capitalise, nameCase, type SpellingLookup } from "./name-case.ts";
 export { type DisplayLexicon, GIVEN_SEPARATOR, type PersonNameParts, SURNAME_SEPARATOR, formatPersonDisplay, lexiconKey, parsePersonName, personDisplayName, spellingLookup, titleCaseNamePart, } from "./person-display.ts";
-export { type CommaReading, type NameOrder, type NameSplit, type ResolvedNameOrder, commaReading, inferNameOrder, resolveNameOrder, spaceAfterComma, splitPersonName, } from "./name-split.ts";
+export { type CommaReading, NAME_SUFFIXES, type NameOrder, type NameSplit, type ResolvedNameOrder, commaReading, givenNameGroups, inferNameOrder, isNameSuffix, lexiconNameOrder, resolveNameOrder, spaceAfterComma, splitPersonName, tippedNameOrder, } from "./name-split.ts";
 export { TEAM_DESIGNATION_WORDS, TEAM_WORD, type TeamSuffixPartition, canonicalTeamName, isCanonicalTeamName, isTeamPrint, partitionTeamSuffix, teamLetter, teamRowDesignation, } from "./team-name.ts";
 export { foldNameKey, nameFold } from "./name-fold.ts";
 export { COMPOUND_SURNAMES, isCompoundSurname } from "./compound-surnames.ts";
 export { givenFamilyTable, sameGivenFamily } from "./given-diminutives.ts";
 export { type GivenFamilyList, type GivenFamilyListOptions, type GivenFamilyTier, createGivenFamilyList, givenFamilyList, } from "./given-families.ts";
 export { type ClusterLinkage, type Clusters, type NameIndex, type NameIndexOptions, type NameMap, type NameMatch, type NameSet, createNameClusters, createNameIndex, createNameMap, createNameSet, nameCompare, probablySame, } from "./name-compare.ts";
-export { type NameReading, type NameRelation, type NameRelationReason, comparePosition, nameRelation, } from "./name-middle.ts";
+export { type NameReading, type NameRelation, type NameRelationReason, comparePosition, middleFields, nameRelation, } from "./name-middle.ts";
 export { type GivenProvider, type GivenVia, KINSHIP_VIAS, type KinshipReason, type KinshipVia, type MiddleVia, type MiddleViasAreNn5Reasons, type NameKinship, type NameKinshipOptions, type NameKinshipRelation, createNameKinship, nameKinship, } from "./name-kinship.ts";
 export * from "./name-compose.ts";
 export { INFEASIBLE_CLASSES, type InfeasibleClass, compoundGiven, editDistance, infeasibleClass, middleForm, nearSpelling, } from "./name-infeasible.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@finbheara/names",
-	"version": "0.16.0",
+	"version": "0.18.0",
 	"description": "A curated lexicon of personal, school and place names, the surname-particle vocabulary, a phrase classifier and a person-name normalizer",
 	"keywords": [
 		"names",
@@ -88,6 +88,7 @@
 		"typescript": "7.0.2"
 	},
 	"bin": {
+		"names": "./dist/cli/bin.js",
 		"names-census": "./dist/cli/census.js"
 	}
 }

package/dist/chunks/index-tqdbxd92.js

@@ -1,27 +0,0 @@
-import {
-  isGiven2,
-  isAmbiguous2,
-  isPlace2,
-  isTradename2
-} from "./index-0wpvbdgh.js";
-
-// src/lexicon/place.ts
-var JOINING_COMMA = /(?<=[^\s,]),(?=[^\s,])/g;
-function splitWords(s) {
-  return s.replace(JOINING_COMMA, (comma, at) => /\d/.test(s[at - 1]) && /\d/.test(s[at + 1]) ? comma : ", ").split(/\s+/).filter(Boolean);
-}
-var FIELD_END = /[,-]+$/;
-function isPlaceWordFlags(flags) {
-  return isPlace2(flags) && !isGiven2(flags) && !isAmbiguous2(flags) && !isTradename2(flags);
-}
-function isPlacePhrase(phrase, getFlags) {
-  const words = splitWords(phrase).map((w) => w.replace(FIELD_END, "")).filter((w) => w !== "");
-  if (words.length < 2)
-    return false;
-  return words.every((w) => isPlaceWordFlags(getFlags(w) ?? ""));
-}
-
-export { splitWords, FIELD_END, isPlaceWordFlags, isPlacePhrase };
-
-//# debugId=A9815F8EF12D8D4964756E2164756E21
-//# sourceMappingURL=index-tqdbxd92.js.map