@mailwoman/core 3.0.0 → 4.1.0

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/tokenization/Graph.d.ts

@@ -3,7 +3,7 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  */
-import { Sequence } from "@mailwoman/core/resources";
+import { Sequence } from "../resources/set.js";
 export type GraphNodeCallback<G> = (node: G) => boolean;
 /**
  * A graph structure for storing relationships between nodes.

package/out/tokenization/Graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Graph.d.ts","sourceRoot":"","sources":["../../tokenization/Graph.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAEpD,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAA;AAEvD;;GAEG;AACH,qBAAa,KAAK,CAAC,SAAS,SAAS,OAAO;IAC3C;;OAEG;IACI,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAiB;IAEpD;;OAEG;IACI,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAiB;IAErD;;OAEG;IACH,SAAgB,gBAAgB,sBAA4B;IAC5D;;OAEG;IACH,SAAgB,YAAY,sBAA4B;IAExD;;OAEG;IACH,SAAgB,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,CAA4B;IAExE,IAAW,WAAW,IAAI,SAAS,GAAG,IAAI,CAEzC;IAED,IAAW,eAAe,IAAI,SAAS,GAAG,IAAI,CAE7C;CACD"}
+{"version":3,"file":"Graph.d.ts","sourceRoot":"","sources":["../../tokenization/Graph.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAE9C,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAA;AAEvD;;GAEG;AACH,qBAAa,KAAK,CAAC,SAAS,SAAS,OAAO;IAC3C;;OAEG;IACI,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAiB;IAEpD;;OAEG;IACI,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAiB;IAErD;;OAEG;IACH,SAAgB,gBAAgB,sBAA4B;IAC5D;;OAEG;IACH,SAAgB,YAAY,sBAA4B;IAExD;;OAEG;IACH,SAAgB,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,CAA4B;IAExE,IAAW,WAAW,IAAI,SAAS,GAAG,IAAI,CAEzC;IAED,IAAW,eAAe,IAAI,SAAS,GAAG,IAAI,CAE7C;CACD"}

package/out/tokenization/Graph.js

@@ -3,7 +3,11 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  */
-import { Sequence } from "@mailwoman/core/resources";
+// Import `Sequence` from its leaf module, NOT the `@mailwoman/core/resources` barrel: the barrel
+// re-exports the libpostal/WOF dictionaries (top-level `readdir` + fast-glob, Node-only), which would
+// drag the entire resource-loading layer into any browser bundle that touches tokenization — and
+// `@mailwoman/phrase-grouper` touches it via `Span`. `Sequence` itself is a pure `extends Set`.
+import { Sequence } from "../resources/set.js";
 /**
  * A graph structure for storing relationships between nodes.
  */

package/out/tokenization/Graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"Graph.js","sourceRoot":"","sources":["../../tokenization/Graph.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAIpD;;GAEG;AACH,MAAM,OAAO,KAAK;IACjB;;OAEG;IACI,OAAO,GAAwB,IAAI,QAAQ,EAAE,CAAA;IAEpD;;OAEG;IACI,QAAQ,GAAwB,IAAI,QAAQ,EAAE,CAAA;IAErD;;OAEG;IACa,gBAAgB,GAAG,IAAI,QAAQ,EAAa,CAAA;IAC5D;;OAEG;IACa,YAAY,GAAG,IAAI,QAAQ,EAAa,CAAA;IAExD;;OAEG;IACa,OAAO,GAAwB,IAAI,QAAQ,EAAa,CAAA;IAExE,IAAW,WAAW;QACrB,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAA;IAC/B,CAAC;IAED,IAAW,eAAe;QACzB,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAA;IACnC,CAAC;CACD"}
+{"version":3,"file":"Graph.js","sourceRoot":"","sources":["../../tokenization/Graph.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iGAAiG;AACjG,sGAAsG;AACtG,iGAAiG;AACjG,gGAAgG;AAChG,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAI9C;;GAEG;AACH,MAAM,OAAO,KAAK;IACjB;;OAEG;IACI,OAAO,GAAwB,IAAI,QAAQ,EAAE,CAAA;IAEpD;;OAEG;IACI,QAAQ,GAAwB,IAAI,QAAQ,EAAE,CAAA;IAErD;;OAEG;IACa,gBAAgB,GAAG,IAAI,QAAQ,EAAa,CAAA;IAC5D;;OAEG;IACa,YAAY,GAAG,IAAI,QAAQ,EAAa,CAAA;IAExD;;OAEG;IACa,OAAO,GAAwB,IAAI,QAAQ,EAAa,CAAA;IAExE,IAAW,WAAW;QACrB,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAA;IAC/B,CAAC;IAED,IAAW,eAAe;QACzB,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAA;IACnC,CAAC;CACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mailwoman/core",
-  "version": "3.0.0",
+  "version": "4.1.0",
   "description": "Mailwoman core: tokenization, classification primitives, solver, formatter, resources, filters, solvers, utils.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -49,8 +49,10 @@
     }
   },
   "dependencies": {
-    "axios": "^1.16.1",
+    "axios": "^1.17.0",
     "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",