atriusmaps-node-sdk 3.3.1056 → 3.3.1058

package/dist/types/src/ui/icons/utils.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Calculate icon dimensions from iconSize prop
+ * @param {string|number} iconSize - Size value (sm|md|lg|xl|xxl or numeric)
+ * @param {object} theme - Theme context with iconSizes
+ * @returns {string|number} Resolved dimension value
+ */
+export declare const getIconDimensions: (iconSize: string | number | undefined, theme: Record<string, any>) => any;
+/**
+ * Generate transform CSS for rotation and flip
+ * Use with styled-components: ${getTransformCSS}
+ */
+export declare const getTransformCSS: import("styled-components").RuleSet<NoInfer<{
+    $degreesOfIconRotation?: number;
+    $flipOnXAxis?: boolean;
+}>>;
+/**
+ * Generate common CSS for fill color and shadow
+ * Use with styled-components: ${getCommonCSS}
+ */
+export declare const getCommonCSS: import("styled-components").RuleSet<NoInfer<{
+    $fillColor?: string;
+    $shadowed?: boolean;
+}>>;
+/**
+ * Normalize dimension value to CSS-compatible string
+ * @param {string|number} value - Dimension value
+ * @returns {string} CSS dimension string
+ */
+export declare const normalizeDimension: (value: string | number | undefined) => string;
+/**
+ * Set fill attribute to currentColor on an SVG element
+ * @param {Element} el - SVG element
+ */
+export declare const setFillToCurrentColor: (el: Element | null | undefined) => void | undefined;
+/**
+ * Remove fill attribute from element and all children
+ * @param {Element} svg - SVG element
+ */
+export declare const removeFillFromSvg: (svg: Element | null | undefined) => void;
+/**
+ * Apply coloring logic to SVG based on icon type
+ * @param {Element} svg - SVG element
+ * @param {boolean} isIconColored - Whether icon is a .color icon
+ * @param {boolean} removeFill - Whether to remove fills
+ */
+export declare const applyIconColoring: (svg: Element | null | undefined, isIconColored: boolean | undefined, removeFill: boolean | undefined) => void;
+/**
+ * Apply accessibility attributes to SVG
+ * @param {Element} svg - SVG element
+ * @param {string} title - Accessible title/label
+ */
+export declare const applyA11yAttributes: (svg: Element, title: string | undefined) => void;
+/**
+ * Build accessibility attributes for icons
+ * @param {object} params
+ * @param {string} params.title - Accessible title
+ * @param {string} params.ariaLabel - Accessible label
+ * @param {string} params.role - Role override
+ * @returns {{ role: string, ariaLabel: (string|undefined), ariaHidden: (string|undefined), title: (string|undefined) }}
+ */
+export declare const getIconA11y: ({ title, ariaLabel, role }: {
+    title?: string;
+    ariaLabel?: string;
+    role?: string;
+}) => {
+    role: string;
+    'aria-label': string | undefined;
+    title: string | undefined;
+};
+/**
+ * Calculate final container dimensions based on props and theme
+ * @param {object} params
+ * @param {string|number} params.width - Explicit width prop
+ * @param {string|number} params.height - Explicit height prop
+ * @param {string|number} params.size - Size prop
+ * @param {string|number} params.iconSize - Icon size category
+ * @param {object} params.theme - Theme object
+ * @returns {object} { width, height }
+ */
+export declare const calculateContainerDimensions: ({ width, height, size, iconSize, theme, }: {
+    width?: string | number;
+    height?: string | number;
+    size?: string | number;
+    iconSize?: string | number;
+    theme: Record<string, any>;
+}) => {
+    width: any;
+    height: any;
+};
+/**
+ * Configure SVG element attributes before injection
+ * @param {Element} svg - SVG element
+ * @param {object} config
+ * @param {string} config.width - CSS width
+ * @param {string} config.height - CSS height
+ * @param {string} config.viewBox - Custom viewBox
+ * @param {string} config.title - A11y title
+ * @param {boolean} config.isIconColored - Is colored icon
+ * @param {boolean} config.removeFill - Remove fill flag
+ */
+export declare const configureSvg: (svg: Element, { width, height, viewBox, title, isIconColored, removeFill, role, }: {
+    width?: string;
+    height?: string;
+    viewBox?: string;
+    title?: string;
+    isIconColored?: boolean;
+    removeFill?: boolean;
+    role?: string;
+}) => void;

package/dist/types/src/ui/tageditorStyle.d.ts

@@ -0,0 +1,2 @@
+declare const tageditorStyle: import("styled-components").RuleSet<object>;
+export default tageditorStyle;

package/dist/types/src/ui/tooltip/Tooltip.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+type ArrowPosition = 'bottom' | 'left' | 'right' | 'top' | 'topright' | 'bottom-topright';
+type TooltipProps = {
+    arrowPosition?: ArrowPosition;
+    avoidCover?: boolean;
+    cancelTooltip?: boolean;
+    children: React.ReactNode;
+    className?: string;
+    dataTestId?: string;
+    gutter?: number;
+    isVisible?: boolean;
+    placement?: string;
+    text?: string;
+};
+declare const Tooltip: ({ className, text, arrowPosition, children, isVisible, dataTestId, cancelTooltip, avoidCover, }: TooltipProps) => string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
+export default Tooltip;

package/dist/types/src/ui/tooltip/TooltipAnchor.d.ts

@@ -0,0 +1,8 @@
+type TooltipAnchorProps = {
+    arrowPosition?: 'bottom' | 'left' | 'right' | 'top' | 'topright' | 'bottom-topright';
+    className?: string;
+    id: string;
+    text?: string;
+};
+declare const TooltipAnchor: ({ id, text, arrowPosition }: TooltipAnchorProps) => import("react/jsx-runtime").JSX.Element;
+export default TooltipAnchor;

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

@@ -0,0 +1,3 @@
+export { default as TooltipAnchor } from './TooltipAnchor.tsx';
+export { default as Tooltip } from './Tooltip.tsx';
+export { default } from './Tooltip.tsx';

package/dist/types/src/utils/configUtils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Follows a localization scheme of checking for named values with locales appended,
+ * and checking more generally if values not found.
+ *
+ * For example, calling getLocalized("foo", "es-MX", "bar") would check the following keys in this order:
+ *  "foo-es-MX"
+ *  "foo-es"
+ *  "foo"
+ *
+ * As soon as a value is found, it is returned, else the checks continue. If no value is found from any of these,
+ * the def value is returned. (If def is undefined, the undefined is returned)
+ *
+ * @param  {object} config the configuration to inspect
+ * @param  {string} name root key name to look up
+ * @param  {string} lang language code
+ * @param  {any} def default value to return if no value is found through localized checks
+ */
+export declare function getLocalized(config: any, name: string, lang: string | null, def: any): any;
+/**
+ * iterate over the values of an object allowing
+ * self-referencing via >> prefix.
+ *
+ * i.e. resolveSelfRef({ a: 1, b: '>>a'}) = { a: 1, b: 1}
+ * @param {Object} ob Object whose properies may self-reference
+ */
+export declare function resolveSelfRef(ob: any): any;
+/**
+ * Determines whether the map surround (WorldView) feature is enabled for a
+ * given surroundConfig.
+ *
+ * @param {object|null|undefined} surroundConfig the mapRenderer surroundConfig, or falsy if absent
+ */
+export declare function isSurroundEnabled(surroundConfig: any): boolean;
+export declare function debugIsTrue(app: any, key: string): boolean;

package/dist/types/src/utils/dom.d.ts

@@ -0,0 +1,10 @@
+declare const isDOMNode: (o: any) => any;
+declare const $: (expr: any, container?: any) => any;
+declare const $$: (expr: any, container?: any) => any[];
+declare function ad(eConf?: any, parent?: any): HTMLElement;
+declare const del: (element: any) => any;
+declare const setStyles: (node: any, styles: any) => void;
+declare const isAppleMobile: () => boolean | 0;
+declare const isRtl: () => boolean;
+declare const rgba: (hex: string, alpha: string | number) => string;
+export { $, $$, ad, del, isAppleMobile, isDOMNode, isRtl, rgba, setStyles };

package/dist/types/src/utils/funcs.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Limit the calls to specified function to 1 per timeslice.
+ * i.e.  If x = 100ms, n = event, and this is called with 500ms
+ *  xx1x2x3xx4xxx  - calls made
+ *  xx1xxxx3xxxx4  - calls occured
+ * Note: That last 4 call will not happen if you indicate noTailCall = true
+ * @param  {function} fn The function to throttle
+ * @param  {integer} ms The size of the timeslice (in milliseconds) (-1 indicates no throttling)
+ * @param  {boolean} noTailCall If true, final call will be suppressed
+ */
+declare function throttle(fn: any, ms?: number, noTailCall?: boolean): (...args: any[]) => void;
+declare const singleFile: (fn: any) => (...args: any[]) => any;
+declare const changeTest: (val: any) => (val: any) => boolean;
+declare const delay: (ms: number) => any;
+declare const changeTestForArray: (initialArray?: any[]) => (currentArray: any[]) => boolean;
+declare function changeTestObject(initialObject?: Record<string, any>): (valueOb: Record<string, any>) => boolean;
+declare const calcOnce: (fn: any) => (arg?: any) => any;
+declare const runOnce: (fn: any) => (arg?: any) => any;
+declare const replaceablePromise: (sourceVal?: any) => {
+    replace: (this: any, newVal: any) => any;
+    valueProm: () => any;
+};
+/**
+ * returns a copy of an object with any (top-level) properties that do not
+ * return truthy from the specified function stripped. So it works just like
+ * the Array.filter, but for objects.
+ * @param  {function} fn A filter predicate - will be passed (key,object)
+ * @param  {object} ob The object to filter (top level properties only)
+ * @returns (object) The newly created object with filtered properties
+ */
+declare function filterOb(fn: any, ob: any): Record<string, any>;
+declare function shallowEqual(a: any, b: any): any;
+declare const b64EncodeUnicode: (str: string) => string;
+declare const b64DecodeUnicode: (str: string) => string;
+declare function dupCheck(ar: any[]): void;
+export { b64DecodeUnicode, b64EncodeUnicode, calcOnce, changeTest, changeTestForArray, changeTestObject, delay, dupCheck, filterOb, replaceablePromise, runOnce, shallowEqual, singleFile, throttle, };

package/dist/types/src/utils/i18n.d.ts

@@ -0,0 +1,3 @@
+import type { i18n as I18n } from 'i18next';
+export default function init(langOverride: string, { debugMode, fallbackLng }?: any): Promise<I18n>;
+export declare const toLang: (str: string, lang: string) => string;

package/dist/types/src/utils/isInitialState.d.ts

@@ -0,0 +1,6 @@
+declare function startInitialStateListener(): void;
+declare function addInitialStateCallback(cb: any): void;
+declare function removeInitialStateCallback(cb: any): void;
+declare function isInitialState(): boolean;
+declare function overrideInitialStateForTests(value: boolean): void;
+export { startInitialStateListener, overrideInitialStateForTests, addInitialStateCallback, removeInitialStateCallback, isInitialState, };

package/dist/types/src/utils/mapElement.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Centralized utility for accessing the SDK's root container element (.atrius-map)
+ * and computing container-relative dimensions/coordinates.
+ *
+ * Use these helpers instead of window.innerWidth / window.innerHeight so that
+ * the SDK works correctly when embedded without an iframe.
+ */
+/**
+ * Returns the SDK root container element (.atrius-map).
+ * Caches the result after the first successful lookup.
+ * @returns {HTMLElement|null}
+ */
+export declare const getMapElement: () => Element | null;
+/**
+ * Returns the bounding rect of the SDK container, or a window-sized fallback.
+ * The returned object has: width, height, top, left, right, bottom.
+ * @returns {{ width: number, height: number, top: number, left: number, right: number, bottom: number }}
+ */
+export declare const getContainerRect: () => DOMRect | {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+};
+/**
+ * Returns the width of the SDK container (falls back to window.innerWidth).
+ * Uses clientWidth for consistency with original implementations.
+ * @returns {number}
+ */
+export declare const getContainerWidth: () => number;
+/**
+ * Returns the height of the SDK container (falls back to window.innerHeight).
+ * Uses clientHeight for consistency with original implementations.
+ * @returns {number}
+ */
+export declare const getContainerHeight: () => number;
+/**
+ * Converts a viewport-relative DOMRect (from getBoundingClientRect()) to
+ * coordinates relative to the SDK container.
+ * @param {DOMRect} rect - Result of element.getBoundingClientRect()
+ * @returns {{ top: number, left: number, right: number, bottom: number, width: number, height: number }}
+ */
+export declare const toContainerCoords: (rect: DOMRect) => {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+};
+/** @internal — exposed for testing only */
+export declare const _resetCache: () => void;

package/dist/types/src/utils/modDefaultTheme.d.ts

@@ -0,0 +1,164 @@
+import '@csstools/normalize.css';
+declare const theme: {
+    colors: {
+        primary: string;
+        primaryButton: string;
+        primaryButtonHover: string;
+        primaryButtonText: string;
+        primaryText: string;
+        secondary: string;
+        secondaryButton: string;
+        secondaryButtonHover: string;
+        secondaryButtonText: string;
+        secondaryText: string;
+        destructiveButton: string;
+        destructiveButtonHover: string;
+        destructiveButtonText: string;
+        destructiveButtonHoverText: string;
+        background: string;
+        toolTipBackground: string;
+        toolTipText: string;
+        overlay: string;
+        mapNavBackground: string;
+        mapNavText: string;
+        mapNavSearchResults: string;
+        mapNavSearchResultsText: string;
+        widgetBackground: string;
+        widgetText: string;
+        widgetIcons: string;
+        myLocationPrimaryButton: string;
+        myLocationPrimaryButtonHover: string;
+        myLocationSecondaryButton: string;
+        myLocationSecondaryButtonHover: string;
+        adminMarkerText: string;
+        adminMarkerStroke: string;
+        programmaticPinMarkersText: string;
+        programmaticPinMarkersStroke: string;
+        miscBadgeIconColor: string;
+        miscBadgeIconStroke: string;
+        miscBadgeDynamicLabelColor: string;
+        miscBadgeDynamicLabelStroke: string;
+        miscBadgePinColor: string;
+        miscBadgePinStroke: string;
+        miscSelectedbgColor: string;
+        miscSelectedbgStroke: string;
+        miscWayfindingStartColor: string;
+        miscWayfindingStartStroke: string;
+        miscWayfindingStartGhostColor: string;
+        miscWayfindingStartGhostStroke: string;
+        statusAlertBackground: string;
+        statusAlertText: string;
+        statusActiveBackground: string;
+        statusActiveText: string;
+        statusInfoBackground: string;
+        statusInfoText: string;
+        statusWarningBackground: string;
+        statusWarningText: string;
+        statusInactiveBackground: string;
+        statusInactiveText: string;
+        statusSuccessBackground: string;
+        statusSuccessText: string;
+        statusErrorBackground: string;
+        statusErrorText: string;
+        categoryBadgeArt: string;
+        categoryBadgeBaggage: string;
+        categoryBadgeCheckin: string;
+        categoryBadgeConvention: string;
+        categoryBadgeEat: string;
+        categoryBadgeEntertainment: string;
+        categoryBadgeEquipment: string;
+        categoryBadgeExit: string;
+        categoryBadgeGambling: string;
+        categoryBadgeGate: string;
+        categoryBadgeInactive: string;
+        categoryBadgeHotel: string;
+        categoryBadgeMeeting: string;
+        categoryBadgeOffice: string;
+        categoryBadgeParking: string;
+        categoryBadgePortal: string;
+        categoryBadgeRecreation: string;
+        categoryBadgeRelax: string;
+        categoryBadgeRestroom: string;
+        categoryBadgeRoom: string;
+        categoryBadgeSecurity: string;
+        categoryBadgeServices: string;
+        categoryBadgeShop: string;
+        categoryBadgeTicketing: string;
+        categoryBadgeTransport: string;
+        categoryBadgeWayfinding: string;
+        categoryBadgeWorkstation: string;
+        modHeaderBackground: string;
+        modHeaderText: string;
+    };
+    fonts: {
+        default: string;
+    };
+    radii: {
+        none: string;
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        full: string;
+    };
+    borders: {
+        none: number;
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+    };
+    borderWidths: {
+        sm: string;
+        md: string;
+    };
+    letterSpacings: {
+        sm: string;
+        md: string;
+        lg: string;
+    };
+    breakpoints: {
+        xs: number;
+        sm: number;
+        md: number;
+        lg: number;
+        xl: number;
+    };
+    shadows: {
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        xxl: string;
+        xxxl: string;
+    };
+    fontSizes: {
+        xxs: string;
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        xxl: string;
+        xxxl: string;
+        xxxxl: string;
+    };
+    fontWeights: {
+        lighter: number;
+        normal: number;
+        bold: number;
+    };
+    iconSizes: {
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+    };
+    icons: {
+        '2d': {
+            path: import("react/jsx-runtime").JSX.Element;
+        };
+    };
+};
+export default theme;

package/dist/types/src/utils/molDesktopDefaultTheme.d.ts

@@ -0,0 +1,156 @@
+import '@csstools/normalize.css';
+declare const theme: {
+    colors: {
+        primary: string;
+        primaryButton: string;
+        primaryButtonHover: string;
+        primaryButtonText: string;
+        primaryText: string;
+        secondary: string;
+        secondaryButton: string;
+        secondaryButtonHover: string;
+        secondaryButtonText: string;
+        secondaryText: string;
+        destructiveButton: string;
+        destructiveButtonHover: string;
+        destructiveButtonText: string;
+        destructiveButtonHoverText: string;
+        background: string;
+        toolTipBackground: string;
+        toolTipText: string;
+        overlay: string;
+        mapNavBackground: string;
+        mapNavText: string;
+        mapNavSearchResults: string;
+        mapNavSearchResultsText: string;
+        widgetBackground: string;
+        widgetText: string;
+        widgetIcons: string;
+        myLocationPrimaryButton: string;
+        myLocationPrimaryButtonHover: string;
+        myLocationSecondaryButton: string;
+        myLocationSecondaryButtonHover: string;
+        adminMarkerText: string;
+        adminMarkerStroke: string;
+        programmaticPinMarkersText: string;
+        programmaticPinMarkersStroke: string;
+        miscBadgeIconColor: string;
+        miscBadgeIconStroke: string;
+        miscBadgeDynamicLabelColor: string;
+        miscBadgeDynamicLabelStroke: string;
+        miscBadgePinColor: string;
+        miscBadgePinStroke: string;
+        miscWayfindingStartColor: string;
+        miscWayfindingStartStroke: string;
+        miscWayfindingStartGhostColor: string;
+        miscWayfindingStartGhostStroke: string;
+        statusAlertBackground: string;
+        statusAlertText: string;
+        statusActiveBackground: string;
+        statusActiveText: string;
+        statusInfoBackground: string;
+        statusInfoText: string;
+        statusWarningBackground: string;
+        statusWarningText: string;
+        statusInactiveBackground: string;
+        statusInactiveText: string;
+        statusSuccessBackground: string;
+        statusSuccessText: string;
+        statusErrorBackground: string;
+        statusErrorText: string;
+        categoryBadgeArt: string;
+        categoryBadgeBaggage: string;
+        categoryBadgeCheckin: string;
+        categoryBadgeConvention: string;
+        categoryBadgeEat: string;
+        categoryBadgeEntertainment: string;
+        categoryBadgeEquipment: string;
+        categoryBadgeExit: string;
+        categoryBadgeGambling: string;
+        categoryBadgeGate: string;
+        categoryBadgeInactive: string;
+        categoryBadgeHotel: string;
+        categoryBadgeMeeting: string;
+        categoryBadgeOffice: string;
+        categoryBadgeParking: string;
+        categoryBadgePortal: string;
+        categoryBadgeRecreation: string;
+        categoryBadgeRelax: string;
+        categoryBadgeRestroom: string;
+        categoryBadgeRoom: string;
+        categoryBadgeSecurity: string;
+        categoryBadgeServices: string;
+        categoryBadgeShop: string;
+        categoryBadgeTicketing: string;
+        categoryBadgeTransport: string;
+        categoryBadgeWayfinding: string;
+        categoryBadgeWorkstation: string;
+    };
+    fonts: {
+        default: string;
+    };
+    radii: {
+        none: string;
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        full: string;
+    };
+    borders: {
+        none: number;
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+    };
+    borderWidths: {
+        sm: string;
+        md: string;
+    };
+    letterSpacings: {
+        sm: string;
+        md: string;
+        lg: string;
+    };
+    breakpoints: {
+        xs: number;
+        sm: number;
+        md: number;
+        lg: number;
+        xl: number;
+    };
+    shadows: {
+        md: string;
+        lg: string;
+        xl: string;
+        xxl: string;
+    };
+    fontSizes: {
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        xxl: string;
+    };
+    iconSizes: {
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        xxl: string;
+    };
+    narrowIconSizes: {
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        xxl: string;
+    };
+    icons: {
+        '2d': {
+            path: import("react/jsx-runtime").JSX.Element;
+        };
+    };
+};
+export default theme;

package/dist/types/src/utils/observable.d.ts

@@ -0,0 +1,17 @@
+type ObserverCallback = (...args: unknown[]) => void;
+export type ObservableInstance = {
+    _observers?: ObserverCallback[];
+    detach: (cb: ObserverCallback) => void;
+    filter: (fn: (...args: unknown[]) => boolean) => ObservableInstance;
+    fire: (...args: unknown[]) => ObservableInstance | undefined;
+    observe: (cb: ObserverCallback) => {
+        detach: () => void;
+        ob: ObservableInstance;
+    };
+    on: (value: unknown, cb: ObserverCallback) => {
+        detach: () => void;
+        ob: ObservableInstance;
+    };
+};
+declare function create<TObject extends object | undefined = undefined>(ob?: TObject): ObservableInstance;
+export default create;

package/dist/types/src/utils/stateObj.d.ts

@@ -0,0 +1,31 @@
+type StateRecord = Record<string, unknown>;
+export declare class StateObj<TState extends StateRecord = StateRecord> {
+    state: TState;
+    callback: (state: TState) => void;
+    constructor(initial?: TState);
+    init: (initial: TState) => void;
+    setCallback: (fn: (state: TState) => void) => () => void;
+    unsetCallback: () => void;
+    update: (vals: Partial<TState>) => TState;
+    getState: () => TState;
+}
+export declare class StateObjMultiple<TState extends StateRecord = StateRecord> {
+    state: TState;
+    traceFlag: unknown;
+    lastState: TState;
+    callbacks: Set<(state: TState, prevState: TState) => void>;
+    constructor(initial?: TState, traceFlag?: unknown);
+    addCallback: (fn: (state: TState, prevState: TState) => void) => () => boolean;
+    rmCallback: (fn: (state: TState, prevState: TState) => void) => boolean;
+    getChanges: (vals: Partial<TState>) => {
+        changes: Record<string, {
+            from: unknown;
+            to: unknown;
+        }>;
+        stack: string | undefined;
+    };
+    update: (vals: Partial<TState>) => TState & Partial<TState>;
+    doCallbacks: () => () => void;
+    getState: () => TState;
+}
+export {};