@flipdish/ui-library 0.2.1

package/dist/utilities/cx/index.js

@@ -0,0 +1,38 @@
+import { extendTailwindMerge } from 'tailwind-merge';
+
+/**
+ * tailwind-merge configured for Untitled UI's custom font-size scale, so the
+ * `text-display-*` utilities are treated as part of the `font-size` conflict
+ * group. Without this, tailwind-merge wouldn't de-dupe e.g.
+ * `text-display-sm text-display-lg` down to the last one.
+ *
+ * Mirrors the `cx` helper from Untitled UI's Vite integration guide.
+ */
+const twMerge = extendTailwindMerge({
+    extend: {
+        theme: {
+            text: ['display-xs', 'display-sm', 'display-md', 'display-lg', 'display-xl', 'display-2xl'],
+        },
+    },
+});
+/**
+ * Merge Tailwind class strings, resolving conflicts (last value wins). Accepts the
+ * same inputs as tailwind-merge — strings, arrays, and falsy values for
+ * conditionals — so it composes cleanly:
+ *
+ *   cx('px-2', isActive && 'bg-primary', ['text-sm', null]);
+ *
+ * Pure JS with no DOM dependency, so the same helper works on web (PostCSS) and
+ * React Native (NativeWind). Imported by components as
+ * `@flipdish/ui-library/utilities/cx`.
+ */
+const cx = twMerge;
+/**
+ * Identity helper that exists only so Tailwind IntelliSense recognises and sorts
+ * the class strings held inside style-config objects (e.g. `tailwind-variants`
+ * slot maps). Returns its argument unchanged.
+ */
+const sortCx = (classes) => classes;
+
+export { cx, sortCx };
+//# sourceMappingURL=index.js.map

package/dist/utilities/cx/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/utilities/cx/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;;;AAOG;AACH,MAAM,OAAO,GAAG,mBAAmB,CAAC;AAClC,IAAA,MAAM,EAAE;AACN,QAAA,KAAK,EAAE;AACL,YAAA,IAAI,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,CAAC;AAC5F,SAAA;AACF,KAAA;AACF,CAAA,CAAC;AAEF;;;;;;;;;;AAUG;AACI,MAAM,EAAE,GAAG;AAKlB;;;;AAIG;AACI,MAAM,MAAM,GAAG,CAA4B,OAAU,KAAQ;;;;"}

package/dist/utilities/isReactComponent/index.cjs

@@ -0,0 +1,40 @@
+'use strict';
+
+/**
+ * Backs Untitled UI's `@/utils/is-react-component` import.
+ *
+ * Distinguishes a component passed as a prop (an icon `FC`, class component, or
+ * `forwardRef` object you instantiate) from an already-rendered element
+ * (handled via React's `isValidElement`). Untitled UI icon props accept either
+ * form; these guards select the "render it yourself" branch.
+ *
+ * Pure JS with no DOM dependency — works on web (PostCSS) and React Native
+ * (NativeWind). Imported by components as
+ * `@flipdish/ui-library/utilities/isReactComponent`.
+ */
+/** Checks if a given value is a function component. */
+// biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
+const isFunctionComponent = (component) => {
+    return typeof component === 'function';
+};
+/** Checks if a given value is a class component. */
+// biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
+const isClassComponent = (component) => {
+    return typeof component === 'function' && component.prototype && (!!component.prototype.isReactComponent || !!component.prototype.render);
+};
+/** Checks if a given value is a forward ref component. */
+// biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
+const isForwardRefComponent = (component) => {
+    return typeof component === 'object' && component !== null && component.$$typeof?.toString() === 'Symbol(react.forward_ref)';
+};
+/** Checks if a given value is a valid React component (FC, class, or forwardRef). */
+// biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
+const isReactComponent = (component) => {
+    return isFunctionComponent(component) || isForwardRefComponent(component) || isClassComponent(component);
+};
+
+exports.isClassComponent = isClassComponent;
+exports.isForwardRefComponent = isForwardRefComponent;
+exports.isFunctionComponent = isFunctionComponent;
+exports.isReactComponent = isReactComponent;
+//# sourceMappingURL=index.cjs.map

package/dist/utilities/isReactComponent/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/utilities/isReactComponent/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAMA;;;;;;;;;;;AAWG;AAEH;AACA;AACO,MAAM,mBAAmB,GAAG,CAAC,SAAc,KAAgC;AAChF,IAAA,OAAO,OAAO,SAAS,KAAK,UAAU;AACxC;AAEA;AACA;AACO,MAAM,gBAAgB,GAAG,CAAC,SAAc,KAAiD;IAC9F,OAAO,OAAO,SAAS,KAAK,UAAU,IAAI,SAAS,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,gBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;AAC3I;AAEA;AACA;AACO,MAAM,qBAAqB,GAAG,CAAC,SAAc,KAAuD;AACzG,IAAA,OAAO,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,2BAA2B;AAC9H;AAEA;AACA;AACO,MAAM,gBAAgB,GAAG,CAAC,SAAc,KAAiC;AAC9E,IAAA,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,qBAAqB,CAAC,SAAS,CAAC,IAAI,gBAAgB,CAAC,SAAS,CAAC;AAC1G;;;;;;;"}

package/dist/utilities/isReactComponent/index.d.ts

@@ -0,0 +1,24 @@
+import type React from 'react';
+type ReactComponent = React.FC<any> | React.ComponentClass<any, any> | React.ForwardRefExoticComponent<any>;
+/**
+ * Backs Untitled UI's `@/utils/is-react-component` import.
+ *
+ * Distinguishes a component passed as a prop (an icon `FC`, class component, or
+ * `forwardRef` object you instantiate) from an already-rendered element
+ * (handled via React's `isValidElement`). Untitled UI icon props accept either
+ * form; these guards select the "render it yourself" branch.
+ *
+ * Pure JS with no DOM dependency — works on web (PostCSS) and React Native
+ * (NativeWind). Imported by components as
+ * `@flipdish/ui-library/utilities/isReactComponent`.
+ */
+/** Checks if a given value is a function component. */
+export declare const isFunctionComponent: (component: any) => component is React.FC<any>;
+/** Checks if a given value is a class component. */
+export declare const isClassComponent: (component: any) => component is React.ComponentClass<any, any>;
+/** Checks if a given value is a forward ref component. */
+export declare const isForwardRefComponent: (component: any) => component is React.ForwardRefExoticComponent<any>;
+/** Checks if a given value is a valid React component (FC, class, or forwardRef). */
+export declare const isReactComponent: (component: any) => component is ReactComponent;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/utilities/isReactComponent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/isReactComponent/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,KAAK,cAAc,GAAG,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC;AAE5G;;;;;;;;;;;GAWG;AAEH,uDAAuD;AAEvD,eAAO,MAAM,mBAAmB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,EAAE,CAAC,GAAG,CAE7E,CAAC;AAEF,oDAAoD;AAEpD,eAAO,MAAM,gBAAgB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAE3F,CAAC;AAEF,0DAA0D;AAE1D,eAAO,MAAM,qBAAqB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,KAAK,CAAC,yBAAyB,CAAC,GAAG,CAEtG,CAAC;AAEF,qFAAqF;AAErF,eAAO,MAAM,gBAAgB,GAAI,WAAW,GAAG,KAAG,SAAS,IAAI,cAE9D,CAAC"}

package/dist/utilities/isReactComponent/index.js

@@ -0,0 +1,35 @@
+/**
+ * Backs Untitled UI's `@/utils/is-react-component` import.
+ *
+ * Distinguishes a component passed as a prop (an icon `FC`, class component, or
+ * `forwardRef` object you instantiate) from an already-rendered element
+ * (handled via React's `isValidElement`). Untitled UI icon props accept either
+ * form; these guards select the "render it yourself" branch.
+ *
+ * Pure JS with no DOM dependency — works on web (PostCSS) and React Native
+ * (NativeWind). Imported by components as
+ * `@flipdish/ui-library/utilities/isReactComponent`.
+ */
+/** Checks if a given value is a function component. */
+// biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
+const isFunctionComponent = (component) => {
+    return typeof component === 'function';
+};
+/** Checks if a given value is a class component. */
+// biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
+const isClassComponent = (component) => {
+    return typeof component === 'function' && component.prototype && (!!component.prototype.isReactComponent || !!component.prototype.render);
+};
+/** Checks if a given value is a forward ref component. */
+// biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
+const isForwardRefComponent = (component) => {
+    return typeof component === 'object' && component !== null && component.$$typeof?.toString() === 'Symbol(react.forward_ref)';
+};
+/** Checks if a given value is a valid React component (FC, class, or forwardRef). */
+// biome-ignore lint/suspicious/noExplicitAny: required for React component type guard
+const isReactComponent = (component) => {
+    return isFunctionComponent(component) || isForwardRefComponent(component) || isClassComponent(component);
+};
+
+export { isClassComponent, isForwardRefComponent, isFunctionComponent, isReactComponent };
+//# sourceMappingURL=index.js.map

package/dist/utilities/isReactComponent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/utilities/isReactComponent/index.ts"],"sourcesContent":[null],"names":[],"mappings":"AAMA;;;;;;;;;;;AAWG;AAEH;AACA;AACO,MAAM,mBAAmB,GAAG,CAAC,SAAc,KAAgC;AAChF,IAAA,OAAO,OAAO,SAAS,KAAK,UAAU;AACxC;AAEA;AACA;AACO,MAAM,gBAAgB,GAAG,CAAC,SAAc,KAAiD;IAC9F,OAAO,OAAO,SAAS,KAAK,UAAU,IAAI,SAAS,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,gBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;AAC3I;AAEA;AACA;AACO,MAAM,qBAAqB,GAAG,CAAC,SAAc,KAAuD;AACzG,IAAA,OAAO,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,2BAA2B;AAC9H;AAEA;AACA;AACO,MAAM,gBAAgB,GAAG,CAAC,SAAc,KAAiC;AAC9E,IAAA,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,qBAAqB,CAAC,SAAS,CAAC,IAAI,gBAAgB,CAAC,SAAS,CAAC;AAC1G;;;;"}

package/dist/utilities/renderUtils/index.cjs

@@ -0,0 +1,122 @@
+'use strict';
+
+var React = require('react');
+
+/**
+ * Retrieves an environment variable.
+ *
+ * @param key The key of the environment variable to retrieve.
+ * @returns The value of the environment variable.
+ */
+const getEnvironmentVariable = (key) => {
+    // Prefer Node env in tests/SSR
+    if (typeof process !== 'undefined' && process.env && typeof process.env[key] === 'string') {
+        return process.env[key];
+    }
+    // Fallback to Vite env when available; use eval to avoid parse errors in non‑Vite/CJS.
+    // `eval('import.meta')` is intentional — `import.meta` is a parse-time syntax error in
+    // CommonJS / non-ESM contexts (e.g. some Node test runners). Using eval defers parsing
+    // until runtime so this util can live in shared library code consumed by both Vite and non-Vite environments.
+    try {
+        // biome-ignore lint/security/noGlobalEval: see comment above — required for cross-runtime import.meta access
+        const viteEnv = eval('import.meta')?.env;
+        return viteEnv?.[key] ?? '';
+    }
+    catch {
+        return '';
+    }
+};
+/**
+ * Retrieves a micro-frontend attribute.
+ *
+ * @param key The key of the attribute to retrieve.
+ * @returns The value of the attribute.
+ */
+const getMicroFrontendAttribute = (key) => {
+    if (typeof document === 'undefined') {
+        return '';
+    }
+    const microFrontendDiv = document.getElementById('flipdish-micro-frontend');
+    return microFrontendDiv?.getAttribute(key) || '';
+};
+/**
+ * Retrieves the AppId.
+ *
+ * Attempts to get the value from the environment variable `VITE_APPID_OVERRIDE`.
+ * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-app-id`.
+ * Fallbacks to `data-appid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ *
+ * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ */
+const getAppId = () => {
+    return getEnvironmentVariable('VITE_APPID_OVERRIDE') || getMicroFrontendAttribute('data-app-id') || getMicroFrontendAttribute('data-appid');
+};
+/**
+ * Retrieves the OrgId.
+ *
+ * Attempts to get the value from the environment variable `VITE_ORGID_OVERRIDE`.
+ * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-org-id`.
+ * Fallbacks to `data-orgid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ *
+ * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ */
+const getOrgId = () => {
+    return getEnvironmentVariable('VITE_ORGID_OVERRIDE') || getMicroFrontendAttribute('data-org-id') || getMicroFrontendAttribute('data-orgid');
+};
+/**
+ * Retrieves the BrandId.
+ *
+ * Attempts to get the value from the environment variable `VITE_BRANDID_OVERRIDE`.
+ * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-brand-id`.
+ * Fallbacks to `data-brandid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ *
+ * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ */
+const getBrandId = () => {
+    return getEnvironmentVariable('VITE_BRANDID_OVERRIDE') || getMicroFrontendAttribute('data-brand-id') || getMicroFrontendAttribute('data-brandid');
+};
+/**
+ * Retrieves the isFlipdishStaff attribute.
+ *
+ * Attempts to get the value from the environment variable `VITE_ISFLIPDISHSTAFFOVERRIDE`.
+ * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-is-flipdish-staff`.
+ * Fallbacks to `data-isflipdishstaff` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ *
+ * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ */
+const getIsFlipdishStaff = () => {
+    const stringValue = getEnvironmentVariable('VITE_ISFLIPDISHSTAFFOVERRIDE') ||
+        getMicroFrontendAttribute('data-is-flipdish-staff') ||
+        getMicroFrontendAttribute('data-isflipdishstaff');
+    return stringValue?.toString() === 'true';
+};
+// biome-ignore lint/suspicious/noExplicitAny: dynamic import factory shape isn't expressible without `any`; preserved from portal-library implementation
+const lazyWithRetry = (componentImport) => React.lazy(async () => {
+    const pageHasAlreadyBeenForceRefreshed = JSON.parse(window.sessionStorage.getItem('page-has-been-force-refreshed') || 'false');
+    try {
+        const component = await componentImport();
+        window.sessionStorage.setItem('page-has-been-force-refreshed', 'false');
+        return component;
+    }
+    catch (error) {
+        if (!pageHasAlreadyBeenForceRefreshed) {
+            // Assuming that the user is not on the latest version of the application.
+            // Let's refresh the page immediately.
+            window.sessionStorage.setItem('page-has-been-force-refreshed', 'true');
+            return window.location.reload();
+        }
+        // The page has already been reloaded
+        // Assuming that user is already using the latest version of the application.
+        // Let's let the application crash and raise the error.
+        throw error;
+    }
+});
+
+exports.getAppId = getAppId;
+exports.getBrandId = getBrandId;
+exports.getEnvironmentVariable = getEnvironmentVariable;
+exports.getIsFlipdishStaff = getIsFlipdishStaff;
+exports.getMicroFrontendAttribute = getMicroFrontendAttribute;
+exports.getOrgId = getOrgId;
+exports.lazyWithRetry = lazyWithRetry;
+//# sourceMappingURL=index.cjs.map

package/dist/utilities/renderUtils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/utilities/renderUtils/index.ts"],"sourcesContent":[null],"names":["lazy"],"mappings":";;;;AAEA;;;;;AAKG;AACI,MAAM,sBAAsB,GAAG,CAAC,GAAW,KAAY;;AAE5D,IAAA,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE;AACzF,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAW;IACnC;;;;;AAKA,IAAA,IAAI;;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,GAAqD;AAC1F,QAAA,OAAO,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE;IAC7B;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,EAAE;IACX;AACF;AAEA;;;;;AAKG;AACI,MAAM,yBAAyB,GAAG,CAAC,GAAW,KAAY;AAC/D,IAAA,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE;AACnC,QAAA,OAAO,EAAE;IACX;IACA,MAAM,gBAAgB,GAAG,QAAQ,CAAC,cAAc,CAAC,yBAAyB,CAAC;IAC3E,OAAO,gBAAgB,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;AAClD;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,UAAU,GAAG,MAAa;AACrC,IAAA,OAAO,sBAAsB,CAAC,uBAAuB,CAAC,IAAI,yBAAyB,CAAC,eAAe,CAAC,IAAI,yBAAyB,CAAC,cAAc,CAAC;AACnJ;AAEA;;;;;;;;AAQG;AACI,MAAM,kBAAkB,GAAG,MAAc;AAC9C,IAAA,MAAM,WAAW,GACf,sBAAsB,CAAC,8BAA8B,CAAC;QACtD,yBAAyB,CAAC,wBAAwB,CAAC;QACnD,yBAAyB,CAAC,sBAAsB,CAAC;AACnD,IAAA,OAAO,WAAW,EAAE,QAAQ,EAAE,KAAK,MAAM;AAC3C;AAEA;AACO,MAAM,aAAa,GAAG,CAAC,eAA0B,KACtDA,UAAI,CAAC,YAAW;AACd,IAAA,MAAM,gCAAgC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,+BAA+B,CAAC,IAAI,OAAO,CAAC;AAE9H,IAAA,IAAI;AACF,QAAA,MAAM,SAAS,GAAG,MAAM,eAAe,EAAE;QACzC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,+BAA+B,EAAE,OAAO,CAAC;AAEvE,QAAA,OAAO,SAAS;IAClB;IAAE,OAAO,KAAK,EAAE;QACd,IAAI,CAAC,gCAAgC,EAAE;;;YAGrC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,+BAA+B,EAAE,MAAM,CAAC;AACtE,YAAA,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;QACjC;;;;AAKA,QAAA,MAAM,KAAK;IACb;AACF,CAAC;;;;;;;;;;"}

package/dist/utilities/renderUtils/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Retrieves an environment variable.
+ *
+ * @param key The key of the environment variable to retrieve.
+ * @returns The value of the environment variable.
+ */
+export declare const getEnvironmentVariable: (key: string) => string;
+/**
+ * Retrieves a micro-frontend attribute.
+ *
+ * @param key The key of the attribute to retrieve.
+ * @returns The value of the attribute.
+ */
+export declare const getMicroFrontendAttribute: (key: string) => string;
+/**
+ * Retrieves the AppId.
+ *
+ * Attempts to get the value from the environment variable `VITE_APPID_OVERRIDE`.
+ * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-app-id`.
+ * Fallbacks to `data-appid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ *
+ * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ */
+export declare const getAppId: () => string;
+/**
+ * Retrieves the OrgId.
+ *
+ * Attempts to get the value from the environment variable `VITE_ORGID_OVERRIDE`.
+ * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-org-id`.
+ * Fallbacks to `data-orgid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ *
+ * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ */
+export declare const getOrgId: () => string;
+/**
+ * Retrieves the BrandId.
+ *
+ * Attempts to get the value from the environment variable `VITE_BRANDID_OVERRIDE`.
+ * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-brand-id`.
+ * Fallbacks to `data-brandid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ *
+ * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ */
+export declare const getBrandId: () => string;
+/**
+ * Retrieves the isFlipdishStaff attribute.
+ *
+ * Attempts to get the value from the environment variable `VITE_ISFLIPDISHSTAFFOVERRIDE`.
+ * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-is-flipdish-staff`.
+ * Fallbacks to `data-isflipdishstaff` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ *
+ * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ */
+export declare const getIsFlipdishStaff: () => boolean;
+export declare const lazyWithRetry: (componentImport: () => any) => import("react").LazyExoticComponent<import("react").ComponentType<any>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/utilities/renderUtils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/renderUtils/index.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,MAgBpD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,KAAK,MAAM,KAAG,MAMvD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,QAAO,MAE3B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,QAAO,MAE3B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,QAAO,MAE7B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,QAAO,OAMrC,CAAC;AAGF,eAAO,MAAM,aAAa,GAAI,iBAAiB,MAAM,GAAG,4EAsBpD,CAAC"}

package/dist/utilities/renderUtils/index.js

@@ -0,0 +1,114 @@
+import { lazy } from 'react';
+
+/**
+ * Retrieves an environment variable.
+ *
+ * @param key The key of the environment variable to retrieve.
+ * @returns The value of the environment variable.
+ */
+const getEnvironmentVariable = (key) => {
+    // Prefer Node env in tests/SSR
+    if (typeof process !== 'undefined' && process.env && typeof process.env[key] === 'string') {
+        return process.env[key];
+    }
+    // Fallback to Vite env when available; use eval to avoid parse errors in non‑Vite/CJS.
+    // `eval('import.meta')` is intentional — `import.meta` is a parse-time syntax error in
+    // CommonJS / non-ESM contexts (e.g. some Node test runners). Using eval defers parsing
+    // until runtime so this util can live in shared library code consumed by both Vite and non-Vite environments.
+    try {
+        // biome-ignore lint/security/noGlobalEval: see comment above — required for cross-runtime import.meta access
+        const viteEnv = eval('import.meta')?.env;
+        return viteEnv?.[key] ?? '';
+    }
+    catch {
+        return '';
+    }
+};
+/**
+ * Retrieves a micro-frontend attribute.
+ *
+ * @param key The key of the attribute to retrieve.
+ * @returns The value of the attribute.
+ */
+const getMicroFrontendAttribute = (key) => {
+    if (typeof document === 'undefined') {
+        return '';
+    }
+    const microFrontendDiv = document.getElementById('flipdish-micro-frontend');
+    return microFrontendDiv?.getAttribute(key) || '';
+};
+/**
+ * Retrieves the AppId.
+ *
+ * Attempts to get the value from the environment variable `VITE_APPID_OVERRIDE`.
+ * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-app-id`.
+ * Fallbacks to `data-appid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ *
+ * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ */
+const getAppId = () => {
+    return getEnvironmentVariable('VITE_APPID_OVERRIDE') || getMicroFrontendAttribute('data-app-id') || getMicroFrontendAttribute('data-appid');
+};
+/**
+ * Retrieves the OrgId.
+ *
+ * Attempts to get the value from the environment variable `VITE_ORGID_OVERRIDE`.
+ * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-org-id`.
+ * Fallbacks to `data-orgid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ *
+ * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ */
+const getOrgId = () => {
+    return getEnvironmentVariable('VITE_ORGID_OVERRIDE') || getMicroFrontendAttribute('data-org-id') || getMicroFrontendAttribute('data-orgid');
+};
+/**
+ * Retrieves the BrandId.
+ *
+ * Attempts to get the value from the environment variable `VITE_BRANDID_OVERRIDE`.
+ * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-brand-id`.
+ * Fallbacks to `data-brandid` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ *
+ * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ */
+const getBrandId = () => {
+    return getEnvironmentVariable('VITE_BRANDID_OVERRIDE') || getMicroFrontendAttribute('data-brand-id') || getMicroFrontendAttribute('data-brandid');
+};
+/**
+ * Retrieves the isFlipdishStaff attribute.
+ *
+ * Attempts to get the value from the environment variable `VITE_ISFLIPDISHSTAFFOVERRIDE`.
+ * If the environment variable is not set, it falls back to retrieving from a micro frontend attribute `data-is-flipdish-staff`.
+ * Fallbacks to `data-isflipdishstaff` for backwards compatibility @flipdish/portal-library@5.1.0 and below
+ *
+ * @warning Your component will not re-render if the value changes. Use 'useMicroFrontendAttributes' custom hook instead if you care about reactivity.
+ */
+const getIsFlipdishStaff = () => {
+    const stringValue = getEnvironmentVariable('VITE_ISFLIPDISHSTAFFOVERRIDE') ||
+        getMicroFrontendAttribute('data-is-flipdish-staff') ||
+        getMicroFrontendAttribute('data-isflipdishstaff');
+    return stringValue?.toString() === 'true';
+};
+// biome-ignore lint/suspicious/noExplicitAny: dynamic import factory shape isn't expressible without `any`; preserved from portal-library implementation
+const lazyWithRetry = (componentImport) => lazy(async () => {
+    const pageHasAlreadyBeenForceRefreshed = JSON.parse(window.sessionStorage.getItem('page-has-been-force-refreshed') || 'false');
+    try {
+        const component = await componentImport();
+        window.sessionStorage.setItem('page-has-been-force-refreshed', 'false');
+        return component;
+    }
+    catch (error) {
+        if (!pageHasAlreadyBeenForceRefreshed) {
+            // Assuming that the user is not on the latest version of the application.
+            // Let's refresh the page immediately.
+            window.sessionStorage.setItem('page-has-been-force-refreshed', 'true');
+            return window.location.reload();
+        }
+        // The page has already been reloaded
+        // Assuming that user is already using the latest version of the application.
+        // Let's let the application crash and raise the error.
+        throw error;
+    }
+});
+
+export { getAppId, getBrandId, getEnvironmentVariable, getIsFlipdishStaff, getMicroFrontendAttribute, getOrgId, lazyWithRetry };
+//# sourceMappingURL=index.js.map

package/dist/utilities/renderUtils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/utilities/renderUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;AAKG;AACI,MAAM,sBAAsB,GAAG,CAAC,GAAW,KAAY;;AAE5D,IAAA,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE;AACzF,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAW;IACnC;;;;;AAKA,IAAA,IAAI;;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,GAAqD;AAC1F,QAAA,OAAO,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE;IAC7B;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,EAAE;IACX;AACF;AAEA;;;;;AAKG;AACI,MAAM,yBAAyB,GAAG,CAAC,GAAW,KAAY;AAC/D,IAAA,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE;AACnC,QAAA,OAAO,EAAE;IACX;IACA,MAAM,gBAAgB,GAAG,QAAQ,CAAC,cAAc,CAAC,yBAAyB,CAAC;IAC3E,OAAO,gBAAgB,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;AAClD;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,QAAQ,GAAG,MAAa;AACnC,IAAA,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,yBAAyB,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC,YAAY,CAAC;AAC7I;AAEA;;;;;;;;AAQG;AACI,MAAM,UAAU,GAAG,MAAa;AACrC,IAAA,OAAO,sBAAsB,CAAC,uBAAuB,CAAC,IAAI,yBAAyB,CAAC,eAAe,CAAC,IAAI,yBAAyB,CAAC,cAAc,CAAC;AACnJ;AAEA;;;;;;;;AAQG;AACI,MAAM,kBAAkB,GAAG,MAAc;AAC9C,IAAA,MAAM,WAAW,GACf,sBAAsB,CAAC,8BAA8B,CAAC;QACtD,yBAAyB,CAAC,wBAAwB,CAAC;QACnD,yBAAyB,CAAC,sBAAsB,CAAC;AACnD,IAAA,OAAO,WAAW,EAAE,QAAQ,EAAE,KAAK,MAAM;AAC3C;AAEA;AACO,MAAM,aAAa,GAAG,CAAC,eAA0B,KACtD,IAAI,CAAC,YAAW;AACd,IAAA,MAAM,gCAAgC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,+BAA+B,CAAC,IAAI,OAAO,CAAC;AAE9H,IAAA,IAAI;AACF,QAAA,MAAM,SAAS,GAAG,MAAM,eAAe,EAAE;QACzC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,+BAA+B,EAAE,OAAO,CAAC;AAEvE,QAAA,OAAO,SAAS;IAClB;IAAE,OAAO,KAAK,EAAE;QACd,IAAI,CAAC,gCAAgC,EAAE;;;YAGrC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,+BAA+B,EAAE,MAAM,CAAC;AACtE,YAAA,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;QACjC;;;;AAKA,QAAA,MAAM,KAAK;IACb;AACF,CAAC;;;;"}

package/package.json

@@ -0,0 +1,135 @@
+{
+  "name": "@flipdish/ui-library",
+  "version": "0.2.1",
+  "description": "Flipdish Design System — atomic-design component library (Tailwind v4 + UntitledUI + React Aria).",
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flipdishbytes/flipdish-design-system.git",
+    "directory": "packages/ui-library"
+  },
+  "exports": {
+    "./styles": "./dist/styles.css",
+    "./components/atoms/*": {
+      "types": "./dist/components/atoms/*/index.d.ts",
+      "import": "./dist/components/atoms/*/index.js",
+      "require": "./dist/components/atoms/*/index.cjs"
+    },
+    "./components/molecules/*": {
+      "types": "./dist/components/molecules/*/index.d.ts",
+      "import": "./dist/components/molecules/*/index.js",
+      "require": "./dist/components/molecules/*/index.cjs"
+    },
+    "./components/organisms/*": {
+      "types": "./dist/components/organisms/*/index.d.ts",
+      "import": "./dist/components/organisms/*/index.js",
+      "require": "./dist/components/organisms/*/index.cjs"
+    },
+    "./components/templates/*": {
+      "types": "./dist/components/templates/*/index.d.ts",
+      "import": "./dist/components/templates/*/index.js",
+      "require": "./dist/components/templates/*/index.cjs"
+    },
+    "./providers/*": {
+      "types": "./dist/providers/*/index.d.ts",
+      "import": "./dist/providers/*/index.js",
+      "require": "./dist/providers/*/index.cjs"
+    },
+    "./hooks/*": {
+      "types": "./dist/hooks/*/index.d.ts",
+      "import": "./dist/hooks/*/index.js",
+      "require": "./dist/hooks/*/index.cjs"
+    },
+    "./utilities/*": {
+      "types": "./dist/utilities/*/index.d.ts",
+      "import": "./dist/utilities/*/index.js",
+      "require": "./dist/utilities/*/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "rollup -c && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "echo 'No tests yet'",
+    "typecheck:native": "tsc --noEmit -p tsconfig.native.json",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build",
+    "chromatic": "chromatic --exit-zero-on-changes",
+    "figma:connect": "figma connect create",
+    "figma:publish": "figma connect publish",
+    "figma:publish:dry": "figma connect publish --dry-run",
+    "figma:unpublish": "figma connect unpublish"
+  },
+  "dependencies": {
+    "@flipdish/ui-icons": "workspace:*",
+    "react-error-boundary": "^4.1.2",
+    "tailwindcss-animate": "^1.0.7",
+    "tailwindcss-react-aria-components": "^2.1.1"
+  },
+  "peerDependencies": {
+    "@react-native-aria/focus": ">=0.2.7",
+    "@react-native-aria/interactions": ">=0.2.7",
+    "clsx": "^2.1.1",
+    "nativewind": "^4.1.0",
+    "react": "^19.0.0",
+    "react-aria-components": "^1.18.0",
+    "react-dom": "^19.0.0",
+    "react-native": ">=0.79.0",
+    "react-router": "^7.0.0",
+    "tailwind-merge": "^3.6.0",
+    "tailwind-variants": "^3.2.2"
+  },
+  "peerDependenciesMeta": {
+    "@react-native-aria/focus": {
+      "optional": true
+    },
+    "@react-native-aria/interactions": {
+      "optional": true
+    },
+    "nativewind": {
+      "optional": true
+    },
+    "react-aria-components": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    },
+    "react-router": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@figma/code-connect": "^1.4.8",
+    "@storybook/addon-a11y": "^10.4.6",
+    "@storybook/addon-docs": "^10.4.6",
+    "@storybook/react-vite": "^10.4.6",
+    "@tailwindcss/vite": "^4.3.1",
+    "@types/node": "^24.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "chromatic": "^17.4.1",
+    "clsx": "^2.1.1",
+    "react": "^19.0.0",
+    "react-aria-components": "^1.18.0",
+    "react-dom": "^19.0.0",
+    "react-router": "^7.17.0",
+    "remark-gfm": "^4.0.1",
+    "storybook": "^10.4.6",
+    "tailwind-merge": "^3.6.0",
+    "tailwind-variants": "^3.2.2",
+    "tailwindcss": "^4.3.1",
+    "vite": "^8.0.16"
+  }
+}