@stachelock/ui 0.5.5 → 0.6.2

package/dist/src/types/address.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Address Input Types
+ * Types for the AddressInput component and geocoding service
+ */
+/// <reference types="@types/google.maps" />
+/**
+ * Configuration options for the geocoding service
+ * Passed via StachelockUI plugin or configureGeocoding()
+ */
+export interface GeocodingConfig {
+    /** Google Maps API key (required) */
+    apiKey: string;
+    /** Optional separate API key for Static Maps (thumbnails) */
+    staticMapsApiKey?: string;
+    /** API version (default: 'weekly') */
+    version?: string;
+    /** Libraries to load (default: ['places', 'maps', 'geometry']) */
+    libraries?: ('places' | 'geometry' | 'drawing' | 'visualization' | 'maps')[];
+}
+/**
+ * Result from geocoding operation
+ */
+export interface GeocodeResult {
+    /** Status of the geocode operation ('OK', 'INVALID_INPUT', 'ERROR', etc.) */
+    status: string;
+    /** Human-readable message about the result */
+    message?: string;
+    /** Address components from Google Geocoder */
+    address_components?: google.maps.GeocoderAddressComponent[];
+    /** Lat/lng coordinates */
+    location?: {
+        lat: number;
+        lng: number;
+    };
+    /** Formatted address string from Google */
+    formatted_address?: string;
+    /** Static map thumbnail URL */
+    thumbnailUrl?: string;
+}
+/**
+ * Status enum for geocode operations
+ */
+export declare enum GeocodeStatus {
+    /** Geocode result is verified/valid */
+    Verified = "verified",
+    /** Geocode operation resulted in error */
+    Error = "error",
+    /** Address has not been geocoded yet */
+    Unverified = "unverified",
+    /** Geocode operation is pending */
+    Pending = "pending"
+}
+/**
+ * Place suggestion from Google Places Autocomplete
+ */
+export interface PlaceSuggestion {
+    /** Google Place ID for geocoding */
+    placeId: string;
+    /** Full description of the place */
+    description: string;
+    /** Main text (usually street address or place name) */
+    mainText: string;
+    /** Secondary text (usually city, state, country) */
+    secondaryText: string;
+    /** Place types (e.g., 'street_address', 'establishment') */
+    types: string[];
+}
+/**
+ * Parsed address fields for display and editing
+ */
+export interface AddressFields {
+    /** Street address (number + street name) */
+    street: string;
+    /** Suite/apartment/unit number */
+    suite: string;
+    /** City */
+    city: string;
+    /** State/province (short code) */
+    state: string;
+    /** Postal/ZIP code */
+    zipcode: string;
+    /** Country (short code) */
+    country: string;
+}
+/**
+ * Complete address value emitted by AddressInput
+ * This is the main output type of the component
+ */
+export interface AddressValue {
+    /** Formatted address string for display */
+    formattedAddress?: string;
+    /** Street address (number + street name) */
+    street?: string;
+    /** Suite/apartment/unit number */
+    suite?: string;
+    /** City */
+    city?: string;
+    /** State/province (short code) */
+    state?: string;
+    /** Postal/ZIP code */
+    zipcode?: string;
+    /** Country (short code) */
+    country?: string;
+    /** Full geocode result with coordinates and address components */
+    geocode?: GeocodeResult;
+    /** Original Google Place ID (if selected from autocomplete) */
+    placeId?: string;
+}
+/**
+ * Props for the AddressInput component
+ */
+export interface AddressInputProps {
+    /** Field name for form validation */
+    name: string;
+    /** Model value (v-model) */
+    modelValue?: AddressValue;
+    /** Field label */
+    label?: string;
+    /** Placeholder text for search input */
+    placeholder?: string;
+    /** Validation rules (yup schema) */
+    rules?: unknown;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Show suggestion count in header */
+    showSuggestionCount?: boolean;
+    /** Allow manual entry without autocomplete */
+    allowManualEntry?: boolean;
+    /** Success message to show when valid */
+    successMessage?: string;
+    /** Tertiary label (top right) */
+    tertiaryLabel?: string;
+    /** Validate on component mount */
+    validateOnMount?: boolean;
+}
+/**
+ * Emits for the AddressInput component
+ */
+export interface AddressInputEmits {
+    /** Emitted when address value changes */
+    'update:modelValue': [value: AddressValue];
+    /** Emitted when field loses focus */
+    blur: [event: FocusEvent];
+    /** Emitted when field gains focus */
+    focus: [event: FocusEvent];
+}
+/**
+ * Internal geocode status tracking
+ */
+export interface GeocodeStatusState {
+    /** Current geocode status */
+    status: GeocodeStatus;
+    /** Last geocode result */
+    result: GeocodeResult | null;
+}
+/**
+ * Fields that trigger re-geocoding when changed
+ * Suite/apt does NOT trigger re-geocoding
+ */
+export type FundamentalAddressField = 'street' | 'city' | 'state' | 'zipcode' | 'country';
+/**
+ * Check if a field is a fundamental field that requires re-geocoding
+ */
+export declare function isFundamentalField(field: string): field is FundamentalAddressField;

package/dist/src/types/collection-editor.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Collection Editor Types
+ *
+ * Generic types for collection-based editors (organizations, related names, etc.)
+ */
+/**
+ * Status enum for collection items
+ */
+export declare enum CollectionItemStatus {
+    New = "new",
+    Pending = "pending",
+    Saved = "saved",
+    Deleted = "deleted"
+}
+/**
+ * Base interface for collection items
+ */
+export interface CollectionItem {
+    id: string;
+    status?: CollectionItemStatus;
+    [key: string]: unknown;
+}
+/**
+ * List item for autocomplete/combobox fields
+ */
+export interface ListItem {
+    id: string;
+    name: string;
+    aliases?: string[];
+    approved?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Organization collection item
+ */
+export interface OrganizationCollectionItem extends CollectionItem {
+    organization: string | ListItem | null;
+    position: string | ListItem | null;
+    position_prefix?: string | null;
+    position_suffix?: string | null;
+    start_date?: Date | string | null;
+    end_date?: Date | string | null;
+}
+/**
+ * Related name collection item
+ */
+export interface RelatedNameCollectionItem extends CollectionItem {
+    name?: string;
+    first_name?: string;
+    last_name?: string;
+    label?: string | ListItem | null;
+    birthday?: Date | string | null;
+    relationship?: string;
+}
+/**
+ * Social link collection item
+ */
+export interface SocialLinkCollectionItem extends CollectionItem {
+    platform: string;
+    handle?: string;
+    url?: string;
+}
+/**
+ * Form field definition for dynamic forms
+ */
+export interface CollectionFormField {
+    name: string;
+    label: string;
+    as: string;
+    type?: string;
+    rules?: unknown;
+    items?: ListItem[];
+    itemKey?: string;
+    itemText?: string;
+    placeholder?: string;
+    hideLabel?: boolean;
+    innerLabel?: string;
+    tertiaryLabel?: string;
+    [key: string]: unknown;
+}
+/**
+ * Schema definition for collection forms
+ */
+export interface CollectionFormSchema {
+    fields: CollectionFormField[];
+}
+/**
+ * Button attributes for add/delete button group
+ */
+export interface CollectionButtonAttributes {
+    add: {
+        disabled: boolean;
+        label?: string;
+    };
+    save: {
+        disabled: boolean;
+        label?: string;
+    };
+    delete: {
+        disabled: boolean;
+        label?: string;
+    };
+}
+/**
+ * Props for CollectionEditor component
+ */
+export interface CollectionEditorProps<T extends CollectionItem> {
+    /** Field name for form binding */
+    name: string;
+    /** Display label */
+    label?: string;
+    /** Current value (array of items) */
+    modelValue?: T[];
+    /** Form schema for editing items */
+    schema: CollectionFormSchema;
+    /** Empty form values for new items */
+    emptyFormValues: T;
+    /** List display component */
+    listComponent?: unknown;
+    /** Transform item for display */
+    displayTransform?: (item: T) => T;
+    /** Transform item for storage */
+    storageTransform?: (item: T) => T;
+}
+/**
+ * Emits for CollectionEditor component
+ */
+export interface CollectionEditorEmits<T extends CollectionItem> {
+    'update:modelValue': [value: T[]];
+    'item-added': [item: T];
+    'item-updated': [item: T];
+    'item-deleted': [item: T];
+    'item-selected': [item: T | null];
+}

package/dist/src/types/index.d.ts

@@ -1,6 +1,8 @@
+export * from './address';
 export * from './avatars';
 export * from './badges';
 export * from './calendars';
+export * from './collection-editor';
 export * from './core';
 export * from './form';
 export * from './forms';
@@ -9,6 +11,7 @@ export * from './layouts';
 export * from './loading';
 export * from './maps';
 export * from './navigation';
+export * from './profiles';
 export * from './tables';
 export * from './tabs';
 export * from './transitions';

package/dist/src/types/profiles.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Profile component types
+ *
+ * Types for the Bento-style profile layout components
+ */
+/**
+ * Profile image/avatar information
+ */
+export interface ProfileImage {
+    url?: string;
+    public_id?: string;
+    secure_url?: string;
+    [key: string]: unknown;
+}
+/**
+ * Professional information
+ */
+export interface ProfessionalInfo {
+    title?: string;
+    company?: string;
+    department?: string;
+    linkedin?: string;
+    [key: string]: unknown;
+}
+/**
+ * Address information
+ */
+export interface AddressInfo {
+    name?: string;
+    description?: string;
+    street?: string;
+    suite?: string;
+    city?: string;
+    state?: string;
+    zip?: string;
+    country?: string;
+    geocode?: {
+        location?: {
+            lat: number;
+            lng: number;
+        };
+        formatted_address?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Social link item
+ */
+export interface SocialLinkItem {
+    id?: string;
+    platform: string;
+    handle?: string;
+    url?: string;
+    [key: string]: unknown;
+}
+/**
+ * Organization/position item
+ */
+export interface OrganizationItem {
+    id?: string;
+    organization?: string | {
+        name: string;
+        id?: string;
+    };
+    position?: string | {
+        name: string;
+        id?: string;
+    };
+    position_prefix?: string;
+    position_suffix?: string;
+    start_date?: Date | string | null;
+    end_date?: Date | string | null;
+    status?: string;
+    [key: string]: unknown;
+}
+/**
+ * Related name item
+ */
+export interface RelatedNameItem {
+    id?: string;
+    name?: string;
+    first_name?: string;
+    last_name?: string;
+    label?: string | {
+        name: string;
+        id?: string;
+    };
+    birthday?: Date | string | null;
+    relationship?: string;
+    [key: string]: unknown;
+}
+/**
+ * Profile data object
+ * Flexible structure to accommodate different data sources
+ */
+export interface ProfileData {
+    id?: string;
+    uid?: string;
+    name?: string;
+    first_name?: string;
+    last_name?: string;
+    nickname?: string;
+    prefix?: string;
+    suffix?: string;
+    email?: string;
+    phone?: string;
+    website?: string;
+    birthday?: Date | string | null;
+    profile_image?: ProfileImage | string;
+    image?: string;
+    professional?: ProfessionalInfo;
+    address?: AddressInfo | AddressInfo[];
+    latLng?: {
+        lat: number;
+        lng: number;
+    };
+    _geoloc?: {
+        lat: number;
+        lng: number;
+    };
+    social?: SocialLinkItem[];
+    organizations?: OrganizationItem[];
+    relatedNames?: RelatedNameItem[];
+    related_names?: RelatedNameItem[];
+    status?: 'active' | 'inactive' | string;
+    [key: string]: unknown;
+}
+/**
+ * Profile preview configuration
+ */
+export interface ProfilePreviewConfig {
+    showContact?: boolean;
+    showLocation?: boolean;
+    showProfessional?: boolean;
+    showPersonal?: boolean;
+    showOrganizations?: boolean;
+    showRelatedNames?: boolean;
+    showSocial?: boolean;
+    animationEnabled?: boolean;
+    animationDelay?: number;
+}
+/**
+ * Props for BentoProfileLayout
+ */
+export interface BentoProfileLayoutProps {
+    profile: ProfileData;
+    config?: ProfilePreviewConfig;
+}

package/dist/src/views/inputs/index.d.ts

@@ -1,3 +1,4 @@
+export { default as AddressPage } from './AddressPage';
 export { default as CheckboxPage } from './CheckboxPage';
 export { default as ComboboxPage } from './ComboboxPage';
 export { default as DatepickerPage } from './DatepickerPage';

package/dist/stepper/StepperPanels.js

@@ -1,5 +1,4 @@
-import { _ as f } from "../StepperPanels.vue_vue_type_script_setup_true_lang-D6Fv7iz3.js";
+import { _ as f } from "../StepperPanels.vue_vue_type_script_setup_true_lang-DPLQ9mQn.js";
 export {
   f as default
 };
-//# sourceMappingURL=StepperPanels.js.map

package/dist/stepper/index.js

@@ -1,5 +1,4 @@
-import { _ as r } from "../StepperPanels.vue_vue_type_script_setup_true_lang-D6Fv7iz3.js";
+import { _ as r } from "../StepperPanels.vue_vue_type_script_setup_true_lang-DPLQ9mQn.js";
 export {
   r as StepperPanels
 };
-//# sourceMappingURL=index.js.map