@bicharts/shape-core 0.5.46 → 0.5.48

package/dist/index.mjs

@@ -1,2 +1,2 @@
 /*! @bicharts/shape-core — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; US Census/TIGER (public domain). Full text: NOTICE in this package. */
-import{a as Ht,b as Vt}from"./chunk-5233JUKA.mjs";import{a as Pt,b as It,c as Rt,d as Nt,e as zt,f as Gt,g as Ft,h as $t,i as Dt,j as Kt,k as Bt}from"./chunk-LDC2C4WC.mjs";import{a as Ot}from"./chunk-QEH7WTLB.mjs";import{a as Et,b as wt}from"./chunk-2LR73DNS.mjs";import{a as kt,b as Mt,c as Lt}from"./chunk-NWDPA7DG.mjs";import{a as q,b as j,c as bt,d as Tt,e as _t,f as St}from"./chunk-SAASSIJ7.mjs";import{a as b,f as T,g as y,h as _,i as w,j as ft,k as gt,l as Z,m as g,n as pt,o as mt,p as yt,q as S,r as At,s as ht,t as vt,u as xt,v as k,w as Ct}from"./chunk-E6SVTFAW.mjs";import"./chunk-5MRZID36.mjs";import{a as lt,b as ct,c as dt}from"./chunk-WBEROMBG.mjs";var W=["rate","ratio","pct","percent","percentage","rating","share","score","index","nps","csat","margin","yield","coverage","utilization","z[_-]?score","average","avg","mean","median","stddev","variance","gpa","percentile","quantile","efficiency","accuracy","probability","multiplier","coefficient","correlation","occupancy","age","bmi","temperature","density","pressure","humidity","ph","velocity","speed","elevation","altitude","latency","throughput","bandwidth","iops"],X=["pct","percent","percentage","rate","ratio","rating","share","score","index","nps","csat","margin","yield","coverage","utilization","gpa","percentile","quantile","bmi","density","pressure","humidity","velocity","efficiency","occupancy","latency","throughput","bandwidth","iops"],Y=["latitude","longitude"],J=["latitude","longitude"],Q=/^\s*(sum|count|count\s+distinct|distinct\s+count)\s+of\s+/i,Ut=/(?<=[a-z0-9])(?=[A-Z])|(?<=[A-Za-z])(?=[0-9])|(?<=[0-9])(?=[A-Za-z])/g,Zt=new RegExp("\\b("+W.join("|")+")\\b|("+X.join("|")+")$","i"),qt=new RegExp("\\b("+Y.join("|")+")\\b|("+J.join("|")+")$","i");function M(e){return e?String(e).replace(Q,"").trim():""}function tt(e){return!!e&&Q.test(String(e))}function jt(e){let t=M(e);return t.length===0?"":t.replace(Ut," ")}function et(e,t){return t?e.test(jt(t))||e.test(M(t)):!1}function L(e){return et(qt,e)}function nt(e){return et(Zt,e)||L(e)}var it=/int|double|decimal|single|float|number|currency|money/i;function Wt(e){let t=String(e?.valueNature??"").trim().toLowerCase();return t==="categorical"?"Categorical":t==="ordinal"?"Ordinal":t==="continuous"||e?.isMeasure===!0||it.test(String(e?.dataType??""))?"Continuous":"Categorical"}function Xt(e){return e?.isMeasure===!0||it.test(String(e?.dataType??""))}function z(e){let t=e??{},i=Wt(t);if(i!=="Continuous")return{nature:i,additivity:"unknown",basis:"role",suppressed:!1};if(L(t.name))return{nature:i,additivity:"positional",basis:"name",suppressed:!0};let r=String(t.additivity??"").trim().toLowerCase();if(!(r==="additive"&&tt(t.name))){if(r==="additive")return{nature:i,additivity:"additive",basis:"measured",suppressed:!1};if(r==="part_of_whole")return{nature:i,additivity:"part_of_whole",basis:"measured",suppressed:!1};if(r==="intensive_rate")return{nature:i,additivity:"intensive_rate",basis:"measured",suppressed:!1}}return t.discourageAggregationAcrossGroups===!0?{nature:i,additivity:"intensive_rate",basis:"host-flag",suppressed:!1}:nt(t.name)?{nature:i,additivity:"intensive_rate",basis:"name",suppressed:!1}:{nature:i,additivity:"additive",basis:"default",suppressed:!1}}function G(e){let t=z(e),i=e??{};if(t.nature==="Categorical")return["first","distinctcount","count"];if(t.nature==="Ordinal")return Xt(i)?["median","min","max","first","distinctcount","count"]:["first","distinctcount","count"];switch(t.additivity){case"positional":return["min","max","count","distinctcount","first"];case"intensive_rate":return["average","median","min","max","count","distinctcount","first"];default:return["sum","average","median","min","max","count","distinctcount","first"]}}function Yt(e){return G(e)[0]}function Jt(e,t){return G(e).indexOf(t)>=0}function Qt(e,t){if(t!=="sum"&&t!=="count")return!1;if(t==="count")return!0;let i=z(e);return i.additivity==="additive"||i.additivity==="part_of_whole"||i.additivity==="unknown"}var F=2,st=400;function D(e){return!!T(e)}function v(e){let t=new Set;for(let i of e){if(i==null)continue;let r=b(String(i));if(!_(r)&&!t.has(r)&&(t.add(r),t.size>=st))break}return Array.from(t)}function h(e){let t=v(e);if(t.length===0||K(e)<95)return!1;let i=t.filter(u=>D(u)&&!g(u)).length,r=t.filter(u=>!D(u)&&!!g(u)).length;return i>=1&&i>=r}function ot(e,t){if(!g(e))return!1;let i=T(e);return i?t==="world"?!0:Z.has(i):!1}function K(e){let t=v(e);if(t.length===0)return 0;let i=0;for(let r of t)D(r)&&i++;return Math.round(i/t.length*1e3)/10}function P(e){let t=v(e);if(t.length===0)return 0;let i=0;for(let r of t)g(r)&&i++;return Math.round(i/t.length*1e3)/10}function H(e){let t=new Set;for(let i of e){if(i==null)continue;let r=String(i).trim();if(!_(b(r))&&!t.has(r)&&(t.add(r),t.size>=st))break}return Array.from(t)}function B(e){let t=H(e);if(t.length===0)return 0;let i=0;for(let r of t)S(r).length>0&&i++;return Math.round(i/t.length*1e3)/10}function rt(e,t){return j(t,q)?!0:H(e).some(i=>/^\d{5}(-\d{4})?$/.test(i.replace(/\.0+$/,"")))}function te(e,t){let i=v(e);if(i.length===0)return 0;let r=0;for(let u of i)k(u,t)&&r++;return Math.round(r/i.length*1e3)/10}function $(e,t){let i=0;for(let r of v(e))t(r)&&i++;return i}function ee(e,t){let i=0;for(let r of H(e))t(r)&&i++;return i}function ne(e,t,i,r){let u=[],c=[],o={},I={},R=new Set(e),l=n=>t.map(s=>s[n]);for(let n of["city","lat","lon","country"]){let s=i?.[n];s&&R.has(s)&&(o[n]=s)}let p=i?.zip;if(p&&R.has(p)){let n=l(p),s=B(n);s<95?c.push(`zip=${p} (only ${s}% of values read as ZIPs)`):rt(n,p)?o.zip=p:c.push(`zip=${p} (all values are 3-4 digits with nothing to say they are postal)`)}let f=i?.state;if(f&&R.has(f)){let n=l(f),s=v(n);s.length>0&&s.every(a=>ot(a,r))?c.push(`state=${f} (every value is "CA", which is both Canada and California)`):h(n)?(c.push(`state=${f} (every value is a country, not a state)`),o.country||(o.country=f)):P(n)<95?c.push(`state=${f} (only ${P(n)}% of values are states/provinces)`):o.state=f}let m=new Set(Object.values(o).filter(Boolean)),x=e.filter(n=>!m.has(n)&&!n.startsWith("__"));if(!o.state){let n=null;for(let s of x){let a=l(s);if(h(a))continue;let d=P(a);if(d<95)continue;let E=$(a,C=>!!g(C)),ut=$(a,C=>!!g(C)&&!ot(C,r));E<F&&ut<1||(!n||d>n.pct)&&(n={name:s,pct:d})}n&&(o.state=n.name,m.add(n.name),u.push(`state=${n.name} (${n.pct}% states/provinces)`))}if(!o.zip)for(let n of x){if(m.has(n))continue;let s=l(n),a=B(s);if(!(a<95)&&rt(s,n)&&!(ee(s,d=>S(d).length>0)<F)){o.zip=n,m.add(n),u.push(`zip=${n} (${a}% ZIP codes)`);break}}let A=o.country;if(!A||!h(l(A))){let n=null;for(let s of x){if(m.has(s)||!h(l(s)))continue;let a=K(l(s));(!n||a>n.pct)&&(n={name:s,pct:a})}n&&(A&&(c.push(`country=${A} (only ${K(l(A))}% of values are country identifiers; using ${n.name} instead)`),I.country=A),o.country=n.name,m.add(n.name),u.push(`country=${n.name}`))}if(!o.city){let n=null;for(let s of x){if(m.has(s))continue;let a=l(s),d=te(a,r);d<w||$(a,E=>k(E,r))<F||(!n||d>n.pct)&&(n={name:s,pct:d})}n&&(o.city=n.name,u.push(`city=${n.name} (${n.pct}% known cities)`))}let V=o.country?l(o.country):[],N=!!o.country&&h(V),at=N?new Set(V.map(n=>T(n==null?null:String(n))).filter(Boolean)).size:0,U=N&&at>=2,O=!!(o.lat&&o.lon)&&t.some(n=>{let s=+String(n[o.lat]??"").trim(),a=+String(n[o.lon]??"").trim();return isFinite(s)&&isFinite(a)&&s>=-90&&s<=90&&a>=-180&&a<=180&&String(n[o.lat]??"").trim()!==""&&String(n[o.lon]??"").trim()!==""});return o.lat&&o.lon&&!O&&c.push(`lat/lon=${o.lat}/${o.lon} (no row holds a usable coordinate pair)`),o.country&&!U&&!(o.city||o.state||o.zip||O)&&c.push(N?`country=${o.country} (every row resolves to the same country - nothing to place apart)`:`country=${o.country} (values are not country identifiers)`),{bind:!!(o.city||o.state||o.zip||U||O)?o:null,backfilled:u,refused:c,...Object.keys(I).length?{labelFallback:I}:{}}}export{w as CITY_ROLE_MATCH_PCT,Lt as GET_RANDOM,X as INTENSIVE_SUFFIX_TOKENS,W as INTENSIVE_WORD_TOKENS,Bt as IndexedText,J as POSITIONAL_SUFFIX_TOKENS,Y as POSITIONAL_WORD_TOKENS,y as ROLE_MATCH_PCT,Mt as SIMPLE_STRING_HASH,kt as STR,P as admin1MatchPct,G as allowedAggregations,St as buildGeoIsoColumn,vt as buildGeoPointColumns,Ct as cityMatchPct,xt as cityTagsFor,Dt as classifyAdditivity,z as classifyForAggregation,Kt as classifyNumericValueNature,Ft as classifyTemporal,Rt as countryRegion,Yt as defaultAggregation,Ot as detectFormatSignature,bt as detectGeo,dt as detectOrdinalDomain,Gt as detectTextDatePattern,Ht as engineTypeForSqlType,tt as hasDefaultAggPrefix,$t as hostAggHint,Vt as ingest,Jt as isAggregationAllowed,_ as isBlankLike,gt as isCityTableLoaded,At as isGeoPointAmbiguity,zt as isIdentifierName,_t as isJoinGeoKind,lt as isOrdinalFriendlyName,h as looksLikeCountryColumn,wt as monthLookupFor,nt as nameLooksIntensiveRate,L as nameLooksPositional,pt as normalizeCountry,Et as normalizeMonthKey,b as normalizePlaceName,yt as normalizeZip5,ft as registerCityTable,It as registerIso3Regions,g as resolveAdmin1,ht as resolveGeoPoint,ne as resolvePointRoles,ct as safeDistinctValuesToShip,Qt as shareOfTotalIsHonest,M as stripHostAggPrefix,Nt as summarizeCountryRegions,Pt as summarizeGeoExtent,Tt as toGeoIso,B as zipMatchPct,S as zipPrefixCandidates,mt as zipToPrefix3};
+import{a as Ut,b as Zt}from"./chunk-5233JUKA.mjs";import{a as Rt,b as Nt,c as Ot,d as wt,e as Ft,f as $t,g as Dt,h as Kt,i as Bt,j as Ht,k as Vt}from"./chunk-LDC2C4WC.mjs";import{a as Et}from"./chunk-QEH7WTLB.mjs";import{a as kt,b as Mt}from"./chunk-2LR73DNS.mjs";import{a as Lt,b as zt,c as Gt}from"./chunk-NWDPA7DG.mjs";import{a as j,b as W,c as Tt,d as _t,e as Pt,f as It}from"./chunk-SAASSIJ7.mjs";import{a as S,f as T,g as y,h as _,i as k,j as pt,k as mt,l as q,m as g,n as yt,o as At,p as ht,q as P,r as vt,s as xt,t as Ct,u as bt,v as M,w as St}from"./chunk-E6SVTFAW.mjs";import"./chunk-5MRZID36.mjs";import{a as dt,b as ft,c as gt}from"./chunk-WBEROMBG.mjs";var X=["rate","ratio","pct","percent","percentage","rating","share","score","index","nps","csat","margin","yield","coverage","utilization","z[_-]?score","average","avg","mean","median","stddev","variance","gpa","percentile","quantile","efficiency","accuracy","probability","multiplier","coefficient","correlation","occupancy","age","bmi","temperature","density","pressure","humidity","ph","velocity","speed","elevation","altitude","latency","throughput","bandwidth","iops"],Y=["pct","percent","percentage","rate","ratio","rating","share","score","index","nps","csat","margin","yield","coverage","utilization","gpa","percentile","quantile","bmi","density","pressure","humidity","velocity","efficiency","occupancy","latency","throughput","bandwidth","iops"],J=["latitude","longitude"],Q=["latitude","longitude"],tt=/^\s*(sum|count|count\s+distinct|distinct\s+count)\s+of\s+/i,qt=/(?<=[a-z0-9])(?=[A-Z])|(?<=[A-Za-z])(?=[0-9])|(?<=[0-9])(?=[A-Za-z])/g,jt=new RegExp("\\b("+X.join("|")+")\\b|("+Y.join("|")+")$","i"),Wt=new RegExp("\\b("+J.join("|")+")\\b|("+Q.join("|")+")$","i");function L(e){return e?String(e).replace(tt,"").trim():""}function et(e){return!!e&&tt.test(String(e))}function Xt(e){let t=L(e);return t.length===0?"":t.replace(qt," ")}function nt(e,t){return t?e.test(Xt(t))||e.test(L(t)):!1}function z(e){return nt(Wt,e)}function it(e){return nt(jt,e)||z(e)}var ot=/int|double|decimal|single|float|number|currency|money/i;function Yt(e){let t=String(e?.valueNature??"").trim().toLowerCase();return t==="categorical"?"Categorical":t==="ordinal"?"Ordinal":t==="continuous"||e?.isMeasure===!0||ot.test(String(e?.dataType??""))?"Continuous":"Categorical"}function Jt(e){return e?.isMeasure===!0||ot.test(String(e?.dataType??""))}function G(e){let t=e??{},i=Yt(t);if(i!=="Continuous")return{nature:i,additivity:"unknown",basis:"role",suppressed:!1};if(z(t.name))return{nature:i,additivity:"positional",basis:"name",suppressed:!0};let s=String(t.additivity??"").trim().toLowerCase();if(!(s==="additive"&&et(t.name))){if(s==="additive")return{nature:i,additivity:"additive",basis:"measured",suppressed:!1};if(s==="part_of_whole")return{nature:i,additivity:"part_of_whole",basis:"measured",suppressed:!1};if(s==="intensive_rate")return{nature:i,additivity:"intensive_rate",basis:"measured",suppressed:!1}}return t.discourageAggregationAcrossGroups===!0?{nature:i,additivity:"intensive_rate",basis:"host-flag",suppressed:!1}:it(t.name)?{nature:i,additivity:"intensive_rate",basis:"name",suppressed:!1}:{nature:i,additivity:"additive",basis:"default",suppressed:!1}}function F(e){let t=G(e),i=e??{};if(t.nature==="Categorical")return["first","distinctcount","count"];if(t.nature==="Ordinal")return Jt(i)?["median","average","min","max","first","distinctcount","count"]:["first","distinctcount","count"];switch(t.additivity){case"positional":return["min","max","count","distinctcount","first"];case"intensive_rate":return["average","median","min","max","count","distinctcount","first"];default:return["sum","average","median","min","max","count","distinctcount","first"]}}function Qt(e){return F(e)[0]}function te(e,t){return F(e).indexOf(t)>=0}function ee(e,t){if(t!=="sum"&&t!=="count")return!1;if(t==="count")return!0;let i=G(e);return i.additivity==="additive"||i.additivity==="part_of_whole"||i.additivity==="unknown"}var $=2,at=400;function K(e){return!!T(e)}function v(e){let t=new Set;for(let i of e){if(i==null)continue;let s=S(String(i));if(!_(s)&&!t.has(s)&&(t.add(s),t.size>=at))break}return Array.from(t)}function h(e){let t=v(e);if(t.length===0||B(e)<95)return!1;let i=t.filter(u=>K(u)&&!g(u)).length,s=t.filter(u=>!K(u)&&!!g(u)).length;return i>=1&&i>=s}function rt(e,t){if(!g(e))return!1;let i=T(e);return i?t==="world"?!0:q.has(i):!1}function B(e){let t=v(e);if(t.length===0)return 0;let i=0;for(let s of t)K(s)&&i++;return Math.round(i/t.length*1e3)/10}function I(e){let t=v(e);if(t.length===0)return 0;let i=0;for(let s of t)g(s)&&i++;return Math.round(i/t.length*1e3)/10}function V(e){let t=new Set;for(let i of e){if(i==null)continue;let s=String(i).trim();if(!_(S(s))&&!t.has(s)&&(t.add(s),t.size>=at))break}return Array.from(t)}function H(e){let t=V(e);if(t.length===0)return 0;let i=0;for(let s of t)P(s).length>0&&i++;return Math.round(i/t.length*1e3)/10}function st(e,t){return W(t,j)?!0:V(e).some(i=>/^\d{5}(-\d{4})?$/.test(i.replace(/\.0+$/,"")))}function ne(e,t){let i=v(e);if(i.length===0)return 0;let s=0;for(let u of i)M(u,t)&&s++;return Math.round(s/i.length*1e3)/10}function D(e,t){let i=0;for(let s of v(e))t(s)&&i++;return i}function ie(e,t){let i=0;for(let s of V(e))t(s)&&i++;return i}function oe(e,t,i,s,u){let x=[],c=[],o={},R={},N=new Set(e),l=n=>t.map(r=>r[n]);for(let n of["city","country"]){let r=i?.[n];r&&N.has(r)&&(o[n]=r)}let ut=new Set(u??e);for(let n of["lat","lon"]){let r=i?.[n];r&&ut.has(r)&&(o[n]=r)}let p=i?.zip;if(p&&N.has(p)){let n=l(p),r=H(n);r<95?c.push(`zip=${p} (only ${r}% of values read as ZIPs)`):st(n,p)?o.zip=p:c.push(`zip=${p} (all values are 3-4 digits with nothing to say they are postal)`)}let f=i?.state;if(f&&N.has(f)){let n=l(f),r=v(n);r.length>0&&r.every(a=>rt(a,s))?c.push(`state=${f} (every value is "CA", which is both Canada and California)`):h(n)?(c.push(`state=${f} (every value is a country, not a state)`),o.country||(o.country=f)):I(n)<95?c.push(`state=${f} (only ${I(n)}% of values are states/provinces)`):o.state=f}let m=new Set(Object.values(o).filter(Boolean)),C=e.filter(n=>!m.has(n)&&!n.startsWith("__"));if(!o.state){let n=null;for(let r of C){let a=l(r);if(h(a))continue;let d=I(a);if(d<95)continue;let E=D(a,b=>!!g(b)),ct=D(a,b=>!!g(b)&&!rt(b,s));E<$&&ct<1||(!n||d>n.pct)&&(n={name:r,pct:d})}n&&(o.state=n.name,m.add(n.name),x.push(`state=${n.name} (${n.pct}% states/provinces)`))}if(!o.zip)for(let n of C){if(m.has(n))continue;let r=l(n),a=H(r);if(!(a<95)&&st(r,n)&&!(ie(r,d=>P(d).length>0)<$)){o.zip=n,m.add(n),x.push(`zip=${n} (${a}% ZIP codes)`);break}}let A=o.country;if(!A||!h(l(A))){let n=null;for(let r of C){if(m.has(r)||!h(l(r)))continue;let a=B(l(r));(!n||a>n.pct)&&(n={name:r,pct:a})}n&&(A&&(c.push(`country=${A} (only ${B(l(A))}% of values are country identifiers; using ${n.name} instead)`),R.country=A),o.country=n.name,m.add(n.name),x.push(`country=${n.name}`))}if(!o.city){let n=null;for(let r of C){if(m.has(r))continue;let a=l(r),d=ne(a,s);d<k||D(a,E=>M(E,s))<$||(!n||d>n.pct)&&(n={name:r,pct:d})}n&&(o.city=n.name,x.push(`city=${n.name} (${n.pct}% known cities)`))}let U=o.country?l(o.country):[],O=!!o.country&&h(U),lt=O?new Set(U.map(n=>T(n==null?null:String(n))).filter(Boolean)).size:0,Z=O&&lt>=2,w=!!(o.lat&&o.lon)&&t.some(n=>{let r=+String(n[o.lat]??"").trim(),a=+String(n[o.lon]??"").trim();return isFinite(r)&&isFinite(a)&&r>=-90&&r<=90&&a>=-180&&a<=180&&String(n[o.lat]??"").trim()!==""&&String(n[o.lon]??"").trim()!==""});return o.lat&&o.lon&&!w&&c.push(`lat/lon=${o.lat}/${o.lon} (no row holds a usable coordinate pair)`),o.country&&!Z&&!(o.city||o.state||o.zip||w)&&c.push(O?`country=${o.country} (every row resolves to the same country - nothing to place apart)`:`country=${o.country} (values are not country identifiers)`),{bind:!!(o.city||o.state||o.zip||Z||w)?o:null,backfilled:x,refused:c,...Object.keys(R).length?{labelFallback:R}:{}}}export{k as CITY_ROLE_MATCH_PCT,Gt as GET_RANDOM,Y as INTENSIVE_SUFFIX_TOKENS,X as INTENSIVE_WORD_TOKENS,Vt as IndexedText,Q as POSITIONAL_SUFFIX_TOKENS,J as POSITIONAL_WORD_TOKENS,y as ROLE_MATCH_PCT,zt as SIMPLE_STRING_HASH,Lt as STR,I as admin1MatchPct,F as allowedAggregations,It as buildGeoIsoColumn,Ct as buildGeoPointColumns,St as cityMatchPct,bt as cityTagsFor,Bt as classifyAdditivity,G as classifyForAggregation,Ht as classifyNumericValueNature,Dt as classifyTemporal,Ot as countryRegion,Qt as defaultAggregation,Et as detectFormatSignature,Tt as detectGeo,gt as detectOrdinalDomain,$t as detectTextDatePattern,Ut as engineTypeForSqlType,et as hasDefaultAggPrefix,Kt as hostAggHint,Zt as ingest,te as isAggregationAllowed,_ as isBlankLike,mt as isCityTableLoaded,vt as isGeoPointAmbiguity,Ft as isIdentifierName,Pt as isJoinGeoKind,dt as isOrdinalFriendlyName,h as looksLikeCountryColumn,Mt as monthLookupFor,it as nameLooksIntensiveRate,z as nameLooksPositional,yt as normalizeCountry,kt as normalizeMonthKey,S as normalizePlaceName,ht as normalizeZip5,pt as registerCityTable,Nt as registerIso3Regions,g as resolveAdmin1,xt as resolveGeoPoint,oe as resolvePointRoles,ft as safeDistinctValuesToShip,ee as shareOfTotalIsHonest,L as stripHostAggPrefix,wt as summarizeCountryRegions,Rt as summarizeGeoExtent,_t as toGeoIso,H as zipMatchPct,P as zipPrefixCandidates,At as zipToPrefix3};

package/dist/types/geoPointRoles.d.ts

@@ -78,4 +78,18 @@ export declare function zipMatchPct(values: Array<unknown>): number;
  * a refusal drops that ONE role, leaving the rest of the binding intact, because
  * geocoding from city alone still beats geocoding from nothing.
  */
-export declare function resolvePointRoles(columns: string[], rows: Array<Record<string, any>>, hint: PointBind | null, mapKind?: GeoMapKind | null): PointRoleResolution;
+export declare function resolvePointRoles(columns: string[], rows: Array<Record<string, any>>, hint: PointBind | null, mapKind?: GeoMapKind | null, 
+/** Columns the COORDINATE roles may be carried over from — the full set, measures included.
+ *  Defaults to `columns`, so a caller that does not pass it behaves exactly as before.
+ *
+ *  WHY THIS IS SEPARATE FROM `columns` (2026-09-02). `columns` must exclude measures, and the
+ *  reason above is a good one: it protects the BACKFILL, where a store number would be
+ *  adopted as the ZIP column on digit shape alone. But the same list also gated the
+ *  carry-over of an EXPLICITLY HINTED lat/lon — and coordinates are always measures, so those
+ *  two roles were unreachable by construction. Measured on a 21-city table with explicit
+ *  Latitude/Longitude: `precisionCounts.latlon = 0`, every row geocoded from its city NAME,
+ *  two rows refused outright for an ambiguous name while carrying exact coordinates, and the
+ *  rest placed at the gazetteer's coordinates rather than the data's — so editing a Latitude
+ *  cell moved no mark. Backfill still draws from `columns`; only the hinted coordinate roles
+ *  read this, and `latLonCanPlace` below is what verifies them. */
+coordinateColumns?: string[]): PointRoleResolution;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bicharts/shape-core",
-  "version": "0.5.46",
+  "version": "0.5.48",
   "description": "Host-agnostic data-shape profiler: ingest a dataset's rows through IValueCollection.addRow and read back the measured shape as an LLMColumnWithValue[] payload — types, cardinality, temporal/ordinal detection, geographic region and point resolution, cross-column signals. MEASUREMENT only: the policy that decides what a measured shape means for chart selection lives server-side.",
   "license": "Apache-2.0",
   "type": "module",