@mailwoman/core 2.2.0 → 4.0.0

package/out/resources/whosonfirst/placetypes/admin.js

@@ -10,7 +10,7 @@ export function parsePlacetypeSource(key) {
     const [, languageCode, nameKind] = (langPattern.exec(key) ?? []);
     return { languageCode, nameKind };
 }
-export function pluckPlacetypeSpec({ "wof:id": id, "wof:name": name, "wof:src": wof_src, "src:geom": geom_src, "wof:parent_id": parent_id, "wof:placetype": placetype, "wof:superseded_by": superseded_by, ...props }) {
+export function pluckPlacetypeSpec({ "wof:id": id, "wof:name": name, "wof:src": wof_src, "src:geom": geom_src, "wof:parent_id": parent_id, "wof:placetype": placetype, "wof:superseded_by": superseded_by, "wof:supersedes": supersedes, "wof:country": country, "wof:concordances": concordances, "wof:population": wofPopulation, "wof:lastmodified": lastmodified, "geom:latitude": latitude, "geom:longitude": longitude, "gn:population": gnPopulation, "mz:is_current": mzIsCurrent, "edtf:deprecated": edtfDeprecated, "edtf:cessation": edtfCessation, ...props }) {
     const localizedPropMap = new Map();
     for (const [key, value] of Object.entries(props)) {
         if (!value)
@@ -33,6 +33,8 @@ export function pluckPlacetypeSpec({ "wof:id": id, "wof:name": name, "wof:src":
     const src = wof_src || geom_src || "unknown";
     if (!src)
         throw new Error(`No source found for placetype ${placetype} with ID ${id}`);
+    const population = typeof wofPopulation === "number" ? wofPopulation : typeof gnPopulation === "number" ? gnPopulation : undefined;
+    const isCurrent = mzIsCurrent === undefined ? undefined : mzIsCurrent !== 0 && mzIsCurrent !== "0";
     return {
         id,
         name,
@@ -40,6 +42,17 @@ export function pluckPlacetypeSpec({ "wof:id": id, "wof:name": name, "wof:src":
         parent_id,
         placetype,
         localizedPropMap,
+        country: country || undefined,
+        latitude: typeof latitude === "number" ? latitude : undefined,
+        longitude: typeof longitude === "number" ? longitude : undefined,
+        population,
+        concordances: concordances && Object.keys(concordances).length > 0 ? concordances : undefined,
+        isCurrent,
+        isDeprecated: !!edtfDeprecated,
+        isCeased: !!edtfCessation,
+        isSuperseded: !!(superseded_by && superseded_by.length > 0),
+        isSuperseding: !!(supersedes && supersedes.length > 0),
+        lastmodified: typeof lastmodified === "number" ? lastmodified : undefined,
     };
 }
 /**

package/out/resources/whosonfirst/placetypes/admin.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../../../resources/whosonfirst/placetypes/admin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,kBAAkB,EAElB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GACrB,MAAM,qCAAqC,CAAA;AAc5C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAU,CAAA;AAuB5F,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,2BAA2B,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAEpF,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC/C,MAAM,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,GAAa,CAAC,IAAI,EAAE,CAExE,CAAA;IAED,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAClC,QAAQ,EAAE,EAAE,EACZ,UAAU,EAAE,IAAI,EAChB,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,QAAQ,EACpB,eAAe,EAAE,SAAS,EAC1B,eAAe,EAAE,SAAS,EAC1B,mBAAmB,EAAE,aAAa,EAClC,GAAG,KAAK,EACO;IACf,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkD,CAAA;IAElF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,KAAK;YAAE,SAAQ;QACpB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAQ;QAEjD,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;QAE5D,IAAI,CAAC,YAAY,IAAI,CAAC,QAAQ;YAAE,SAAQ;QAExC,IAAI,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;QAEhD,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,GAAG,IAAI,GAAG,EAAE,CAAA;YACnB,gBAAgB,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAC5C,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QAE1D,IAAI,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;QAClC,CAAC;IACF,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,IAAI,QAAQ,IAAI,SAAS,CAAA;IAE5C,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,SAAS,YAAY,EAAE,EAAE,CAAC,CAAA;IAErF,OAAO;QACN,EAAE;QACF,IAAI;QACJ,GAAG;QACH,SAAS;QACT,SAAS;QACT,gBAAgB;KAChB,CAAA;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACzD,MAAM,CAAC,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,4BAA4B,CAAC,IAAI,EAAE,CAAA;IAE3E,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAA;IAE9B,IAAI,oBAAoB,CAAC,YAAY,CAAC;QAAE,OAAO,YAAY,CAAA;IAC3D,IAAI,qBAAqB,CAAC,YAAY,CAAC;QAAE,OAAO,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAA;IAEzF,OAAO,IAAI,CAAA;AACZ,CAAC"}
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../../../resources/whosonfirst/placetypes/admin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,kBAAkB,EAElB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GACrB,MAAM,qCAAqC,CAAA;AAyB5C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAU,CAAA;AAkC5F,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,2BAA2B,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAEpF,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC/C,MAAM,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,GAAa,CAAC,IAAI,EAAE,CAExE,CAAA;IAED,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAClC,QAAQ,EAAE,EAAE,EACZ,UAAU,EAAE,IAAI,EAChB,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,QAAQ,EACpB,eAAe,EAAE,SAAS,EAC1B,eAAe,EAAE,SAAS,EAC1B,mBAAmB,EAAE,aAAa,EAClC,gBAAgB,EAAE,UAAU,EAC5B,aAAa,EAAE,OAAO,EACtB,kBAAkB,EAAE,YAAY,EAChC,gBAAgB,EAAE,aAAa,EAC/B,kBAAkB,EAAE,YAAY,EAChC,eAAe,EAAE,QAAQ,EACzB,gBAAgB,EAAE,SAAS,EAC3B,eAAe,EAAE,YAAY,EAC7B,eAAe,EAAE,WAAW,EAC5B,iBAAiB,EAAE,cAAc,EACjC,gBAAgB,EAAE,aAAa,EAC/B,GAAG,KAAK,EACO;IACf,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkD,CAAA;IAElF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,KAAK;YAAE,SAAQ;QACpB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAQ;QAEjD,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;QAE5D,IAAI,CAAC,YAAY,IAAI,CAAC,QAAQ;YAAE,SAAQ;QAExC,IAAI,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;QAEhD,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,GAAG,IAAI,GAAG,EAAE,CAAA;YACnB,gBAAgB,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAC5C,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QAE1D,IAAI,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;QAClC,CAAC;IACF,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,IAAI,QAAQ,IAAI,SAAS,CAAA;IAE5C,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,SAAS,YAAY,EAAE,EAAE,CAAC,CAAA;IAErF,MAAM,UAAU,GACf,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAA;IAChH,MAAM,SAAS,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,IAAI,WAAW,KAAK,GAAG,CAAA;IAElG,OAAO;QACN,EAAE;QACF,IAAI;QACJ,GAAG;QACH,SAAS;QACT,SAAS;QACT,gBAAgB;QAChB,OAAO,EAAE,OAAO,IAAI,SAAS;QAC7B,QAAQ,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QAC7D,SAAS,EAAE,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QAChE,UAAU;QACV,YAAY,EAAE,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;QAC7F,SAAS;QACT,YAAY,EAAE,CAAC,CAAC,cAAc;QAC9B,QAAQ,EAAE,CAAC,CAAC,aAAa;QACzB,YAAY,EAAE,CAAC,CAAC,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3D,aAAa,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACtD,YAAY,EAAE,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;KACzE,CAAA;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACzD,MAAM,CAAC,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,4BAA4B,CAAC,IAAI,EAAE,CAAA;IAE3E,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAA;IAE9B,IAAI,oBAAoB,CAAC,YAAY,CAAC;QAAE,OAAO,YAAY,CAAA;IAC3D,IAAI,qBAAqB,CAAC,YAAY,CAAC;QAAE,OAAO,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAA;IAEzF,OAAO,IAAI,CAAA;AACZ,CAAC"}

package/out/resources/whosonfirst/placetypes/graph.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import type { PlacetypeRole } from "./definition.js";
+import { Placetype } from "./Placetype.js";
+/**
+ * A single node in a placetype graph. One entry per unique placetype name.
+ */
+export interface PlacetypeGraphNode {
+    name: string;
+    /** Brooklyn Integers ID. */
+    id: number;
+    role: PlacetypeRole;
+}
+/**
+ * A directed parent → child edge. Field names match d3-force / react-flow / cytoscape conventions
+ * so the graph drops straight into common viewers.
+ */
+export interface PlacetypeGraphLink {
+    source: string;
+    target: string;
+}
+/**
+ * Node-link projection of the placetype DAG rooted at a given placetype. Each node and each
+ * (parent, child) edge appears exactly once — see {@linkcode generatePlacetypeGraph} for why this is
+ * the preferred shape when the root has many shared descendants (e.g. `planet`).
+ */
+export interface PlacetypeGraph {
+    root: string;
+    nodes: PlacetypeGraphNode[];
+    links: PlacetypeGraphLink[];
+}
+/**
+ * Build a node-link graph of a placetype and its descendants, optionally filtered by role.
+ *
+ * Unlike {@linkcode generatePlacetypeTree}, this emits each node and each (parent, child) edge
+ * exactly once. WOF placetypes form a DAG with heavy descendant sharing (e.g. `installation` is a
+ * leaf reachable from many parents); projecting that DAG to a nested tree duplicates every shared
+ * subtree under every parent path and blows up exponentially for roots like `planet` (~165 MB for
+ * the full hierarchy). The graph shape stays O(nodes + edges) regardless.
+ *
+ * Output is well-suited for d3-force, react-flow, cytoscape, and any other HTML graph viewer.
+ */
+export declare function generatePlacetypeGraph(placetype: Placetype, roles?: Iterable<PlacetypeRole> | null): PlacetypeGraph;
+//# sourceMappingURL=graph.d.ts.map

package/out/resources/whosonfirst/placetypes/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../../resources/whosonfirst/placetypes/graph.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,aAAa,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,kBAAkB,EAAE,CAAA;IAC3B,KAAK,EAAE,kBAAkB,EAAE,CAAA;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,GAAG,cAAc,CAsCnH"}

package/out/resources/whosonfirst/placetypes/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../../resources/whosonfirst/placetypes/graph.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAgC1C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAoB,EAAE,KAAsC;IAClG,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAE7C,MAAM,KAAK,GAAG,IAAI,GAAG,EAA8B,CAAA;IACnD,MAAM,KAAK,GAAyB,EAAE,CAAA;IACtC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAA;IACnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAA;IAEhC,MAAM,OAAO,GAAG,CAAC,CAAY,EAAQ,EAAE;QACtC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,OAAM;QAC7B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IAC5D,CAAC,CAAA;IAED,MAAM,IAAI,GAAG,CAAC,IAAe,EAAQ,EAAE;QACtC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAErB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,KAAK,CAAC,CAAA;YAEd,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAA;YAC5C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7B,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;gBACtB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;YACtD,CAAC;YAED,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAQ;YACpC,IAAI,CAAC,KAAK,CAAC,CAAA;QACZ,CAAC;IACF,CAAC,CAAA;IAED,OAAO,CAAC,SAAS,CAAC,CAAA;IAClB,IAAI,CAAC,SAAS,CAAC,CAAA;IAEf,OAAO;QACN,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,KAAK;KACL,CAAA;AACF,CAAC"}

package/out/resources/whosonfirst/placetypes/index.d.ts

@@ -5,6 +5,8 @@
  */
 export * from "./admin.js";
 export * from "./definition.js";
+export * from "./graph.js";
 export * from "./mermaid.js";
 export * from "./Placetype.js";
+export * from "./tree.js";
 //# sourceMappingURL=index.d.ts.map

package/out/resources/whosonfirst/placetypes/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../resources/whosonfirst/placetypes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../resources/whosonfirst/placetypes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA"}

package/out/resources/whosonfirst/placetypes/index.js

@@ -5,6 +5,8 @@
  */
 export * from "./admin.js";
 export * from "./definition.js";
+export * from "./graph.js";
 export * from "./mermaid.js";
 export * from "./Placetype.js";
+export * from "./tree.js";
 //# sourceMappingURL=index.js.map

package/out/resources/whosonfirst/placetypes/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../resources/whosonfirst/placetypes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../resources/whosonfirst/placetypes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA"}

package/out/resources/whosonfirst/placetypes/mermaid.d.ts

@@ -3,18 +3,50 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  */
-import type { PlacetypeRole } from "./definition.js";
+import { type PlacetypeRole } from "./definition.js";
 import { Placetype } from "./Placetype.js";
 /**
- * Colors for placetype roles.
+ * Hand-tuned default colors for placetype roles. Used when no `interpolator` is passed to
+ * {@linkcode generateMermaidMarkup}. Each entry pairs a fill with a darker stroke and a text color
+ * chosen for contrast against the fill.
  */
 export declare const PlacetypeRoleColor: {
     readonly common: "#0066cc";
     readonly common_optional: "#00cc66";
     readonly optional: "#ffcc00";
 };
+/**
+ * A color interpolator — compatible with d3-scale-chromatic's `interpolate*` functions (e.g.
+ * `interpolateViridis`, `interpolateTurbo`). Receives `t ∈ [0, 1]` and returns a CSS color string.
+ */
+export type InterpolateColorCallback = (t: number) => string;
+export interface GenerateMermaidMarkupOptions {
+    /** Restrict descendants to the given roles. Default: all roles. */
+    roles?: Iterable<PlacetypeRole>;
+    /**
+     * Edge color interpolator. Each edge is colored by its child node's depth from the root: `t =
+     * (childDepth - 1) / (maxDepth - 1)`. This traces a smooth gradient along any lineage path (e.g.
+     * `planet → continent → country → …`) and gives a visual cue for how deep an edge sits in the
+     * tree.
+     *
+     * Defaults to d3-scale-chromatic's `interpolateViridis` — perceptually uniform and
+     * colorblind-friendly. Node fills/strokes are _not_ affected; they always use the hand-tuned
+     * {@linkcode PlacetypeRoleColor} palette, which carries more semantic weight than a sampled
+     * gradient for only three categorical role values.
+     */
+    edgeInterpolator?: InterpolateColorCallback;
+}
 /**
  * Generate a Mermaid flowchart markup for a placetype and its descendants.
+ *
+ * The walk is a recursive `findChildren` traversal — every emitted edge is a real direct-parent →
+ * direct-child relationship. WOF placetypes form a DAG (e.g. `borough` has both `country` and
+ * `macroregion` as parents), so a child can legitimately appear on multiple edges; the `visited`
+ * set prevents the subtree below it from being re-emitted.
+ *
+ * Edges are colored by depth from the root via
+ * {@linkcode GenerateMermaidMarkupOptions.edgeInterpolator} (default: viridis), so any lineage path
+ * traces a smooth gradient down the chart. Node fills always use the hand-tuned role palette.
  */
-export declare function generateMermaidMarkup(placetype: Placetype, roles?: Iterable<PlacetypeRole>): string;
+export declare function generateMermaidMarkup(placetype: Placetype, options?: GenerateMermaidMarkupOptions): string;
 //# sourceMappingURL=mermaid.d.ts.map

package/out/resources/whosonfirst/placetypes/mermaid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../../../resources/whosonfirst/placetypes/mermaid.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;CAImB,CAAA;AAElD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,CA8BnG"}
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../../../resources/whosonfirst/placetypes/mermaid.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,iBAAiB,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAa1C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;CAImB,CAAA;AAclD;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;AAE5D,MAAM,WAAW,4BAA4B;IAC5C,mEAAmE;IACnE,KAAK,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAA;IAC/B;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,wBAAwB,CAAA;CAC3C;AAuCD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,GAAE,4BAAiC,GAAG,MAAM,CA+C9G"}

package/out/resources/whosonfirst/placetypes/mermaid.js

@@ -3,19 +3,81 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  */
+import { rgb } from "d3-color";
+import { interpolateViridis } from "d3-scale-chromatic";
+import { PlacetypeRoles } from "./definition.js";
 import { Placetype } from "./Placetype.js";
 /**
- * Colors for placetype roles.
+ * Mermaid's `classDef` parser uses commas to separate style properties, so an `rgb(r, g, b)` value
+ * (which d3-scale-chromatic emits for several interpolators, e.g. `interpolateRainbow`,
+ * `interpolateTurbo`, `interpolateSinebow`) breaks the parse. Convert any d3-color-recognised input
+ * to hex before embedding. `d3-color` already handles hex/rgb/rgba/hsl/named inputs.
+ */
+function toMermaidColor(input) {
+    const parsed = rgb(input);
+    return Number.isNaN(parsed.r) ? input : parsed.formatHex();
+}
+/**
+ * Hand-tuned default colors for placetype roles. Used when no `interpolator` is passed to
+ * {@linkcode generateMermaidMarkup}. Each entry pairs a fill with a darker stroke and a text color
+ * chosen for contrast against the fill.
  */
 export const PlacetypeRoleColor = {
     common: "#0066cc",
     common_optional: "#00cc66",
     optional: "#ffcc00",
 };
+const PlacetypeRoleStroke = {
+    common: "#004d99",
+    common_optional: "#009933",
+    optional: "#cca300",
+};
+const PlacetypeRoleText = {
+    common: "white",
+    common_optional: "white",
+    optional: "black",
+};
+const HAND_TUNED_PALETTE = Object.fromEntries(PlacetypeRoles.map((role) => [
+    role,
+    { fill: PlacetypeRoleColor[role], stroke: PlacetypeRoleStroke[role], text: PlacetypeRoleText[role] },
+]));
+/**
+ * Walk the (filtered) subtree once to determine the deepest reachable descendant. Mirrors the
+ * structure of the emit-walk in {@linkcode generateMermaidMarkup} so the depths it computes line up
+ * with the edges that will be emitted. Cycles in the DAG are guarded by the `visited` set.
+ */
+function measureMaxDepth(root, roles) {
+    let maxDepth = 0;
+    const visited = new Set();
+    const walk = (node, depth) => {
+        for (const child of node.findChildren(roles)) {
+            const childDepth = depth + 1;
+            if (childDepth > maxDepth)
+                maxDepth = childDepth;
+            if (visited.has(child.name))
+                continue;
+            visited.add(child.name);
+            walk(child, childDepth);
+        }
+    };
+    walk(root, 0);
+    return maxDepth;
+}
 /**
  * Generate a Mermaid flowchart markup for a placetype and its descendants.
+ *
+ * The walk is a recursive `findChildren` traversal — every emitted edge is a real direct-parent →
+ * direct-child relationship. WOF placetypes form a DAG (e.g. `borough` has both `country` and
+ * `macroregion` as parents), so a child can legitimately appear on multiple edges; the `visited`
+ * set prevents the subtree below it from being re-emitted.
+ *
+ * Edges are colored by depth from the root via
+ * {@linkcode GenerateMermaidMarkupOptions.edgeInterpolator} (default: viridis), so any lineage path
+ * traces a smooth gradient down the chart. Node fills always use the hand-tuned role palette.
  */
-export function generateMermaidMarkup(placetype, roles) {
+export function generateMermaidMarkup(placetype, options = {}) {
+    const { roles, edgeInterpolator = interpolateViridis } = options;
+    const palette = HAND_TUNED_PALETTE;
     const lines = [
         "---",
         "config:",
@@ -24,21 +86,31 @@ export function generateMermaidMarkup(placetype, roles) {
         "---",
         "graph TD",
         "  linkStyle default stroke-width: 5",
-        `  classDef common fill:${PlacetypeRoleColor.common},stroke:#004d99,color:white,font-weight:bold`,
-        `  classDef common_optional fill:${PlacetypeRoleColor.common_optional},stroke:#009933,color:white,font-weight:bold`,
-        `  classDef optional fill:${PlacetypeRoleColor.optional},stroke:#cca300,color:black,font-weight:bold`,
+        ...PlacetypeRoles.map((role) => `  classDef ${role} fill:${palette[role].fill},stroke:${palette[role].stroke},color:${palette[role].text},font-weight:bold`),
+        // The root is never the target of an emitted edge, so declare it standalone so it picks
+        // up the role classDef and renders alongside the others.
+        `  ${placetype.name}:::${placetype.role}`,
     ];
-    const descendants = placetype.findDescendants(roles);
-    for (const [idx, descendant] of descendants.entries()) {
-        lines.push(`  ${placetype.name} --> ${descendant.name}:::${descendant.role}`);
-        lines.push(`  linkStyle ${idx} stroke:${PlacetypeRoleColor[descendant.role]}`);
-    }
-    for (const descendant of descendants) {
-        const children = descendant.findChildren(roles);
-        for (const child of children) {
-            lines.push(`  ${descendant.name} --> ${child.name}:::${child.role}`);
+    // Pre-compute max depth once so every edge's `t` is consistent across the second pass.
+    const maxDepth = measureMaxDepth(placetype, roles);
+    const visited = new Set();
+    let edgeIdx = 0;
+    const walk = (node, depth) => {
+        for (const child of node.findChildren(roles)) {
+            const childDepth = depth + 1;
+            // Single-level case: nothing to interpolate across, sample mid-gradient.
+            const t = maxDepth > 1 ? (childDepth - 1) / (maxDepth - 1) : 0.5;
+            const edgeColor = toMermaidColor(edgeInterpolator(t));
+            lines.push(`  ${node.name} --> ${child.name}:::${child.role}`);
+            lines.push(`  linkStyle ${edgeIdx} stroke:${edgeColor}`);
+            edgeIdx++;
+            if (visited.has(child.name))
+                continue;
+            visited.add(child.name);
+            walk(child, childDepth);
         }
-    }
+    };
+    walk(placetype, 0);
     return lines.join("\n");
 }
 //# sourceMappingURL=mermaid.js.map

package/out/resources/whosonfirst/placetypes/mermaid.js.map

@@ -1 +1 @@
-{"version":3,"file":"mermaid.js","sourceRoot":"","sources":["../../../../resources/whosonfirst/placetypes/mermaid.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IACjC,MAAM,EAAE,SAAS;IACjB,eAAe,EAAE,SAAS;IAC1B,QAAQ,EAAE,SAAS;CAC8B,CAAA;AAElD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAoB,EAAE,KAA+B;IAC1F,MAAM,KAAK,GAAa;QACvB,KAAK;QACL,SAAS;QACT,cAAc;QACd,0BAA0B;QAC1B,KAAK;QACL,UAAU;QACV,qCAAqC;QACrC,0BAA0B,kBAAkB,CAAC,MAAM,8CAA8C;QACjG,mCAAmC,kBAAkB,CAAC,eAAe,8CAA8C;QACnH,4BAA4B,kBAAkB,CAAC,QAAQ,8CAA8C;KACrG,CAAA;IAED,MAAM,WAAW,GAAG,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;IAEpD,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,IAAI,QAAQ,UAAU,CAAC,IAAI,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC,CAAA;QAC7E,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,WAAW,kBAAkB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC/E,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;QAE/C,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,IAAI,QAAQ,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QACrE,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC"}
+{"version":3,"file":"mermaid.js","sourceRoot":"","sources":["../../../../resources/whosonfirst/placetypes/mermaid.ts"],"names":[],"mappings":"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"}

package/out/resources/whosonfirst/placetypes/tree.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import type { PlacetypeRole } from "./definition.js";
+import { Placetype } from "./Placetype.js";
+/**
+ * A node in the nested placetype tree produced by {@linkcode generatePlacetypeTree}.
+ *
+ * WOF placetypes form a DAG (a placetype can have multiple parents — `borough`, for example, is a
+ * direct child of both `country` and `macroregion`), so a tree projection rooted at a single
+ * placetype can list the same descendant under multiple branches. That repetition is expected.
+ */
+export interface PlacetypeTreeNode {
+    name: string;
+    id: number;
+    role: PlacetypeRole;
+    children: PlacetypeTreeNode[];
+}
+/**
+ * Build a nested tree of a placetype and its descendants, optionally filtered by role.
+ *
+ * The traversal mirrors {@linkcode Placetype.findChildren} — direct children only at each level,
+ * recursively. The DAG-to-tree projection may repeat descendants under multiple parents; if you
+ * need each placetype to appear exactly once, use {@linkcode Placetype.findDescendants} for a flat
+ * de-duplicated set instead.
+ */
+export declare function generatePlacetypeTree(placetype: Placetype, roles?: Iterable<PlacetypeRole> | null): PlacetypeTreeNode;
+//# sourceMappingURL=tree.d.ts.map

package/out/resources/whosonfirst/placetypes/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../../resources/whosonfirst/placetypes/tree.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,aAAa,CAAA;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,GAAG,iBAAiB,CAIrH"}

package/out/resources/whosonfirst/placetypes/tree.js

@@ -0,0 +1,28 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import { Placetype } from "./Placetype.js";
+/**
+ * Build a nested tree of a placetype and its descendants, optionally filtered by role.
+ *
+ * The traversal mirrors {@linkcode Placetype.findChildren} — direct children only at each level,
+ * recursively. The DAG-to-tree projection may repeat descendants under multiple parents; if you
+ * need each placetype to appear exactly once, use {@linkcode Placetype.findDescendants} for a flat
+ * de-duplicated set instead.
+ */
+export function generatePlacetypeTree(placetype, roles) {
+    const roleSet = roles ? new Set(roles) : null;
+    return buildNode(placetype, roleSet);
+}
+function buildNode(placetype, roles) {
+    const children = placetype.findChildren(roles).map((child) => buildNode(child, roles));
+    return {
+        name: placetype.name,
+        id: placetype.id,
+        role: placetype.role,
+        children,
+    };
+}
+//# sourceMappingURL=tree.js.map

package/out/resources/whosonfirst/placetypes/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../../../resources/whosonfirst/placetypes/tree.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAgB1C;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAoB,EAAE,KAAsC;IACjG,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAE7C,OAAO,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;AACrC,CAAC;AAED,SAAS,SAAS,CAAC,SAAoB,EAAE,KAAgC;IACxE,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;IAEtF,OAAO;QACN,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,EAAE,EAAE,SAAS,CAAC,EAAE;QAChB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,QAAQ;KACR,CAAA;AACF,CAAC"}

package/out/solver/SolutionMatch.d.ts

@@ -32,7 +32,7 @@ export declare class SolutionMatch implements SerializedSolutionMatch {
     /**
      * The classification of the match.
      */
-    get classification(): "adjacent" | "alpha" | "alphanumeric" | "area" | "chain" | "country" | "dependency" | "directional" | "end_token_single_character" | "end_token" | "given_name" | "house_number" | "intersection" | "level_designator" | "level" | "locality" | "middle_initial" | "multistreet" | "numeric" | "ordinal" | "person" | "personal_suffix" | "personal_title" | "place" | "postcode" | "punctuation" | "region" | "road_type" | "start_token" | "stop_word" | "street_name" | "street_prefix" | "street_proper_name" | "street_suffix" | "street" | "surname" | "toponym" | "unit_designator" | "unit" | "unknown" | "venue";
+    get classification(): "country" | "region" | "locality" | "postcode" | "house_number" | "street" | "street_prefix" | "street_suffix" | "unit" | "venue" | "adjacent" | "alpha" | "alphanumeric" | "area" | "chain" | "dependency" | "directional" | "end_token_single_character" | "end_token" | "given_name" | "intersection" | "level_designator" | "level" | "middle_initial" | "multistreet" | "numeric" | "ordinal" | "person" | "personal_suffix" | "personal_title" | "place" | "punctuation" | "road_type" | "start_token" | "stop_word" | "street_name" | "street_proper_name" | "surname" | "toponym" | "unit_designator" | "unknown";
     /**
      * The confidence of the match, from 0 to 1.
      *

package/out/solver/mask.d.ts

@@ -9,7 +9,7 @@ type MaskCode = "V" | "N" | "S" | "P" | "L" | "U" | "A";
 /**
  * Mapping of classification labels to mask codes.
  */
-export declare const ClassificationMaskCodeMap: Map<"adjacent" | "alpha" | "alphanumeric" | "area" | "chain" | "country" | "dependency" | "directional" | "end_token_single_character" | "end_token" | "given_name" | "house_number" | "intersection" | "level_designator" | "level" | "locality" | "middle_initial" | "multistreet" | "numeric" | "ordinal" | "person" | "personal_suffix" | "personal_title" | "place" | "postcode" | "punctuation" | "region" | "road_type" | "start_token" | "stop_word" | "street_name" | "street_prefix" | "street_proper_name" | "street_suffix" | "street" | "surname" | "toponym" | "unit_designator" | "unit" | "unknown" | "venue" | "fallback", MaskCode>;
+export declare const ClassificationMaskCodeMap: Map<"country" | "region" | "locality" | "postcode" | "house_number" | "street" | "street_prefix" | "street_suffix" | "unit" | "venue" | "adjacent" | "alpha" | "alphanumeric" | "area" | "chain" | "dependency" | "directional" | "end_token_single_character" | "end_token" | "given_name" | "intersection" | "level_designator" | "level" | "middle_initial" | "multistreet" | "numeric" | "ordinal" | "person" | "personal_suffix" | "personal_title" | "place" | "punctuation" | "road_type" | "start_token" | "stop_word" | "street_name" | "street_proper_name" | "surname" | "toponym" | "unit_designator" | "unknown" | "fallback", MaskCode>;
 /**
  * Mask which shows the areas covered by different types of classification
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mailwoman/core",
-  "version": "2.2.0",
+  "version": "4.0.0",
   "description": "Mailwoman core: tokenization, classification primitives, solver, formatter, resources, filters, solvers, utils.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -51,6 +51,8 @@
   "dependencies": {
     "axios": "^1.16.1",
     "axios-cache-interceptor": "^1.12.0",
+    "d3-color": "^3.1.0",
+    "d3-scale-chromatic": "^3.1.0",
     "http-status-codes": "^2.3.0",
     "json-colorizer": "^3.0.1",
     "kysely": "^0.29.2",
@@ -58,6 +60,10 @@
     "pino-pretty": "^13.1.3",
     "table": "^6.9.0"
   },
+  "devDependencies": {
+    "@types/d3-color": "^3.1.3",
+    "@types/d3-scale-chromatic": "^3.1.0"
+  },
   "files": [
     "out/**/*.js",
     "out/**/*.js.map",