@whop/elements-react-native 0.1.0

package/lib/module/core/address/engine.test.js

@@ -0,0 +1,216 @@
+"use strict";
+
+// ported verbatim from frontend/apps/web/src/elements/address-form/engine.test.ts — proves the port against the same assertions
+
+/**
+ * The ported Chromium format engine, including the fixes over the developer-platform fork:
+ * zipRegex is enforced, upper flags apply at emit, subdivision iso codes read the real
+ * `sub_isoids` key, and ISO2 normalizes once at the boundary.
+ */
+import { describe, expect, it } from 'vitest';
+import { currencyCountry, emitAddress, loadCountryCatalog, normalizeCountry, parseCountryFormat, postalCodeMatches } from "./engine.js";
+const US_RAW = {
+  fmt: '%N%n%O%n%A%n%C, %S %Z',
+  require: 'ACSZ',
+  upper: 'CS',
+  zip: '(\\d{5})(?:[ \\-](\\d{4}))?',
+  zipex: '95014,22162-1010',
+  zip_name_type: 'zip',
+  state_name_type: 'state',
+  sub_keys: 'AL~AK~CA',
+  sub_names: 'Alabama~Alaska~California',
+  sub_isoids: 'AL~AK~CA'
+};
+describe('parseCountryFormat', () => {
+  it('maps fmt tokens to ordered fields with per-country required and upper flags', () => {
+    const format = parseCountryFormat('us', US_RAW);
+    expect(format.country).toBe('US');
+    expect(format.fields.map(field => field.type)).toEqual(['name', 'organization', 'line1', 'city', 'state', 'postal_code']);
+    expect(format.fields.find(field => field.type === 'name')?.required).toBe(false);
+    for (const type of ['line1', 'city', 'state', 'postal_code']) {
+      expect(format.fields.find(field => field.type === type)?.required).toBe(true);
+    }
+    expect(format.fields.find(field => field.type === 'city')?.upper).toBe(true);
+    expect(format.fields.find(field => field.type === 'state')?.upper).toBe(true);
+    expect(format.fields.find(field => field.type === 'line1')?.upper).toBe(false);
+    expect(format.fields.find(field => field.type === 'postal_code')?.postalPlaceholder).toBe('95014');
+    expect(format.stateLabel).toBe('state');
+    expect(format.postalLabel).toBe('zip');
+  });
+  it('reads subdivision iso codes from sub_isoids (the fork read a key the data never had)', () => {
+    const format = parseCountryFormat('US', US_RAW);
+    expect(format.stateOptions).toEqual([{
+      key: 'AL',
+      name: 'Alabama',
+      iso: 'AL'
+    }, {
+      key: 'AK',
+      name: 'Alaska',
+      iso: 'AK'
+    }, {
+      key: 'CA',
+      name: 'California',
+      iso: 'CA'
+    }]);
+  });
+  it('prefers the latin lfmt over fmt and keeps token order + D/X fidelity', () => {
+    const format = parseCountryFormat('JP', {
+      fmt: '〒%Z%n%S%n%A%n%O%n%N',
+      lfmt: '%N%n%O%n%A, %S%n%Z',
+      require: 'ASZ'
+    });
+    expect(format.fields.map(field => field.type)).toEqual(['name', 'organization', 'line1', 'state', 'postal_code']);
+    const sortable = parseCountryFormat('XX', {
+      fmt: '%A%n%D%n%C%n%X'
+    });
+    expect(sortable.fields.map(field => field.type)).toEqual(['line1', 'dependent_locality', 'city', 'sorting_code']);
+  });
+  it('reads only %-prefixed tokens as fields — literal print text (SE-, CH-, SINGAPORE, GUERNSEY) passes through', () => {
+    const se = parseCountryFormat('SE', {
+      fmt: '%O%n%N%n%A%nSE-%Z %C',
+      require: 'ACZ'
+    });
+    expect(se.fields.map(field => field.type)).toEqual(['organization', 'name', 'line1', 'postal_code', 'city']);
+    const ch = parseCountryFormat('CH', {
+      fmt: '%O%n%N%n%A%nCH-%Z %C',
+      require: 'ACZ'
+    });
+    expect(ch.fields.map(field => field.type)).toEqual(['organization', 'name', 'line1', 'postal_code', 'city']);
+    const sg = parseCountryFormat('SG', {
+      fmt: '%N%n%O%n%A%nSINGAPORE %Z',
+      require: 'AZ'
+    });
+    expect(sg.fields.map(field => field.type)).toEqual(['name', 'organization', 'line1', 'postal_code']);
+    const gg = parseCountryFormat('GG', {
+      fmt: '%N%n%O%n%A%n%C%nGUERNSEY%n%Z',
+      require: 'ACZ'
+    });
+    expect(gg.fields.map(field => field.type)).toEqual(['name', 'organization', 'line1', 'city', 'postal_code']);
+    const md = parseCountryFormat('MD', {
+      fmt: '%N%n%O%n%A%nMD-%Z %C'
+    });
+    expect(md.fields.some(field => field.type === 'dependent_locality')).toBe(false);
+  });
+  it('aligns the UZ subdivision override with the kept sub_isoids column', async () => {
+    const catalog = await loadCountryCatalog();
+    const uz = parseCountryFormat('UZ', catalog.UZ);
+    const isoByName = Object.fromEntries(uz.stateOptions.map(option => [option.name, option.iso]));
+    expect(isoByName['Tashkent']).toBe('TK');
+    expect(isoByName['Tashkent Region']).toBe('TO');
+    expect(isoByName['Karakalpakstan']).toBe('QR');
+    expect(isoByName['Andijan Region']).toBe('AN');
+    expect(isoByName['Xorazm Region']).toBe('XO');
+  });
+  it('keeps the common-country grid orders stable through the tokenizer (US/DE/GB/JP)', async () => {
+    const catalog = await loadCountryCatalog();
+    const gridOf = country => parseCountryFormat(country, catalog[country]).fields.map(field => field.type).filter(type => type === 'line1' || type === 'city' || type === 'state' || type === 'postal_code');
+    expect(gridOf('US')).toEqual(['line1', 'city', 'state', 'postal_code']);
+    expect(gridOf('DE')).toEqual(['line1', 'postal_code', 'city']);
+    expect(gridOf('GB')).toEqual(['line1', 'city', 'postal_code']);
+    expect(gridOf('JP')).toEqual(['line1', 'state', 'postal_code']);
+  });
+  it('falls back to line1/postal/city when the country has no format string', () => {
+    const format = parseCountryFormat('ZZ', {});
+    expect(format.fields.map(field => field.type)).toEqual(['line1', 'postal_code', 'city']);
+    expect(format.fields[0]?.required).toBe(true);
+  });
+  it('applies the subdivision overrides the dataset lacks', () => {
+    const format = parseCountryFormat('CR', {
+      fmt: '%N%n%O%n%A%n%S, %C%n%Z'
+    });
+    expect(format.stateOptions.map(option => option.key)).toContain('San José');
+  });
+  it('accepts the AR postal forms merchants actually enter, not just the full CPA', () => {
+    const {
+      zipRegex
+    } = parseCountryFormat('AR', {
+      zip: '[A-HJ-NP-Z]\\d{4}[A-Z]{3}'
+    });
+    expect(postalCodeMatches(zipRegex, '3560')).toBe(true);
+    expect(postalCodeMatches(zipRegex, 'S3560')).toBe(true);
+    expect(postalCodeMatches(zipRegex, 'S3560ABC')).toBe(true);
+    expect(postalCodeMatches(zipRegex, '356')).toBe(false);
+    expect(postalCodeMatches(zipRegex, 'S3560AB')).toBe(false);
+  });
+});
+describe('postalCodeMatches (zipRegex enforced — dead data in the fork)', () => {
+  const zip = US_RAW.zip;
+  it('anchors the country regex over the whole value', () => {
+    expect(postalCodeMatches(zip, '94107')).toBe(true);
+    expect(postalCodeMatches(zip, '94107-1234')).toBe(true);
+    expect(postalCodeMatches(zip, '9410')).toBe(false);
+    expect(postalCodeMatches(zip, '94107x')).toBe(false);
+  });
+  it('passes empty values and unparseable regexes through', () => {
+    expect(postalCodeMatches(zip, '')).toBe(true);
+    expect(postalCodeMatches(undefined, 'anything')).toBe(true);
+    expect(postalCodeMatches('([', '123')).toBe(true);
+  });
+});
+describe('emitAddress (upper flags at EMIT, ISO2 at the edge)', () => {
+  const format = parseCountryFormat('US', US_RAW);
+  it('uppercases exactly the flagged fields, trims, and drops empties', () => {
+    const emitted = emitAddress(format, {
+      name: ' Ada Lovelace ',
+      line1: '123 Main St',
+      line2: '',
+      city: 'san francisco',
+      state: 'ca',
+      postal_code: '94107'
+    });
+    expect(emitted).toEqual({
+      country: 'US',
+      name: 'Ada Lovelace',
+      line1: '123 Main St',
+      city: 'SAN FRANCISCO',
+      state: 'CA',
+      postal_code: '94107'
+    });
+  });
+  it('keeps split names, and organization_type only rides with an organization', () => {
+    const emitted = emitAddress(format, {
+      first_name: 'Ada',
+      last_name: 'Lovelace',
+      organization: 'Analytical Engines',
+      organization_type: 'business',
+      line1: '1 Engine Way',
+      postal_code: '94107'
+    });
+    expect(emitted.first_name).toBe('Ada');
+    expect(emitted.last_name).toBe('Lovelace');
+    expect(emitted.organization_type).toBe('business');
+    const withoutOrg = emitAddress(format, {
+      organization_type: 'business',
+      line1: '1 Engine Way'
+    });
+    expect(withoutOrg.organization_type).toBeUndefined();
+  });
+});
+describe('boundaries and helpers', () => {
+  it('normalizeCountry uppercases once at the edge and rejects non-ISO2 shapes', () => {
+    expect(normalizeCountry('de')).toBe('DE');
+    expect(normalizeCountry(' us ')).toBe('US');
+    expect(normalizeCountry('USA')).toBeUndefined();
+    expect(normalizeCountry('')).toBeUndefined();
+    expect(normalizeCountry(undefined)).toBeUndefined();
+  });
+  it('the generated catalog loads lazily and parses through the same engine', async () => {
+    const catalog = await loadCountryCatalog();
+    const us = parseCountryFormat('US', catalog.US);
+    expect(us.fields.some(field => field.type === 'state')).toBe(true);
+    expect(us.stateOptions.length).toBeGreaterThan(50);
+    expect(postalCodeMatches(us.zipRegex, '94107')).toBe(true);
+    expect(postalCodeMatches(us.zipRegex, 'ABC')).toBe(false);
+    const de = parseCountryFormat('DE', catalog.DE);
+    expect(de.fields.map(field => field.type)).toContain('postal_code');
+  });
+});
+describe('currencyCountry (the detect-country fallback hint)', () => {
+  it('maps single-country currencies only', () => {
+    expect(currencyCountry('USD')).toBe('US');
+    expect(currencyCountry('gbp')).toBe('GB');
+    expect(currencyCountry('eur')).toBeUndefined();
+    expect(currencyCountry(undefined)).toBeUndefined();
+  });
+});
+//# sourceMappingURL=engine.test.js.map

package/lib/module/core/address/engine.test.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["describe","expect","it","currencyCountry","emitAddress","loadCountryCatalog","normalizeCountry","parseCountryFormat","postalCodeMatches","US_RAW","fmt","require","upper","zip","zipex","zip_name_type","state_name_type","sub_keys","sub_names","sub_isoids","format","country","toBe","fields","map","field","type","toEqual","find","required","postalPlaceholder","stateLabel","postalLabel","stateOptions","key","name","iso","lfmt","sortable","se","ch","sg","gg","md","some","catalog","uz","UZ","isoByName","Object","fromEntries","option","gridOf","filter","toContain","zipRegex","undefined","emitted","line1","line2","city","state","postal_code","first_name","last_name","organization","organization_type","withoutOrg","toBeUndefined","us","US","length","toBeGreaterThan","de","DE"],"sourceRoot":"../../../../src","sources":["core/address/engine.test.ts"],"mappings":";;AAAA;;AAEA;AACA;AACA;AACA;AACA;AACA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,QAAQ;AAE7C,SACEC,eAAe,EACfC,WAAW,EACXC,kBAAkB,EAClBC,gBAAgB,EAChBC,kBAAkB,EAClBC,iBAAiB,QACZ,aAAU;AAEjB,MAAMC,MAAM,GAAG;EACbC,GAAG,EAAE,uBAAuB;EAC5BC,OAAO,EAAE,MAAM;EACfC,KAAK,EAAE,IAAI;EACXC,GAAG,EAAE,6BAA6B;EAClCC,KAAK,EAAE,kBAAkB;EACzBC,aAAa,EAAE,KAAK;EACpBC,eAAe,EAAE,OAAO;EACxBC,QAAQ,EAAE,UAAU;EACpBC,SAAS,EAAE,2BAA2B;EACtCC,UAAU,EAAE;AACd,CAAC;AAEDnB,QAAQ,CAAC,oBAAoB,EAAE,MAAM;EACnCE,EAAE,CAAC,6EAA6E,EAAE,MAAM;IACtF,MAAMkB,MAAM,GAAGb,kBAAkB,CAAC,IAAI,EAAEE,MAAM,CAAC;IAC/CR,MAAM,CAACmB,MAAM,CAACC,OAAO,CAAC,CAACC,IAAI,CAAC,IAAI,CAAC;IACjCrB,MAAM,CAACmB,MAAM,CAACG,MAAM,CAACC,GAAG,CAAEC,KAAK,IAAKA,KAAK,CAACC,IAAI,CAAC,CAAC,CAACC,OAAO,CAAC,CACvD,MAAM,EACN,cAAc,EACd,OAAO,EACP,MAAM,EACN,OAAO,EACP,aAAa,CACd,CAAC;IACF1B,MAAM,CAACmB,MAAM,CAACG,MAAM,CAACK,IAAI,CAAEH,KAAK,IAAKA,KAAK,CAACC,IAAI,KAAK,MAAM,CAAC,EAAEG,QAAQ,CAAC,CAACP,IAAI,CAAC,KAAK,CAAC;IAClF,KAAK,MAAMI,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,EAAW;MACrEzB,MAAM,CAACmB,MAAM,CAACG,MAAM,CAACK,IAAI,CAAEH,KAAK,IAAKA,KAAK,CAACC,IAAI,KAAKA,IAAI,CAAC,EAAEG,QAAQ,CAAC,CAACP,IAAI,CAAC,IAAI,CAAC;IACjF;IACArB,MAAM,CAACmB,MAAM,CAACG,MAAM,CAACK,IAAI,CAAEH,KAAK,IAAKA,KAAK,CAACC,IAAI,KAAK,MAAM,CAAC,EAAEd,KAAK,CAAC,CAACU,IAAI,CAAC,IAAI,CAAC;IAC9ErB,MAAM,CAACmB,MAAM,CAACG,MAAM,CAACK,IAAI,CAAEH,KAAK,IAAKA,KAAK,CAACC,IAAI,KAAK,OAAO,CAAC,EAAEd,KAAK,CAAC,CAACU,IAAI,CAAC,IAAI,CAAC;IAC/ErB,MAAM,CAACmB,MAAM,CAACG,MAAM,CAACK,IAAI,CAAEH,KAAK,IAAKA,KAAK,CAACC,IAAI,KAAK,OAAO,CAAC,EAAEd,KAAK,CAAC,CAACU,IAAI,CAAC,KAAK,CAAC;IAChFrB,MAAM,CAACmB,MAAM,CAACG,MAAM,CAACK,IAAI,CAAEH,KAAK,IAAKA,KAAK,CAACC,IAAI,KAAK,aAAa,CAAC,EAAEI,iBAAiB,CAAC,CAACR,IAAI,CAAC,OAAO,CAAC;IACpGrB,MAAM,CAACmB,MAAM,CAACW,UAAU,CAAC,CAACT,IAAI,CAAC,OAAO,CAAC;IACvCrB,MAAM,CAACmB,MAAM,CAACY,WAAW,CAAC,CAACV,IAAI,CAAC,KAAK,CAAC;EACxC,CAAC,CAAC;EAEFpB,EAAE,CAAC,sFAAsF,EAAE,MAAM;IAC/F,MAAMkB,MAAM,GAAGb,kBAAkB,CAAC,IAAI,EAAEE,MAAM,CAAC;IAC/CR,MAAM,CAACmB,MAAM,CAACa,YAAY,CAAC,CAACN,OAAO,CAAC,CAClC;MAAEO,GAAG,EAAE,IAAI;MAAEC,IAAI,EAAE,SAAS;MAAEC,GAAG,EAAE;IAAK,CAAC,EACzC;MAAEF,GAAG,EAAE,IAAI;MAAEC,IAAI,EAAE,QAAQ;MAAEC,GAAG,EAAE;IAAK,CAAC,EACxC;MAAEF,GAAG,EAAE,IAAI;MAAEC,IAAI,EAAE,YAAY;MAAEC,GAAG,EAAE;IAAK,CAAC,CAC7C,CAAC;EACJ,CAAC,CAAC;EAEFlC,EAAE,CAAC,sEAAsE,EAAE,MAAM;IAC/E,MAAMkB,MAAM,GAAGb,kBAAkB,CAAC,IAAI,EAAE;MACtCG,GAAG,EAAE,qBAAqB;MAC1B2B,IAAI,EAAE,oBAAoB;MAC1B1B,OAAO,EAAE;IACX,CAAC,CAAC;IACFV,MAAM,CAACmB,MAAM,CAACG,MAAM,CAACC,GAAG,CAAEC,KAAK,IAAKA,KAAK,CAACC,IAAI,CAAC,CAAC,CAACC,OAAO,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IACnH,MAAMW,QAAQ,GAAG/B,kBAAkB,CAAC,IAAI,EAAE;MAAEG,GAAG,EAAE;IAAiB,CAAC,CAAC;IACpET,MAAM,CAACqC,QAAQ,CAACf,MAAM,CAACC,GAAG,CAAEC,KAAK,IAAKA,KAAK,CAACC,IAAI,CAAC,CAAC,CAACC,OAAO,CAAC,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;EACrH,CAAC,CAAC;EAEFzB,EAAE,CAAC,4GAA4G,EAAE,MAAM;IACrH,MAAMqC,EAAE,GAAGhC,kBAAkB,CAAC,IAAI,EAAE;MAAEG,GAAG,EAAE,sBAAsB;MAAEC,OAAO,EAAE;IAAM,CAAC,CAAC;IACpFV,MAAM,CAACsC,EAAE,CAAChB,MAAM,CAACC,GAAG,CAAEC,KAAK,IAAKA,KAAK,CAACC,IAAI,CAAC,CAAC,CAACC,OAAO,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAC9G,MAAMa,EAAE,GAAGjC,kBAAkB,CAAC,IAAI,EAAE;MAAEG,GAAG,EAAE,sBAAsB;MAAEC,OAAO,EAAE;IAAM,CAAC,CAAC;IACpFV,MAAM,CAACuC,EAAE,CAACjB,MAAM,CAACC,GAAG,CAAEC,KAAK,IAAKA,KAAK,CAACC,IAAI,CAAC,CAAC,CAACC,OAAO,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAC9G,MAAMc,EAAE,GAAGlC,kBAAkB,CAAC,IAAI,EAAE;MAAEG,GAAG,EAAE,0BAA0B;MAAEC,OAAO,EAAE;IAAK,CAAC,CAAC;IACvFV,MAAM,CAACwC,EAAE,CAAClB,MAAM,CAACC,GAAG,CAAEC,KAAK,IAAKA,KAAK,CAACC,IAAI,CAAC,CAAC,CAACC,OAAO,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IACtG,MAAMe,EAAE,GAAGnC,kBAAkB,CAAC,IAAI,EAAE;MAAEG,GAAG,EAAE,8BAA8B;MAAEC,OAAO,EAAE;IAAM,CAAC,CAAC;IAC5FV,MAAM,CAACyC,EAAE,CAACnB,MAAM,CAACC,GAAG,CAAEC,KAAK,IAAKA,KAAK,CAACC,IAAI,CAAC,CAAC,CAACC,OAAO,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9G,MAAMgB,EAAE,GAAGpC,kBAAkB,CAAC,IAAI,EAAE;MAAEG,GAAG,EAAE;IAAuB,CAAC,CAAC;IACpET,MAAM,CAAC0C,EAAE,CAACpB,MAAM,CAACqB,IAAI,CAAEnB,KAAK,IAAKA,KAAK,CAACC,IAAI,KAAK,oBAAoB,CAAC,CAAC,CAACJ,IAAI,CAAC,KAAK,CAAC;EACpF,CAAC,CAAC;EAEFpB,EAAE,CAAC,oEAAoE,EAAE,YAAY;IACnF,MAAM2C,OAAO,GAAG,MAAMxC,kBAAkB,CAAC,CAAC;IAC1C,MAAMyC,EAAE,GAAGvC,kBAAkB,CAAC,IAAI,EAAEsC,OAAO,CAACE,EAAE,CAAC;IAC/C,MAAMC,SAAS,GAAGC,MAAM,CAACC,WAAW,CAACJ,EAAE,CAACb,YAAY,CAACT,GAAG,CAAE2B,MAAM,IAAK,CAACA,MAAM,CAAChB,IAAI,EAAEgB,MAAM,CAACf,GAAG,CAAC,CAAC,CAAC;IAChGnC,MAAM,CAAC+C,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC1B,IAAI,CAAC,IAAI,CAAC;IACxCrB,MAAM,CAAC+C,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC1B,IAAI,CAAC,IAAI,CAAC;IAC/CrB,MAAM,CAAC+C,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC1B,IAAI,CAAC,IAAI,CAAC;IAC9CrB,MAAM,CAAC+C,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC1B,IAAI,CAAC,IAAI,CAAC;IAC9CrB,MAAM,CAAC+C,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC1B,IAAI,CAAC,IAAI,CAAC;EAC/C,CAAC,CAAC;EAEFpB,EAAE,CAAC,iFAAiF,EAAE,YAAY;IAChG,MAAM2C,OAAO,GAAG,MAAMxC,kBAAkB,CAAC,CAAC;IAC1C,MAAM+C,MAAM,GAAI/B,OAAe,IAC7Bd,kBAAkB,CAACc,OAAO,EAAEwB,OAAO,CAACxB,OAAO,CAAC,CAAC,CAC1CE,MAAM,CAACC,GAAG,CAAEC,KAAK,IAAKA,KAAK,CAACC,IAAI,CAAC,CACjC2B,MAAM,CAAE3B,IAAI,IAAKA,IAAI,KAAK,OAAO,IAAIA,IAAI,KAAK,MAAM,IAAIA,IAAI,KAAK,OAAO,IAAIA,IAAI,KAAK,aAAa,CAAC;IACxGzB,MAAM,CAACmD,MAAM,CAAC,IAAI,CAAC,CAAC,CAACzB,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IACvE1B,MAAM,CAACmD,MAAM,CAAC,IAAI,CAAC,CAAC,CAACzB,OAAO,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAC9D1B,MAAM,CAACmD,MAAM,CAAC,IAAI,CAAC,CAAC,CAACzB,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9D1B,MAAM,CAACmD,MAAM,CAAC,IAAI,CAAC,CAAC,CAACzB,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;EACjE,CAAC,CAAC;EAEFzB,EAAE,CAAC,uEAAuE,EAAE,MAAM;IAChF,MAAMkB,MAAM,GAAGb,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3CN,MAAM,CAACmB,MAAM,CAACG,MAAM,CAACC,GAAG,CAAEC,KAAK,IAAKA,KAAK,CAACC,IAAI,CAAC,CAAC,CAACC,OAAO,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAC1F1B,MAAM,CAACmB,MAAM,CAACG,MAAM,CAAC,CAAC,CAAC,EAAEM,QAAQ,CAAC,CAACP,IAAI,CAAC,IAAI,CAAC;EAC/C,CAAC,CAAC;EAEFpB,EAAE,CAAC,qDAAqD,EAAE,MAAM;IAC9D,MAAMkB,MAAM,GAAGb,kBAAkB,CAAC,IAAI,EAAE;MAAEG,GAAG,EAAE;IAAyB,CAAC,CAAC;IAC1ET,MAAM,CAACmB,MAAM,CAACa,YAAY,CAACT,GAAG,CAAE2B,MAAM,IAAKA,MAAM,CAACjB,GAAG,CAAC,CAAC,CAACoB,SAAS,CAAC,UAAU,CAAC;EAC/E,CAAC,CAAC;EAEFpD,EAAE,CAAC,6EAA6E,EAAE,MAAM;IACtF,MAAM;MAAEqD;IAAS,CAAC,GAAGhD,kBAAkB,CAAC,IAAI,EAAE;MAAEM,GAAG,EAAE;IAA4B,CAAC,CAAC;IACnFZ,MAAM,CAACO,iBAAiB,CAAC+C,QAAQ,EAAE,MAAM,CAAC,CAAC,CAACjC,IAAI,CAAC,IAAI,CAAC;IACtDrB,MAAM,CAACO,iBAAiB,CAAC+C,QAAQ,EAAE,OAAO,CAAC,CAAC,CAACjC,IAAI,CAAC,IAAI,CAAC;IACvDrB,MAAM,CAACO,iBAAiB,CAAC+C,QAAQ,EAAE,UAAU,CAAC,CAAC,CAACjC,IAAI,CAAC,IAAI,CAAC;IAC1DrB,MAAM,CAACO,iBAAiB,CAAC+C,QAAQ,EAAE,KAAK,CAAC,CAAC,CAACjC,IAAI,CAAC,KAAK,CAAC;IACtDrB,MAAM,CAACO,iBAAiB,CAAC+C,QAAQ,EAAE,SAAS,CAAC,CAAC,CAACjC,IAAI,CAAC,KAAK,CAAC;EAC5D,CAAC,CAAC;AACJ,CAAC,CAAC;AAEFtB,QAAQ,CAAC,+DAA+D,EAAE,MAAM;EAC9E,MAAMa,GAAG,GAAGJ,MAAM,CAACI,GAAG;EACtBX,EAAE,CAAC,gDAAgD,EAAE,MAAM;IACzDD,MAAM,CAACO,iBAAiB,CAACK,GAAG,EAAE,OAAO,CAAC,CAAC,CAACS,IAAI,CAAC,IAAI,CAAC;IAClDrB,MAAM,CAACO,iBAAiB,CAACK,GAAG,EAAE,YAAY,CAAC,CAAC,CAACS,IAAI,CAAC,IAAI,CAAC;IACvDrB,MAAM,CAACO,iBAAiB,CAACK,GAAG,EAAE,MAAM,CAAC,CAAC,CAACS,IAAI,CAAC,KAAK,CAAC;IAClDrB,MAAM,CAACO,iBAAiB,CAACK,GAAG,EAAE,QAAQ,CAAC,CAAC,CAACS,IAAI,CAAC,KAAK,CAAC;EACtD,CAAC,CAAC;EACFpB,EAAE,CAAC,qDAAqD,EAAE,MAAM;IAC9DD,MAAM,CAACO,iBAAiB,CAACK,GAAG,EAAE,EAAE,CAAC,CAAC,CAACS,IAAI,CAAC,IAAI,CAAC;IAC7CrB,MAAM,CAACO,iBAAiB,CAACgD,SAAS,EAAE,UAAU,CAAC,CAAC,CAAClC,IAAI,CAAC,IAAI,CAAC;IAC3DrB,MAAM,CAACO,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAACc,IAAI,CAAC,IAAI,CAAC;EACnD,CAAC,CAAC;AACJ,CAAC,CAAC;AAEFtB,QAAQ,CAAC,qDAAqD,EAAE,MAAM;EACpE,MAAMoB,MAAM,GAAGb,kBAAkB,CAAC,IAAI,EAAEE,MAAM,CAAC;EAC/CP,EAAE,CAAC,iEAAiE,EAAE,MAAM;IAC1E,MAAMuD,OAAO,GAAGrD,WAAW,CAACgB,MAAM,EAAE;MAClCe,IAAI,EAAE,gBAAgB;MACtBuB,KAAK,EAAE,aAAa;MACpBC,KAAK,EAAE,EAAE;MACTC,IAAI,EAAE,eAAe;MACrBC,KAAK,EAAE,IAAI;MACXC,WAAW,EAAE;IACf,CAAC,CAAC;IACF7D,MAAM,CAACwD,OAAO,CAAC,CAAC9B,OAAO,CAAC;MACtBN,OAAO,EAAE,IAAI;MACbc,IAAI,EAAE,cAAc;MACpBuB,KAAK,EAAE,aAAa;MACpBE,IAAI,EAAE,eAAe;MACrBC,KAAK,EAAE,IAAI;MACXC,WAAW,EAAE;IACf,CAAC,CAAC;EACJ,CAAC,CAAC;EACF5D,EAAE,CAAC,0EAA0E,EAAE,MAAM;IACnF,MAAMuD,OAAO,GAAGrD,WAAW,CAACgB,MAAM,EAAE;MAClC2C,UAAU,EAAE,KAAK;MACjBC,SAAS,EAAE,UAAU;MACrBC,YAAY,EAAE,oBAAoB;MAClCC,iBAAiB,EAAE,UAAU;MAC7BR,KAAK,EAAE,cAAc;MACrBI,WAAW,EAAE;IACf,CAAC,CAAC;IACF7D,MAAM,CAACwD,OAAO,CAACM,UAAU,CAAC,CAACzC,IAAI,CAAC,KAAK,CAAC;IACtCrB,MAAM,CAACwD,OAAO,CAACO,SAAS,CAAC,CAAC1C,IAAI,CAAC,UAAU,CAAC;IAC1CrB,MAAM,CAACwD,OAAO,CAACS,iBAAiB,CAAC,CAAC5C,IAAI,CAAC,UAAU,CAAC;IAClD,MAAM6C,UAAU,GAAG/D,WAAW,CAACgB,MAAM,EAAE;MAAE8C,iBAAiB,EAAE,UAAU;MAAER,KAAK,EAAE;IAAe,CAAC,CAAC;IAChGzD,MAAM,CAACkE,UAAU,CAACD,iBAAiB,CAAC,CAACE,aAAa,CAAC,CAAC;EACtD,CAAC,CAAC;AACJ,CAAC,CAAC;AAEFpE,QAAQ,CAAC,wBAAwB,EAAE,MAAM;EACvCE,EAAE,CAAC,0EAA0E,EAAE,MAAM;IACnFD,MAAM,CAACK,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAACgB,IAAI,CAAC,IAAI,CAAC;IACzCrB,MAAM,CAACK,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAACgB,IAAI,CAAC,IAAI,CAAC;IAC3CrB,MAAM,CAACK,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC8D,aAAa,CAAC,CAAC;IAC/CnE,MAAM,CAACK,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC8D,aAAa,CAAC,CAAC;IAC5CnE,MAAM,CAACK,gBAAgB,CAACkD,SAAS,CAAC,CAAC,CAACY,aAAa,CAAC,CAAC;EACrD,CAAC,CAAC;EACFlE,EAAE,CAAC,uEAAuE,EAAE,YAAY;IACtF,MAAM2C,OAAO,GAAG,MAAMxC,kBAAkB,CAAC,CAAC;IAC1C,MAAMgE,EAAE,GAAG9D,kBAAkB,CAAC,IAAI,EAAEsC,OAAO,CAACyB,EAAE,CAAC;IAC/CrE,MAAM,CAACoE,EAAE,CAAC9C,MAAM,CAACqB,IAAI,CAAEnB,KAAK,IAAKA,KAAK,CAACC,IAAI,KAAK,OAAO,CAAC,CAAC,CAACJ,IAAI,CAAC,IAAI,CAAC;IACpErB,MAAM,CAACoE,EAAE,CAACpC,YAAY,CAACsC,MAAM,CAAC,CAACC,eAAe,CAAC,EAAE,CAAC;IAClDvE,MAAM,CAACO,iBAAiB,CAAC6D,EAAE,CAACd,QAAQ,EAAE,OAAO,CAAC,CAAC,CAACjC,IAAI,CAAC,IAAI,CAAC;IAC1DrB,MAAM,CAACO,iBAAiB,CAAC6D,EAAE,CAACd,QAAQ,EAAE,KAAK,CAAC,CAAC,CAACjC,IAAI,CAAC,KAAK,CAAC;IACzD,MAAMmD,EAAE,GAAGlE,kBAAkB,CAAC,IAAI,EAAEsC,OAAO,CAAC6B,EAAE,CAAC;IAC/CzE,MAAM,CAACwE,EAAE,CAAClD,MAAM,CAACC,GAAG,CAAEC,KAAK,IAAKA,KAAK,CAACC,IAAI,CAAC,CAAC,CAAC4B,SAAS,CAAC,aAAa,CAAC;EACvE,CAAC,CAAC;AACJ,CAAC,CAAC;AAEFtD,QAAQ,CAAC,oDAAoD,EAAE,MAAM;EACnEE,EAAE,CAAC,qCAAqC,EAAE,MAAM;IAC9CD,MAAM,CAACE,eAAe,CAAC,KAAK,CAAC,CAAC,CAACmB,IAAI,CAAC,IAAI,CAAC;IACzCrB,MAAM,CAACE,eAAe,CAAC,KAAK,CAAC,CAAC,CAACmB,IAAI,CAAC,IAAI,CAAC;IACzCrB,MAAM,CAACE,eAAe,CAAC,KAAK,CAAC,CAAC,CAACiE,aAAa,CAAC,CAAC;IAC9CnE,MAAM,CAACE,eAAe,CAACqD,SAAS,CAAC,CAAC,CAACY,aAAa,CAAC,CAAC;EACpD,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}

package/lib/module/core/address/form-state.js

@@ -0,0 +1,409 @@
+"use strict";
+
+// ported verbatim from frontend/apps/web/src/elements/address-form/form-state.ts — keep in sync when the web element changes
+
+/**
+ * The address form's ONE state atom (useReducer shape) + the schema-driven central validator.
+ * Country lives IN the atom; hydration is ONE seed (defaultValues > detected IP country >
+ * currency-country hint > US) computed before first paint; reveal-vs-autofill is reducer
+ * state, not component-local flags. Pure module — the jsdom suites drive it directly.
+ */
+
+import { emitAddress, normalizeCountry, postalCodeMatches } from "./engine.js";
+export function allowedCountryList(config, catalogCountries) {
+  const raw = config.allowedCountries ?? [];
+  const allowed = raw.map(code => normalizeCountry(code)).filter(code => Boolean(code));
+  // Fail LOUD, never open: a list where every entry failed ISO2 normalization (['USA']) is a
+  // config error — silently widening to the whole catalog would undo the merchant's restriction
+  // on a typo. Same refusal bar as the charge config's plan-XOR gate.
+  if (raw.length > 0 && allowed.length === 0) {
+    throw new Error(`allowedCountries has no valid ISO2 entries (got ${JSON.stringify(raw)}) — use two-letter codes like 'US'`);
+  }
+  return allowed.length > 0 ? allowed : catalogCountries;
+}
+function clampCountry(candidate, allowed) {
+  return candidate && allowed.includes(candidate) ? candidate : undefined;
+}
+export function seedAddressForm(config, seed, catalogCountries) {
+  const allowed = allowedCountryList(config, catalogCountries);
+  const country = clampCountry(normalizeCountry(seed.defaultValues?.address?.country), allowed) ?? clampCountry(normalizeCountry(seed.detectedCountry), allowed) ?? clampCountry(normalizeCountry(seed.countryHint), allowed) ?? clampCountry('US', allowed) ?? allowed.at(0) ?? 'US';
+  const preset = seed.defaultValues?.address ?? {};
+  const values = {};
+  const putSeed = (key, value) => {
+    if (value?.trim()) values[key] = value;
+  };
+  putSeed('name', seed.defaultValues?.name ?? preset.name);
+  putSeed('first_name', preset.first_name);
+  putSeed('last_name', preset.last_name);
+  putSeed('organization', preset.organization);
+  putSeed('line1', preset.line1);
+  putSeed('line2', preset.line2);
+  putSeed('city', preset.city);
+  putSeed('state', preset.state);
+  putSeed('postal_code', preset.postal_code);
+  const seededBeyondLine1 = Boolean(values.city || values.state || values.postal_code || values.line2);
+  return {
+    country,
+    values,
+    organizationType: preset.organization_type ?? '',
+    custom: {},
+    revealed: config.scope === 'minimal' || seededBeyondLine1,
+    line2Open: config.line2 === 'always' || Boolean(values.line2),
+    selecting: false,
+    touched: {},
+    showAllErrors: false
+  };
+}
+const GRID_FIELDS = new Set(['city', 'state', 'postal_code', 'line2']);
+export function addressFormReducer(state, action) {
+  switch (action.type) {
+    case 'edit':
+      {
+        const values = {
+          ...state.values,
+          [action.field]: action.value
+        };
+        // Two autofill-reveal rails: a value landing in a still-hidden grid field (Chrome fills
+        // hidden SELECTS despite skipping hidden inputs), and an `autofilled` edit — an
+        // inputType-less/insertReplacementText input event on a visible field, the shape every
+        // engine's fill produces and typing never does.
+        const landedHidden = !state.revealed && GRID_FIELDS.has(action.field) && action.value.trim().length > 0;
+        const autofillReveal = Boolean(action.autofilled) && action.value.trim().length > 0;
+        // An autofill commit also opens line2 in toggle mode, in the SAME state commit that
+        // reveals the grid: a conditionally-rendered line2 has no control for Chrome's refill
+        // pass to land in, so an autofilled line2 value would be silently dropped. Once open it
+        // stays open — re-collapsing on an empty settle would be another control-list mutation.
+        const autofillCommit = landedHidden || autofillReveal;
+        return {
+          ...state,
+          values,
+          revealed: state.revealed || autofillCommit,
+          line2Open: state.line2Open || autofillCommit || action.field === 'line2' && action.value.trim().length > 0,
+          // ANY value activity cancels a pending pick — a fill landing on another cell (autofill
+          // probe, refill pass) mid-resolve invalidates the resolve at the line1 cell, and a
+          // stranded `selecting` would block the suggestions popover until the next line1 edit.
+          selecting: false
+        };
+      }
+    case 'edit-custom':
+      return {
+        ...state,
+        custom: {
+          ...state.custom,
+          [action.key]: action.value
+        }
+      };
+    case 'set-organization-type':
+      return {
+        ...state,
+        organizationType: action.value
+      };
+    case 'set-country':
+      {
+        const country = normalizeCountry(action.country);
+        if (!country || country === state.country) return state;
+        // A country switch keeps line1/line2/city but drops the state selection (subdivision
+        // keys are country-scoped) — postal stays and revalidates under the new zipRegex. It also
+        // cancels an in-flight place selection: the buyer's country choice supersedes the pick
+        // (the line1 cell drops the resolve on the distribution clock).
+        return {
+          ...state,
+          country,
+          values: {
+            ...state.values,
+            state: undefined
+          },
+          selecting: false
+        };
+      }
+    case 'begin-select':
+      return {
+        ...state,
+        selecting: true
+      };
+    case 'select-failed':
+      return {
+        ...state,
+        selecting: false
+      };
+    case 'apply-place':
+      {
+        const {
+          parsed,
+          allowed
+        } = action;
+        if (!placeAllowed(allowed, parsed)) return {
+          ...state,
+          selecting: false
+        };
+        // Locality grid = WHOLE-REPLACE on purpose: a chosen place is one address, and mixing a
+        // prior postal/city with the new street is a franken-address AVS hazard (a place-omitted
+        // cell stays empty and focus-first-empty lands there). line1 keeps the typed entry only
+        // when the parse has no street line; line2 (subpremise) is place-data almost never, so
+        // the user's unit number survives the pick.
+        const values = {
+          ...state.values,
+          line1: parsed.line1 ?? state.values.line1,
+          line2: parsed.line2 ?? state.values.line2,
+          city: parsed.city ?? '',
+          state: parsed.state ?? '',
+          postal_code: parsed.postal_code ?? ''
+        };
+        return {
+          ...state,
+          country: parsed.country ?? state.country,
+          values,
+          revealed: true,
+          line2Open: state.line2Open || Boolean(parsed.line2),
+          selecting: false
+        };
+      }
+    case 'reveal':
+      {
+        const line2Open = state.line2Open || Boolean(action.autofill);
+        if (state.revealed && line2Open === state.line2Open) return state;
+        return {
+          ...state,
+          revealed: true,
+          line2Open
+        };
+      }
+    case 'toggle-line2':
+      return {
+        ...state,
+        line2Open: !state.line2Open
+      };
+    case 'blur':
+      {
+        const touched = {
+          ...state.touched,
+          [action.field]: true
+        };
+        const revealOnLine1 = action.field === 'line1' && Boolean(state.values.line1?.trim());
+        return {
+          ...state,
+          touched,
+          revealed: state.revealed || revealOnLine1
+        };
+      }
+    case 'show-errors':
+      return {
+        ...state,
+        showAllErrors: true
+      };
+    default:
+      return state;
+  }
+}
+/** The commit-point allow gate ([] = unrestricted): a restrictive list declines a foreign OR
+ *  country-less parse — unknown provenance must not land foreign locality data under the locked
+ *  ISO2. Shared by the reducer arm and the placeSelected reaction (which must know BEFORE
+ *  reducing whether to mark the commit `placed` — a declined pick must not bump placeSeq). */
+/** The Places-gate allow list: [] = unrestricted. DISTINCT from allowedCountryList (the
+ *  country-select options, which falls back to the whole catalog) — feeding that catalog
+ *  fallback into placeAllowed would wrongly decline catalog-missing territories on
+ *  unrestricted configs. */
+/**
+ * The floor a scope implies, which is what makes `scope="minimal"` mean anything.
+ *
+ * Minimal renders EXACTLY the floor, so an empty floor renders an empty grid: the element shipped a
+ * country select and nothing else, and a buyer could complete that form while the card confirm then
+ * refused at the AVS check for a postal code never collected. Web wires the same value at
+ * apps/web/src/elements/payments/address.tsx:317.
+ */
+export function requiredFloorFor(scope) {
+  return scope === 'minimal' ? ['postal_code'] : undefined;
+}
+export function placeAllowList(config, catalogCountries) {
+  return config.allowedCountries?.length ? allowedCountryList(config, catalogCountries) : [];
+}
+export function placeAllowed(allowed, parsed) {
+  if (allowed.length === 0) return true;
+  return Boolean(parsed.country && allowed.includes(parsed.country));
+}
+const CONTRACT_GRID_KEYS = new Set(['line1', 'city', 'state', 'postal_code']);
+
+/** The schema for a (country, config) pair: which grid fields exist and which fields are
+ *  required. Full scope = the country format's fields (its `require` flags) ∪ the floor;
+ *  minimal scope = EXACTLY the floor (plus country, the form's spine). */
+export function planFields(config, format) {
+  const floor = new Set((config.requiredFloor ?? []).filter(key => key !== 'country'));
+  const required = new Set(['country']);
+  const gridFields = [];
+  const formatHas = type => format.fields.some(field => field.type === type);
+  const formatRequires = type => format.fields.some(field => field.type === type && field.required);
+
+  // Minimal = EXACTLY the floor (the method-declared payment minimum — no universal
+  // postal/AVS baseline); full = the country format, widened by the floor.
+  const includeGrid = type => {
+    if (config.scope === 'minimal') return floor.has(type);
+    return formatHas(type) || floor.has(type);
+  };
+  const orderedTypes = [];
+  for (const field of format.fields) {
+    if (field.type === 'line1' || field.type === 'city' || field.type === 'state' || field.type === 'postal_code') {
+      orderedTypes.push(field.type);
+    }
+  }
+  for (const key of ['line1', 'city', 'state', 'postal_code']) {
+    if (!orderedTypes.includes(key)) orderedTypes.push(key);
+  }
+  for (const type of orderedTypes) {
+    if (includeGrid(type)) gridFields.push(type);
+  }
+  for (const type of gridFields) {
+    if (config.scope === 'minimal') {
+      required.add(type);
+    } else if (formatRequires(type) || floor.has(type)) {
+      required.add(type);
+    }
+  }
+  if (config.scope === 'full' && gridFields.includes('line1')) required.add('line1');
+  if (config.name === 'combined') required.add('name');
+  if (config.name === 'split') {
+    required.add('first_name');
+    required.add('last_name');
+  }
+  if (config.name === 'none' && floor.has('name')) required.add('name');
+  if (config.organization !== 'none' && floor.has('organization')) required.add('organization');
+  for (const field of config.customFields ?? []) {
+    if (field.required) required.add(`custom:${field.key}`);
+  }
+  return {
+    gridFields,
+    required
+  };
+}
+
+/** Custom-field values are short by nature (tax ids, VAT numbers) — anything past this bound is
+ *  invalid WITHOUT running the merchant's pattern, which also removes the buyer-controlled half
+ *  of a catastrophic-backtracking blowup (cost scales with tested input length; the pattern
+ *  author is the embedding page's owner, so the residual risk is self-scoped jank). */
+const CUSTOM_FORMAT_INPUT_CAP = 320;
+const customFormatCache = new Map();
+function customFieldPattern(format) {
+  let compiled = customFormatCache.get(format);
+  if (compiled === undefined) {
+    try {
+      compiled = new RegExp(format);
+    } catch {
+      compiled = null;
+    }
+    customFormatCache.set(format, compiled);
+  }
+  return compiled;
+}
+function customFieldMatches(spec, value) {
+  if (!spec.format || !value) return true;
+  if (value.length > CUSTOM_FORMAT_INPUT_CAP) return false;
+  return customFieldPattern(spec.format)?.test(value) ?? true;
+}
+export function validateAddressForm(config, format, state) {
+  const plan = planFields(config, format);
+  const errors = {};
+  const has = key => Boolean(state.values[key]?.trim());
+  for (const key of plan.required) {
+    if (key === 'country') continue;
+    if (key.startsWith('custom:')) {
+      if (!state.custom[key.slice('custom:'.length)]?.trim()) errors[key] = 'required';
+      continue;
+    }
+    if (CONTRACT_GRID_KEYS.has(key) && !plan.gridFields.includes(key)) continue;
+    if (!has(key)) errors[key] = 'required';
+  }
+  const postal = state.values.postal_code?.trim() ?? '';
+  if (plan.gridFields.includes('postal_code') && postal && !postalCodeMatches(format.zipRegex, postal)) {
+    errors.postal_code = 'invalid';
+  }
+  for (const spec of config.customFields ?? []) {
+    const key = `custom:${spec.key}`;
+    if (errors[key]) continue;
+    const value = state.custom[spec.key]?.trim() ?? '';
+    if (value && !customFieldMatches(spec, value)) errors[key] = 'invalid';
+  }
+  return {
+    errors,
+    complete: Object.keys(errors).length === 0
+  };
+}
+
+/** Compact = city and postal share ONE row (format order within it), state below. */
+export function pairedGridRows(gridFields) {
+  const grid = gridFields.filter(key => key !== 'line1');
+  const pair = grid.filter(key => key !== 'state');
+  const rows = [];
+  if (pair.length > 0) rows.push(pair);
+  if (grid.includes('state')) rows.push(['state']);
+  return rows;
+}
+const TOP_CORNERS = {
+  solo: 'rounded-t-[7px]',
+  first: 'rounded-tl-[7px]',
+  last: 'rounded-tr-[7px]'
+};
+const BOTTOM_CORNERS = {
+  solo: 'rounded-b-[7px]',
+  first: 'rounded-bl-[7px]',
+  last: 'rounded-br-[7px]'
+};
+
+/** Box-shadows follow the element's OWN border-radius, so the compact group's rounded
+ *  container cannot round the focus/invalid rings its cells paint — first- and last-row cells
+ *  carry their corner radii themselves (7px = the container's 8px radius minus its 1px
+ *  border), each cell of a two-column row rounding only its outer corner. Derived from the
+ *  same config + field plan that orders the rows: country formats drop and reorder fields,
+ *  and until the grid reveals the visible group ends at line1. */
+export function compactCellCorners(config, gridFields, visible) {
+  const customRows = position => (config.customFields ?? []).filter(field => field.position === position).map(field => [`custom:${field.key}`]);
+  const rows = [];
+  if (config.name === 'split') rows.push(['first_name', 'last_name']);else if (config.name === 'combined') rows.push(['name']);
+  rows.push(...customRows('after_name'));
+  if (config.organization === 'name_with_type') rows.push(['organization', 'organization_type']);else if (config.organization === 'name') rows.push(['organization']);
+  rows.push(...customRows('after_organization'), ...customRows('before_country'));
+  rows.push(['country']);
+  if (gridFields.includes('line1')) rows.push(['line1']);
+  if (visible.revealed) {
+    if (visible.line2) rows.push(['line2']);
+    rows.push(...pairedGridRows(gridFields), ...customRows('after_address'));
+  }
+  const classes = {};
+  const mark = (row, corner) => {
+    row?.forEach((key, index) => {
+      const cls = row.length === 1 ? corner.solo : index === 0 ? corner.first : corner.last;
+      classes[key] = classes[key] ? `${classes[key]} ${cls}` : cls;
+    });
+  };
+  mark(rows[0], TOP_CORNERS);
+  mark(rows[rows.length - 1], BOTTOM_CORNERS);
+  return classes;
+}
+export function snapshotAddressForm(config, format, state) {
+  const validation = validateAddressForm(config, format, state);
+  const custom = {};
+  for (const spec of config.customFields ?? []) {
+    const value = state.custom[spec.key]?.trim();
+    if (value) custom[spec.key] = value;
+  }
+  // The payload carries only what the CURRENT plan collects — a scope narrowing must not keep
+  // emitting fields the form no longer shows. State retains the values, so widening back
+  // restores them.
+  const planned = new Set(planFields(config, format).gridFields);
+  return {
+    complete: validation.complete,
+    address: emitAddress(format, {
+      name: config.name === 'combined' ? state.values.name : undefined,
+      first_name: config.name === 'split' ? state.values.first_name : undefined,
+      last_name: config.name === 'split' ? state.values.last_name : undefined,
+      organization: config.organization === 'none' ? undefined : state.values.organization,
+      organization_type: config.organization === 'name_with_type' ? state.organizationType : '',
+      line1: planned.has('line1') ? state.values.line1 : undefined,
+      line2: planned.has('line1') && config.line2 !== 'never' ? state.values.line2 : undefined,
+      city: planned.has('city') ? state.values.city : undefined,
+      state: planned.has('state') ? state.values.state : undefined,
+      postal_code: planned.has('postal_code') ? state.values.postal_code : undefined
+    }),
+    custom,
+    errors: validation.errors
+  };
+}
+//# sourceMappingURL=form-state.js.map