@panneau/fields 5.0.0-alpha.15 → 5.0.0-alpha.17

package/dist/address/AddressField.module.js

@@ -0,0 +1,22 @@
+import "./AddressField.css";
+//#region src/address/AddressField.module.css
+var address = "panneau-address-field-address";
+var parts = "panneau-address-field-parts";
+var part = "panneau-address-field-part";
+var country = "panneau-address-field-country";
+var street = "panneau-address-field-street";
+var map = "panneau-address-field-map";
+var remove = "panneau-address-field-remove";
+var AddressField_module_default = {
+	address,
+	parts,
+	part,
+	country,
+	street,
+	map,
+	remove
+};
+//#endregion
+export { address, country, AddressField_module_default as default, map, part, parts, remove, street };
+
+//# sourceMappingURL=AddressField.module.js.map

package/dist/address/AddressField.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddressField.module.js","names":[],"sources":["../../src/address/AddressField.module.css"],"sourcesContent":["/* The search, the parts, then the map. */\n.address {\n    display: flex;\n    flex-direction: column;\n    gap: var(--panneau-space-3);\n}\n\n/* The parts on a grid of six columns: the street and its unit, then the city, the region and the\n   postal code in the order of the country. */\n.parts {\n    display: grid;\n    grid-template-columns: repeat(6, minmax(0, 1fr));\n    gap: var(--panneau-space-3);\n}\n\n.part {\n    grid-column: span 2;\n    min-width: 0;\n}\n\n.country {\n    grid-column: 1 / -1;\n}\n\n.street {\n    grid-column: span 4;\n}\n\n.map {\n    display: flex;\n    flex-direction: column;\n    gap: var(--panneau-space-2);\n}\n\n.remove {\n    align-self: flex-start;\n}\n\n@media (max-width: 40rem) {\n    .part,\n    .street {\n        grid-column: 1 / -1;\n    }\n}\n"],"mappings":""}

package/dist/address/address.d.ts

@@ -0,0 +1,23 @@
+import type { AddressValue } from '@panneau/protocol';
+export type { AddressValue };
+/** Whether a value is an address: an object, whose parts are checked as they are read. */
+export declare function isAddress(value: unknown): value is AddressValue;
+/**
+ * Whether the addresses of a country end with the city, the region and the postal code
+ * (`Montréal QC H2X 1Y4`): those of the countries whose regions Panneau knows, and an address
+ * without a country. Elsewhere, the postal code comes first (`75001 Paris`).
+ */
+export declare function endsWithRegion(country: string | null | undefined): boolean;
+/**
+ * An address without its empty parts, with `country` when it has a part and no country. `null`
+ * when nothing but a country is left.
+ */
+export declare function cleanAddress(address: Partial<Record<keyof AddressValue, unknown>>, country?: string | null): AddressValue | null;
+/**
+ * An address on one line, in the order of its country, without the country:
+ * `1234 Rue Saint-Denis, App. 5, Montréal QC H2X 1Y4`, `12 rue de Rivoli, 75001 Paris`. The
+ * region is its code in Canada and the United States, as on envelopes, and its name in the locale
+ * for the other countries whose regions Panneau knows.
+ */
+export declare function formatAddress(address: AddressValue, locale: string): string;
+//# sourceMappingURL=address.d.ts.map

package/dist/address/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../src/address/address.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKtD,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B,0FAA0F;AAC1F,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE1E;AAOD;;;GAGG;AACH,wBAAgB,YAAY,CACxB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,YAAY,EAAE,OAAO,CAAC,CAAC,EACrD,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,YAAY,GAAG,IAAI,CA0BrB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAkB3E"}

package/dist/address/address.js

@@ -0,0 +1,58 @@
+import { REGION_COUNTRIES, getRegionName } from "../region/regions.js";
+import { ADDRESS_PARTS, normalizePostalCode } from "@panneau/protocol/runtime";
+//#region src/address/address.ts
+/** Whether a value is an address: an object, whose parts are checked as they are read. */
+function isAddress(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/**
+* Whether the addresses of a country end with the city, the region and the postal code
+* (`Montréal QC H2X 1Y4`): those of the countries whose regions Panneau knows, and an address
+* without a country. Elsewhere, the postal code comes first (`75001 Paris`).
+*/
+function endsWithRegion(country) {
+	return country === null || country === void 0 || REGION_COUNTRIES.includes(country);
+}
+/** The text of a part, trimmed, or `undefined` when it is empty or isn't text. */
+function partText(value) {
+	return typeof value === "string" && value.trim() !== "" ? value.trim() : void 0;
+}
+/**
+* An address without its empty parts, with `country` when it has a part and no country. `null`
+* when nothing but a country is left.
+*/
+function cleanAddress(address, country) {
+	const next = {};
+	ADDRESS_PARTS.forEach((part) => {
+		const text = typeof address[part] === "string" ? address[part] : void 0;
+		if (text !== void 0 && text.trim() !== "") next[part] = text;
+	});
+	const point = address.point;
+	if (point !== null && typeof point === "object" && typeof point.lat === "number" && typeof point.lng === "number") next.point = point;
+	if (Object.keys(next).every((part) => part === "country")) return null;
+	if (next.country === void 0 && country !== null && country !== void 0) next.country = country;
+	return next;
+}
+/**
+* An address on one line, in the order of its country, without the country:
+* `1234 Rue Saint-Denis, App. 5, Montréal QC H2X 1Y4`, `12 rue de Rivoli, 75001 Paris`. The
+* region is its code in Canada and the United States, as on envelopes, and its name in the locale
+* for the other countries whose regions Panneau knows.
+*/
+function formatAddress(address, locale) {
+	const country = partText(address.country);
+	const regionCode = partText(address.region);
+	const region = regionCode !== void 0 && country !== "CA" && country !== "US" ? getRegionName(country, regionCode, locale) ?? regionCode : regionCode;
+	const postalCode = partText(address.postalCode) !== void 0 ? normalizePostalCode(address.postalCode ?? "", country) : void 0;
+	const city = partText(address.city);
+	const locality = endsWithRegion(country) ? [city, [region, postalCode].filter(Boolean).join(" ")] : [[postalCode, city].filter(Boolean).join(" "), region];
+	return [
+		partText(address.street),
+		partText(address.unit),
+		...locality
+	].filter((part) => part !== void 0 && part !== "").join(", ");
+}
+//#endregion
+export { cleanAddress, endsWithRegion, formatAddress, isAddress };
+
+//# sourceMappingURL=address.js.map

package/dist/address/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","names":["AddressValue","ADDRESS_PARTS","normalizePostalCode","REGION_COUNTRIES","getRegionName","isAddress","value","Array","isArray","endsWithRegion","country","undefined","includes","partText","trim","cleanAddress","address","Partial","Record","next","forEach","part","text","point","lat","lng","NonNullable","Object","keys","every","formatAddress","locale","regionCode","region","postalCode","city","locality","filter","Boolean","join","street","unit"],"sources":["../../src/address/address.ts"],"sourcesContent":["import type { AddressValue } from '@panneau/protocol';\nimport { ADDRESS_PARTS, normalizePostalCode } from '@panneau/protocol/runtime';\n\nimport { REGION_COUNTRIES, getRegionName } from '../region/regions';\n\nexport type { AddressValue };\n\n/** Whether a value is an address: an object, whose parts are checked as they are read. */\nexport function isAddress(value: unknown): value is AddressValue {\n    return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * Whether the addresses of a country end with the city, the region and the postal code\n * (`Montréal QC H2X 1Y4`): those of the countries whose regions Panneau knows, and an address\n * without a country. Elsewhere, the postal code comes first (`75001 Paris`).\n */\nexport function endsWithRegion(country: string | null | undefined): boolean {\n    return country === null || country === undefined || REGION_COUNTRIES.includes(country);\n}\n\n/** The text of a part, trimmed, or `undefined` when it is empty or isn't text. */\nfunction partText(value: unknown): string | undefined {\n    return typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined;\n}\n\n/**\n * An address without its empty parts, with `country` when it has a part and no country. `null`\n * when nothing but a country is left.\n */\nexport function cleanAddress(\n    address: Partial<Record<keyof AddressValue, unknown>>,\n    country?: string | null,\n): AddressValue | null {\n    const next: AddressValue = {};\n    ADDRESS_PARTS.forEach((part) => {\n        const text = typeof address[part] === 'string' ? (address[part] as string) : undefined;\n        // Spaces typed at the end stay while the part is typed\n        if (text !== undefined && text.trim() !== '') {\n            next[part] = text;\n        }\n    });\n    const point = address.point;\n    if (\n        point !== null &&\n        typeof point === 'object' &&\n        typeof (point as { lat?: unknown }).lat === 'number' &&\n        typeof (point as { lng?: unknown }).lng === 'number'\n    ) {\n        next.point = point as NonNullable<AddressValue['point']>;\n    }\n    // A country alone, picked before the other parts, isn't an address yet\n    if (Object.keys(next).every((part) => part === 'country')) {\n        return null;\n    }\n    if (next.country === undefined && country !== null && country !== undefined) {\n        next.country = country;\n    }\n    return next;\n}\n\n/**\n * An address on one line, in the order of its country, without the country:\n * `1234 Rue Saint-Denis, App. 5, Montréal QC H2X 1Y4`, `12 rue de Rivoli, 75001 Paris`. The\n * region is its code in Canada and the United States, as on envelopes, and its name in the locale\n * for the other countries whose regions Panneau knows.\n */\nexport function formatAddress(address: AddressValue, locale: string): string {\n    const country = partText(address.country);\n    const regionCode = partText(address.region);\n    const region =\n        regionCode !== undefined && country !== 'CA' && country !== 'US'\n            ? (getRegionName(country, regionCode, locale) ?? regionCode)\n            : regionCode;\n    const postalCode =\n        partText(address.postalCode) !== undefined\n            ? normalizePostalCode(address.postalCode ?? '', country)\n            : undefined;\n    const city = partText(address.city);\n    const locality = endsWithRegion(country)\n        ? [city, [region, postalCode].filter(Boolean).join(' ')]\n        : [[postalCode, city].filter(Boolean).join(' '), region];\n    return [partText(address.street), partText(address.unit), ...locality]\n        .filter((part) => part !== undefined && part !== '')\n        .join(', ');\n}\n"],"mappings":";;;;AAQA,SAAgBK,UAAUC,OAAuC;CAC7D,OAAOA,UAAU,QAAQ,OAAOA,UAAU,YAAY,CAACC,MAAMC,QAAQF,KAAK;AAC9E;;;;;;AAOA,SAAgBG,eAAeC,SAA6C;CACxE,OAAOA,YAAY,QAAQA,YAAYC,KAAAA,KAAaR,iBAAiBS,SAASF,OAAO;AACzF;;AAGA,SAASG,SAASP,OAAoC;CAClD,OAAO,OAAOA,UAAU,YAAYA,MAAMQ,KAAK,MAAM,KAAKR,MAAMQ,KAAK,IAAIH,KAAAA;AAC7E;;;;;AAMA,SAAgBI,aACZC,SACAN,SACmB;CACnB,MAAMS,OAAqB,CAAC;CAC5BlB,cAAcmB,SAASC,SAAS;EAC5B,MAAMC,OAAO,OAAON,QAAQK,UAAU,WAAYL,QAAQK,QAAmBV,KAAAA;EAE7E,IAAIW,SAASX,KAAAA,KAAaW,KAAKR,KAAK,MAAM,IACtCK,KAAKE,QAAQC;CAErB,CAAC;CACD,MAAMC,QAAQP,QAAQO;CACtB,IACIA,UAAU,QACV,OAAOA,UAAU,YACjB,OAAQA,MAA4BC,QAAQ,YAC5C,OAAQD,MAA4BE,QAAQ,UAE5CN,KAAKI,QAAQA;CAGjB,IAAII,OAAOC,KAAKT,IAAI,CAAC,CAACU,OAAOR,SAASA,SAAS,SAAS,GACpD,OAAO;CAEX,IAAIF,KAAKT,YAAYC,KAAAA,KAAaD,YAAY,QAAQA,YAAYC,KAAAA,GAC9DQ,KAAKT,UAAUA;CAEnB,OAAOS;AACX;;;;;;;AAQA,SAAgBW,cAAcd,SAAuBe,QAAwB;CACzE,MAAMrB,UAAUG,SAASG,QAAQN,OAAO;CACxC,MAAMsB,aAAanB,SAASG,QAAQiB,MAAM;CAC1C,MAAMA,SACFD,eAAerB,KAAAA,KAAaD,YAAY,QAAQA,YAAY,OACrDN,cAAcM,SAASsB,YAAYD,MAAM,KAAKC,aAC/CA;CACV,MAAME,aACFrB,SAASG,QAAQkB,UAAU,MAAMvB,KAAAA,IAC3BT,oBAAoBc,QAAQkB,cAAc,IAAIxB,OAAO,IACrDC,KAAAA;CACV,MAAMwB,OAAOtB,SAASG,QAAQmB,IAAI;CAClC,MAAMC,WAAW3B,eAAeC,OAAO,IACjC,CAACyB,MAAM,CAACF,QAAQC,UAAU,CAAC,CAACG,OAAOC,OAAO,CAAC,CAACC,KAAK,GAAG,CAAC,IACrD,CAAC,CAACL,YAAYC,IAAI,CAAC,CAACE,OAAOC,OAAO,CAAC,CAACC,KAAK,GAAG,GAAGN,MAAM;CAC3D,OAAO;EAACpB,SAASG,QAAQwB,MAAM;EAAG3B,SAASG,QAAQyB,IAAI;EAAG,GAAGL;CAAQ,CAAC,CACjEC,QAAQhB,SAASA,SAASV,KAAAA,KAAaU,SAAS,EAAE,CAAC,CACnDkB,KAAK,IAAI;AAClB"}

package/dist/address/index.d.ts

@@ -0,0 +1,3 @@
+export { AddressField, AddressFieldEntry, type AddressFieldProps } from './AddressField.js';
+export { type AddressValue, cleanAddress, endsWithRegion, formatAddress, isAddress, } from './address.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/address/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/address/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,EACH,KAAK,YAAY,EACjB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,SAAS,GACZ,MAAM,WAAW,CAAC"}

package/dist/address/index.js

@@ -0,0 +1,3 @@
+import { cleanAddress, endsWithRegion, formatAddress, isAddress } from "./address.js";
+import { AddressField, AddressFieldEntry } from "./AddressField.js";
+export { AddressField, AddressFieldEntry, cleanAddress, endsWithRegion, formatAddress, isAddress };

package/dist/color/ColorField.css

@@ -31,3 +31,12 @@
 .panneau-color-field-input {
     font-family: var(--panneau-font-family-mono);
 }
+
+.panneau-color-field-palette-swatch {
+    display: inline-block;
+    width: 1rem;
+    height: 1rem;
+    vertical-align: middle;
+    border: var(--panneau-border-width) solid var(--panneau-color-border-control);
+    border-radius: var(--panneau-radius-sm);
+}

package/dist/color/ColorField.d.ts

@@ -1,6 +1,13 @@
 import type { FieldEntryProps } from '../shared/types.js';
 import { type TextFieldProps } from '../text/TextField.js';
-export type ColorFieldProps = Omit<TextFieldProps, 'type' | 'prefix' | 'maxLength'>;
+import { type ColorPaletteEntry } from './palette.js';
+export interface ColorFieldProps extends Omit<TextFieldProps, 'type' | 'prefix' | 'maxLength'> {
+    /**
+     * The colors to pick from (decision 0058). With a palette, the field only offers its colors,
+     * and the value is the `value` of one of them.
+     */
+    palette?: readonly ColorPaletteEntry[] | null;
+}
 /**
  * Normalizes a hexadecimal color: `#` prefix, lowercase, and 3 digits expanded to 6. Returns the
  * text as is when it isn't a hexadecimal color.
@@ -10,7 +17,7 @@ export declare function normalizeColor(value: string): string;
  * A color as a hexadecimal value (`#1d4ed8`): typed, or picked with the browser's color picker.
  * The value is normalized on blur.
  */
-export declare function ColorField({ value, onChange, onBlur, disabled, readOnly, inputClassName, ...props }: ColorFieldProps): import("react").JSX.Element;
-/** The `color` type. */
+export declare function ColorField({ value, onChange, onBlur, disabled, readOnly, inputClassName, palette, ...props }: ColorFieldProps): import("react").JSX.Element;
+/** The `color` type: `settings.palette`, the colors to pick from. */
 export declare function ColorFieldEntry(props: FieldEntryProps): import("react").JSX.Element;
 //# sourceMappingURL=ColorField.d.ts.map

package/dist/color/ColorField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ColorField.d.ts","sourceRoot":"","sources":["../../src/color/ColorField.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC,CAAC;AAEpF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUpD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EACvB,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,GAAG,KAAK,EACX,EAAE,eAAe,+BAsCjB;AAED,wBAAwB;AACxB,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,+BAQrD"}
+{"version":3,"file":"ColorField.d.ts","sourceRoot":"","sources":["../../src/color/ColorField.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAE,KAAK,iBAAiB,EAAmC,MAAM,WAAW,CAAC;AAEpF,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC1F;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,iBAAiB,EAAE,GAAG,IAAI,CAAC;CACjD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUpD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EACvB,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,OAAO,EACP,GAAG,KAAK,EACX,EAAE,eAAe,+BAmDjB;AA4ED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,+BAUrD"}