jupiter-dynamic-forms 1.20.8 → 1.20.9

package/dist/utils/role-resolver.d.ts

@@ -0,0 +1,39 @@
+import { FormSection } from '../schema/types';
+
+/**
+ * JDF-087: resolve a caller-supplied role hint (as passed to `scrollToConcept`'s `role`
+ * parameter) to the FormSection(s) it most plausibly refers to, best match first.
+ *
+ * Callers rarely pass the exact stored value: `FormSection.id`/`metadata.roleURI` are full
+ * URNs (`urn:kvk:linkrole:notes-consolidated-average-number-of-employees-segment-specification`)
+ * while host apps typically pass just the local name, or a human-readable label. KVK roles also
+ * come in prefix-sibling families (`...-employees`, `...-employees-breakdown`,
+ * `...-employees-segment-specification`), so loose matches are ranked by tightness rather than
+ * by iteration order — "first found wins" is exactly the bug this exists to eliminate.
+ */
+export declare const ROLE_MATCH_TIER: {
+    /** Full `id`/`roleURI` equals the query. */
+    readonly EXACT_ID: 1;
+    /** Local name (segment after the last `:`, `/` or `#`) of `id`/`roleURI` equals the query's. */
+    readonly EXACT_LOCAL_NAME: 2;
+    /** `title`/`description`/`metadata.originalRole` equals the query. */
+    readonly EXACT_LABEL: 3;
+    /** Contiguous substring match, in either direction, against a local name or label. */
+    readonly SUBSTRING: 4;
+    /** Every word of the query appears in a local name or label, in any order. */
+    readonly TOKEN_SUBSET: 5;
+};
+export type RoleMatchTier = typeof ROLE_MATCH_TIER[keyof typeof ROLE_MATCH_TIER];
+export interface RoleMatch {
+    section: FormSection;
+    tier: RoleMatchTier;
+}
+/** `urn:kvk:linkrole:notes-x` → `notes-x`; `http://example.com/role/notes-x` → `notes-x`. */
+export declare function roleLocalName(value: string): string;
+/**
+ * Rank every section the query plausibly refers to, best first: by tier, then (within a fuzzy
+ * tier) by tightness, then by the input order of `sections`. Returns `[]` for an empty query or
+ * when nothing matches.
+ */
+export declare function rankMatchingSections(roleQuery: string, sections: FormSection[]): RoleMatch[];
+//# sourceMappingURL=role-resolver.d.ts.map

package/dist/utils/role-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/role-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,eAAe;IAC1B,4CAA4C;;IAE5C,gGAAgG;;IAEhG,sEAAsE;;IAEtE,sFAAsF;;IAEtF,8EAA8E;;CAEtE,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEjF,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,aAAa,CAAC;CACrB;AAMD,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD;AA8CD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,CAS5F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jupiter-dynamic-forms",
-  "version": "1.20.8",
+  "version": "1.20.9",
   "description": "Framework-agnostic dynamic form builder for XBRL entrypoints using Web Components. Supports Angular 14+, React, Vue, and vanilla HTML.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",