sera-components 1.8.2 → 1.8.4

package/dist/form/composite-items/address-form-item/address-form-field.d.ts

@@ -0,0 +1,13 @@
+import { Table, DraftRecord, GenericRecord } from 'sera-db';
+import { Country, AdminLevel1, AdminLevel2, AddressProperties } from './types';
+export interface AddressFormItemProps<ID extends string | number, R extends GenericRecord<ID, DR>, DR extends DraftRecord<ID>> {
+    store: Table<ID, R, DR>;
+    record: R | DR;
+    properties: AddressProperties;
+    countries: Record<string | number, Country>;
+    getAdminLevel1sByCountry: (countryId: string | number) => Promise<AdminLevel1[]>;
+    searchAdminLevel2?: (query: string, countryId: string | number, admin1Id?: string | number) => Promise<AdminLevel2[]>;
+}
+export declare const AddressFormItem: (<ID extends string | number, R extends GenericRecord<ID, DR>, DR extends DraftRecord<ID>>({ store, record, properties, getAdminLevel1sByCountry, countries, }: AddressFormItemProps<ID, R, DR>) => import("react/jsx-runtime").JSX.Element) & {
+    displayName: string;
+};

package/dist/form/composite-items/address-form-item/index.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { Table, DraftRecord, GenericRecord } from 'sera-db';
+import { AddressFormItemProps } from './address-form-field';
+export declare function makeAddressFormItem<ID extends string | number, R extends GenericRecord<ID, DR>, DR extends DraftRecord<ID>>({ properties, countries, getAdminLevel1sByCountry, searchAdminLevel2, }: Omit<AddressFormItemProps<ID, R, DR>, "store" | "record">): (store: Table<ID, R, DR>, record: R | DR) => React.ReactNode;

package/dist/form/composite-items/address-form-item/select-input.d.ts

@@ -0,0 +1,16 @@
+import { InputInterface } from '../../../data/inputs';
+import { MultiLingualString as MLS } from 'sera-db';
+export interface SelectInputContextProps<T extends {
+    id: string | number;
+    name: string;
+}> {
+    /** Fetches available options asynchronously */
+    fetchOptions: () => Promise<T[]>;
+    /** Custom placeholder */
+    placeholder?: MLS;
+}
+export declare const SelectInputContext: import('react').Context<SelectInputContextProps<any>>;
+export declare function SelectInputComponent<T extends {
+    id: string | number;
+    name: string;
+}>({ value, onChange, freeze }: InputInterface<string | number | undefined>): import("react/jsx-runtime").JSX.Element;

package/dist/form/composite-items/address-form-item/types.d.ts

@@ -0,0 +1,137 @@
+import { MultiLingualString as MLS, NestedProperty, DataProperty, ObjectProperty } from 'sera-db';
+export type ID = string | number;
+export interface AddressProperties {
+    country: NestedProperty | DataProperty | ObjectProperty;
+    administrativeAreaLevel1: NestedProperty | DataProperty | ObjectProperty;
+    administrativeAreaLevel2?: NestedProperty | DataProperty | ObjectProperty;
+    administrativeAreaLevel3?: NestedProperty | DataProperty | ObjectProperty;
+    streetAddress: NestedProperty | DataProperty | ObjectProperty;
+    streetAddressLine2?: NestedProperty | DataProperty | ObjectProperty;
+    postalCode?: NestedProperty | DataProperty | ObjectProperty;
+}
+/**
+ * CountryAddressFormat enum defines which address fields to hide.
+ *
+ * Each format hides specific fields while showing all others:
+ * - NoPostalCode: Hide postal code (e.g., Vietnam)
+ * - NoAdminLevel2: Hide district/county level (e.g., US)
+ * - NoAdminLevel3: Hide ward/township level (most countries)
+ * - NoStreetLine2: Hide address line 2
+ * - NoPreference: Show all fields
+ */
+export declare enum AddressInputPreference {
+    NoPostalCode = "NoPostalCode",
+    NoAdminLevel2 = "NoAdminLevel2",
+    NoAdminLevel3 = "NoAdminLevel3",
+    NoStreetAddressLine2 = "NoStreetAddressLine2",
+    NoPreference = "NoPreference"
+}
+export interface CountryAddressConfig {
+    displayAdmin2: boolean;
+    displayAdmin3: boolean;
+    displayPostalCode: boolean;
+    displayStreetLine2: boolean;
+}
+/**
+ * Map CountryAddressFormat enum to CountryAddressConfig.
+ * Each entry defines visibility of all address fields for that format.
+ */
+export declare const ADDRESS_FORMAT_CONFIG: {
+    NoPostalCode: {
+        displayAdmin2: boolean;
+        displayAdmin3: boolean;
+        displayPostalCode: boolean;
+        displayStreetLine2: boolean;
+    };
+    NoAdminLevel2: {
+        displayAdmin2: boolean;
+        displayAdmin3: boolean;
+        displayPostalCode: boolean;
+        displayStreetLine2: boolean;
+    };
+    NoAdminLevel3: {
+        displayAdmin2: boolean;
+        displayAdmin3: boolean;
+        displayPostalCode: boolean;
+        displayStreetLine2: boolean;
+    };
+    NoStreetAddressLine2: {
+        displayAdmin2: boolean;
+        displayAdmin3: boolean;
+        displayPostalCode: boolean;
+        displayStreetLine2: boolean;
+    };
+    NoPreference: {
+        displayAdmin2: boolean;
+        displayAdmin3: boolean;
+        displayPostalCode: boolean;
+        displayStreetLine2: boolean;
+    };
+};
+export interface Country {
+    id: ID;
+    name: string;
+    addressInputPreference: AddressInputPreference;
+}
+export interface AdminLevel1 {
+    id: ID;
+    name: string;
+}
+export interface AdminLevel2 {
+    id: ID;
+    name: string;
+    countryId: ID;
+    adminLevel1Id: ID;
+}
+export declare const AddressFormLabels: {
+    country: {
+        lang: string;
+        lang2value: {
+            en: string;
+            vi: string;
+        };
+    };
+    adminLevel1: {
+        lang: string;
+        lang2value: {
+            en: string;
+            vi: string;
+        };
+    };
+    adminLevel2: {
+        lang: string;
+        lang2value: {
+            en: string;
+            vi: string;
+        };
+    };
+    adminLevel3: {
+        lang: string;
+        lang2value: {
+            en: string;
+            vi: string;
+        };
+    };
+    streetAddress: {
+        lang: string;
+        lang2value: {
+            en: string;
+            vi: string;
+        };
+    };
+    streetAddressLine2: {
+        lang: string;
+        lang2value: {
+            en: string;
+            vi: string;
+        };
+    };
+    postalCode: {
+        lang: string;
+        lang2value: {
+            en: string;
+            vi: string;
+        };
+    };
+};
+export declare const AddressPlaceholders: Record<string, MLS>;

package/dist/form/index.d.ts

@@ -3,3 +3,4 @@ export * from './form-item';
 export * from './form-item-label';
 export * from './embedded-form';
 export * from './embedded-form-item';
+export * from './composite-items/address-form-item';