@ledgerhq/lumen-utils-shared 0.0.11

package/README.md

@@ -0,0 +1,32 @@
+# utils-shared
+
+Shared utility functions for the Lumen design system.
+
+## Contributing
+
+### Adding New Utilities
+
+1. Create your utility function in `src/lib/`
+2. Export it from `src/index.ts`
+3. Add tests in the corresponding `.spec.ts` file
+4. Update this README with usage examples
+
+### Development Commands
+
+```bash
+# Build the library
+npx nx build @ledgerhq/lumen-utils-shared
+
+# Run tests
+npx nx test @ledgerhq/lumen-utils-shared
+
+# Lint code
+npx nx lint @ledgerhq/lumen-utils-shared
+```
+
+### Guidelines
+
+- Keep utilities pure and side-effect free
+- Add comprehensive tests for all functions
+- Use TypeScript for type safety
+- Follow existing naming conventions

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './lib/string-utils/string-utils';
+export * from './lib/input-formatter';
+export * from './lib/create-safe-context';
+export * from './lib/cn';
+export * from './lib/is-text-children';
+export * from './lib/use-merge-ref';
+export * from './lib/get-object-path';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,UAAU,CAAC;AACzB,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,115 @@
+import { jsx as h } from "react/jsx-runtime";
+import { createContext as x, useMemo as m, useContext as y } from "react";
+import { clsx as P } from "clsx";
+import { twMerge as S } from "tailwind-merge";
+function w(t) {
+  return t ? t.split(/[-_ ]+/).map((n) => n.charAt(0).toUpperCase() + n.slice(1).toLowerCase()).join("") : "";
+}
+const C = 48, A = 17, M = 2;
+function E(t) {
+  const n = t.replace(/\D/g, "").length;
+  return Math.max(
+    A,
+    C - n * M
+  );
+}
+function f(t, n = !0) {
+  if (!t) return "";
+  const i = t.includes("."), [o, r] = t.split("."), c = o.replace(/\B(?=(\d{3})+(?!\d))/g, " ");
+  return i && n ? r ? `${c}.${r}` : `${c}.` : c;
+}
+function T(t, n = {}) {
+  const {
+    allowDecimals: i = !0,
+    thousandsSeparator: o = !0,
+    maxIntegerLength: r = 9,
+    maxDecimalLength: c = 9
+  } = n, a = t.replace(",", ".").replace(/[^\d.]/g, "");
+  let e = a;
+  if (e = e.replace(/^0+(?=\d)/, ""), !i)
+    return e = e.replace(/\D/g, ""), r > 0 && e.length > r && (e = e.slice(0, r)), o ? f(e) : e;
+  e === "." && (e = "0.");
+  const l = e.indexOf(".");
+  if (l !== -1) {
+    let s = e.slice(0, l), u = e.slice(l + 1).replace(/\./g, "");
+    r > 0 && s.length > r && (s = s.slice(0, r)), u = u.slice(0, c), s === "" && (s = "0");
+    const d = a.endsWith(".") || e.endsWith(".");
+    e = u.length > 0 ? `${s}.${u}` : d ? `${s}.` : s;
+  } else
+    r > 0 && e.length > r && (e = e.slice(0, r));
+  return o ? f(e) : e;
+}
+function _(t, n) {
+  const i = x(n), o = ({ children: c, value: a }) => {
+    const e = m(
+      () => a,
+      Object.values(a ?? {})
+    );
+    return /* @__PURE__ */ h(i.Provider, { value: e, children: c });
+  };
+  o.displayName = t + "Provider";
+  function r({
+    consumerName: c,
+    contextRequired: a
+  }) {
+    const e = y(i);
+    if (e)
+      return e;
+    if (a)
+      throw new Error(
+        `${c} must be used within ${t}`
+      );
+    return n || {};
+  }
+  return [o, r];
+}
+function j(...t) {
+  return S(P(t));
+}
+const p = (t) => typeof t == "string" || typeof t == "number", F = (t) => Array.isArray(t) ? t.every(p) : p(t);
+function g(t, n) {
+  if (typeof t == "function")
+    return t(n);
+  typeof t == "object" && t !== null && "current" in t && (t.current = n);
+}
+function $(...t) {
+  const n = /* @__PURE__ */ new Map();
+  return (i) => {
+    if (i === null) {
+      t.forEach((o) => {
+        const r = n.get(o);
+        typeof r == "function" && r(), g(o, null);
+      }), n.clear();
+      return;
+    }
+    t.forEach((o) => {
+      const r = g(o, i);
+      typeof r == "function" && n.set(o, r);
+    });
+  };
+}
+function I(...t) {
+  return m(() => $(...t), t);
+}
+const z = (t, n) => {
+  let i = t;
+  for (const o of n) {
+    if (i == null)
+      return;
+    i = i[o];
+  }
+  return i;
+};
+export {
+  g as assignRef,
+  j as cn,
+  _ as createSafeContext,
+  f as formatThousands,
+  E as getFontSize,
+  z as getObjectPath,
+  F as isTextChildren,
+  $ as mergeRefs,
+  T as textFormatter,
+  w as toPascalCase,
+  I as useMergedRef
+};

package/dist/lib/cn.d.ts

@@ -0,0 +1,3 @@
+import { ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=cn.d.ts.map

package/dist/lib/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../src/lib/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,MAAM,CAAC;AAGxC,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC"}

package/dist/lib/create-safe-context/create-safe-context.d.ts

@@ -0,0 +1,9 @@
+import { FC, ReactNode } from 'react';
+export declare function createSafeContext<ContextValue extends object>(rootComponentName: string, defaultContext?: ContextValue): readonly [FC<{
+    children: ReactNode;
+    value: ContextValue;
+}>, <ContextRequired extends boolean = boolean>({ consumerName, contextRequired, }: {
+    consumerName: string;
+    contextRequired: ContextRequired;
+}) => ContextRequired extends true ? ContextValue : Partial<ContextValue>];
+//# sourceMappingURL=create-safe-context.d.ts.map

package/dist/lib/create-safe-context/create-safe-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-safe-context.d.ts","sourceRoot":"","sources":["../../../src/lib/create-safe-context/create-safe-context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,EAAE,EAAE,SAAS,EAAuB,MAAM,OAAO,CAAC;AAE1E,wBAAgB,iBAAiB,CAAC,YAAY,SAAS,MAAM,EAC3D,iBAAiB,EAAE,MAAM,EACzB,cAAc,CAAC,EAAE,YAAY;cAKjB,SAAS;WACZ,YAAY;KAaG,eAAe,SAAS,OAAO,gDAGpD;IACD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;CAClC,KAAG,eAAe,SAAS,IAAI,GAAG,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,EAgBxE"}

package/dist/lib/create-safe-context/index.d.ts

@@ -0,0 +1,2 @@
+export * from './create-safe-context';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/create-safe-context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/create-safe-context/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/lib/get-object-path/get-object-path.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Access a nested property in an object using an array path.
+ *
+ * @param obj - The object to access
+ * @param path - Array of keys representing the path to the value
+ * @returns The value at the path, or undefined if not found
+ *
+ * @example
+ * ```ts
+ * const theme = { colors: { bg: { surface: '#fff' } } };
+ *
+ * getObjectPath(theme, ['colors', 'bg', 'surface']); // '#fff'
+ * getObjectPath(theme, ['colors', 'bg']); // { surface: '#fff' }
+ * getObjectPath(theme, ['spacings']); // undefined
+ * ```
+ */
+export declare const getObjectPath: <T = unknown>(obj: Record<string, unknown>, path: string[]) => T | undefined;
+//# sourceMappingURL=get-object-path.d.ts.map

package/dist/lib/get-object-path/get-object-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-object-path.d.ts","sourceRoot":"","sources":["../../../src/lib/get-object-path/get-object-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,GAAG,OAAO,EACvC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,MAAM,MAAM,EAAE,KACb,CAAC,GAAG,SAWN,CAAC"}

package/dist/lib/get-object-path/index.d.ts

@@ -0,0 +1,2 @@
+export { getObjectPath } from './get-object-path';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/get-object-path/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/get-object-path/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/lib/input-formatter/font-size-formatter.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Calculates the font size based on the number of digits in the input value.
+ * Scales from 48px (max) to 17px (min) as digit count increases.
+ */
+export declare function getFontSize(value: string): number;
+//# sourceMappingURL=font-size-formatter.d.ts.map

package/dist/lib/input-formatter/font-size-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-size-formatter.d.ts","sourceRoot":"","sources":["../../../src/lib/input-formatter/font-size-formatter.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOjD"}

package/dist/lib/input-formatter/format-thousands.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Formats a number string with space-separated thousands.
+ * e.g., '1000000' -> '1 000 000'
+ *
+ * @returns Formatted string with space-separated thousands
+ *
+ * @example
+ * formatThousands('1000') // '1 000'
+ * formatThousands('1000000') // '1 000 000'
+ * formatThousands('1234.5678') // '1 234.5678'
+ * formatThousands('1234.5678', false) // '1 235'
+ */
+export declare function formatThousands(
+/** The value to format */
+value: string, 
+/** Whether to preserve decimal places */
+preserveDecimals?: boolean): string;
+//# sourceMappingURL=format-thousands.d.ts.map

package/dist/lib/input-formatter/format-thousands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-thousands.d.ts","sourceRoot":"","sources":["../../../src/lib/input-formatter/format-thousands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe;AAC7B,0BAA0B;AAC1B,KAAK,EAAE,MAAM;AACb,yCAAyC;AACzC,gBAAgB,UAAO,GACtB,MAAM,CAgBR"}

package/dist/lib/input-formatter/index.d.ts

@@ -0,0 +1,4 @@
+export { getFontSize } from './font-size-formatter';
+export { formatThousands } from './format-thousands';
+export { textFormatter } from './text-formatter';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/input-formatter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/input-formatter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/lib/input-formatter/text-formatter.d.ts

@@ -0,0 +1,31 @@
+export type TextFormatterOptions = {
+    /** Whether to allow decimal values */
+    allowDecimals?: boolean;
+    /** Whether to format with space-separated thousands */
+    thousandsSeparator?: boolean;
+    /** Maximum length for integer part (before decimal) */
+    maxIntegerLength?: number;
+    /** Maximum length for decimal part (after decimal) */
+    maxDecimalLength?: number;
+};
+/**
+ * Formats and validates numeric input text for amount inputs.
+ * Handles decimal formatting, leading zeros, and prevents multiple decimal points.
+ * Can optionally format with space-separated thousands.
+ * @returns Formatted and cleaned numeric string
+ *
+ * @example
+ * textFormatter('01') // '1'
+ * textFormatter('.5') // '0.5'
+ * textFormatter('1.2.3') // '1.23'
+ * textFormatter('1,5') // '1.5'
+ * textFormatter('abc123') // '123'
+ * textFormatter('1000000', { thousandsSeparator: true }) // '1 000 000'
+ * textFormatter('1234.5678', { thousandsSeparator: true }) // '1 234.5678'
+ * textFormatter('123456789012', { maxIntegerLength: 9 }) // '123456789'
+ * textFormatter('123.123456', { maxDecimalLength: 2 }) // '123.12'
+ */
+export declare function textFormatter(
+/** The input value to format */
+value: string, options?: TextFormatterOptions): string;
+//# sourceMappingURL=text-formatter.d.ts.map

package/dist/lib/input-formatter/text-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-formatter.d.ts","sourceRoot":"","sources":["../../../src/lib/input-formatter/text-formatter.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG;IACjC,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa;AAC3B,gCAAgC;AAChC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,oBAAyB,GACjC,MAAM,CA4DR"}

package/dist/lib/is-text-children/index.d.ts

@@ -0,0 +1,2 @@
+export * from './is-text-children';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/is-text-children/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/is-text-children/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/lib/is-text-children/is-text-children.d.ts

@@ -0,0 +1,3 @@
+import { ReactNode } from 'react';
+export declare const isTextChildren: (element: ReactNode) => boolean;
+//# sourceMappingURL=is-text-children.d.ts.map

package/dist/lib/is-text-children/is-text-children.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-text-children.d.ts","sourceRoot":"","sources":["../../../src/lib/is-text-children/is-text-children.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKlC,eAAO,MAAM,cAAc,GAAI,SAAS,SAAS,YAGhD,CAAC"}

package/dist/lib/string-utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './string-utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/string-utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/string-utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/lib/string-utils/string-utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Transforms a kebab-case or snake_case string into a PascalCase string.
+ * e.g., 'arrow-up' -> 'ArrowUp'
+ */
+export declare function toPascalCase(str: string): string;
+//# sourceMappingURL=string-utils.d.ts.map

package/dist/lib/string-utils/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/string-utils/string-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMhD"}

package/dist/lib/use-merge-ref/index.d.ts

@@ -0,0 +1,2 @@
+export * from './use-merge-ref';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/use-merge-ref/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/use-merge-ref/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/lib/use-merge-ref/use-merge-ref.d.ts

@@ -0,0 +1,8 @@
+import { Ref, RefCallback } from 'react';
+type PossibleRef<T> = Ref<T> | undefined;
+type RefCleanup = void | (() => void);
+export declare function assignRef<T>(ref: PossibleRef<T>, value: T | null): RefCleanup;
+export declare function mergeRefs<T>(...refs: PossibleRef<T>[]): RefCallback<T>;
+export declare function useMergedRef<T>(...refs: PossibleRef<T>[]): RefCallback<T>;
+export {};
+//# sourceMappingURL=use-merge-ref.d.ts.map

package/dist/lib/use-merge-ref/use-merge-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-merge-ref.d.ts","sourceRoot":"","sources":["../../../src/lib/use-merge-ref/use-merge-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAW,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC;AAEvD,KAAK,WAAW,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AACzC,KAAK,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;AAEtC,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,UAAU,CAM7E;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAuBtE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAEzE"}

package/eslint.config.mjs

@@ -0,0 +1,22 @@
+import baseConfig from '../../eslint.config.mjs';
+
+export default [
+  ...baseConfig,
+  {
+    files: ['**/*.json'],
+    rules: {
+      '@nx/dependency-checks': [
+        'error',
+        {
+          ignoredFiles: [
+            '{projectRoot}/eslint.config.{js,cjs,mjs}',
+            '{projectRoot}/vite.config.{js,ts,mjs,mts}',
+          ],
+        },
+      ],
+    },
+    languageOptions: {
+      parser: await import('jsonc-eslint-parser'),
+    },
+  },
+];

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@ledgerhq/lumen-utils-shared",
+  "version": "0.0.11",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "nx": {
+    "tags": [
+      "scope:shared",
+      "type:utils"
+    ]
+  },
+  "dependencies": {
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^2.6.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  }
+}

package/project.json

@@ -0,0 +1,7 @@
+{
+  "name": "@ledgerhq/lumen-utils-shared",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/utils-shared/src",
+  "projectType": "library",
+  "tags": ["scope:shared", "type:utils"]
+}

package/src/index.ts

@@ -0,0 +1,7 @@
+export * from './lib/string-utils/string-utils';
+export * from './lib/input-formatter';
+export * from './lib/create-safe-context';
+export * from './lib/cn';
+export * from './lib/is-text-children';
+export * from './lib/use-merge-ref';
+export * from './lib/get-object-path';

package/src/lib/cn.ts

@@ -0,0 +1,6 @@
+import { ClassValue, clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

package/src/lib/create-safe-context/create-safe-context.test.tsx

@@ -0,0 +1,69 @@
+import { cleanup, render } from '@testing-library/react';
+import React from 'react';
+import { createSafeContext } from './create-safe-context.js';
+
+afterEach(() => {
+  cleanup();
+});
+
+describe('createSafeContext', () => {
+  it('throws when used without provider and contextRequired = true', () => {
+    type Ctx = { value?: number };
+    const [, useSafe] = createSafeContext<Ctx>('RootComponent');
+
+    const Consumer = () => {
+      // This should throw because contextRequired is true and there is no Provider
+      useSafe({ consumerName: 'Consumer', contextRequired: true });
+      return null;
+    };
+
+    expect(() => render(React.createElement(Consumer))).toThrow(
+      'Consumer must be used within RootComponent',
+    );
+  });
+
+  it('returns default context when not wrapped and contextRequired = false', () => {
+    type Ctx = { value: number };
+    const defaultCtx: Ctx = { value: 42 };
+    const [, useSafe] = createSafeContext<Ctx>('RootComponent', defaultCtx);
+
+    const Consumer = () => {
+      const ctx = useSafe({ consumerName: 'Consumer', contextRequired: false });
+      return React.createElement('span', { 'data-testid': 'value' }, ctx.value);
+    };
+
+    const { getByTestId } = render(React.createElement(Consumer));
+    expect(getByTestId('value').textContent).toBe('42');
+  });
+
+  it('provides context value via Provider when wrapped', () => {
+    type Ctx = { value: number };
+    const [Provider, useSafe] = createSafeContext<Ctx>('RootComponent');
+
+    const Consumer = () => {
+      const ctx = useSafe({ consumerName: 'Consumer', contextRequired: false });
+      return React.createElement(
+        'span',
+        { 'data-testid': 'value' },
+        String(ctx.value),
+      );
+    };
+
+    const { getByTestId, rerender } = render(
+      React.createElement(Provider, {
+        value: { value: 7 },
+        children: React.createElement(Consumer),
+      }),
+    );
+    expect(getByTestId('value').textContent).toBe('7');
+
+    // Verify updates propagate
+    rerender(
+      React.createElement(Provider, {
+        value: { value: 8 },
+        children: React.createElement(Consumer),
+      }),
+    );
+    expect(getByTestId('value').textContent).toBe('8');
+  });
+});

package/src/lib/create-safe-context/create-safe-context.tsx

@@ -0,0 +1,46 @@
+import { createContext, FC, ReactNode, useContext, useMemo } from 'react';
+
+export function createSafeContext<ContextValue extends object>(
+  rootComponentName: string,
+  defaultContext?: ContextValue,
+) {
+  const Context = createContext<ContextValue | undefined>(defaultContext);
+
+  const Provider: FC<{
+    children: ReactNode;
+    value: ContextValue;
+  }> = ({ children, value: context }) => {
+    // Only re-memoize when prop values change
+    const memoValue = useMemo(
+      () => context,
+      Object.values(context ?? {}),
+    ) as ContextValue;
+
+    return <Context.Provider value={memoValue}>{children}</Context.Provider>;
+  };
+
+  Provider.displayName = rootComponentName + 'Provider';
+
+  function useSafeContext<ContextRequired extends boolean = boolean>({
+    consumerName,
+    contextRequired,
+  }: {
+    consumerName: string;
+    contextRequired: ContextRequired;
+  }): ContextRequired extends true ? ContextValue : Partial<ContextValue> {
+    const context = useContext(Context);
+
+    if (context) {
+      return context;
+    }
+    if (contextRequired) {
+      throw new Error(
+        `${consumerName} must be used within ${rootComponentName}`,
+      );
+    }
+
+    return (defaultContext || {}) as ContextValue;
+  }
+
+  return [Provider, useSafeContext] as const;
+}

package/src/lib/create-safe-context/index.ts

@@ -0,0 +1 @@
+export * from './create-safe-context';

package/src/lib/get-object-path/get-object-path.test.ts

@@ -0,0 +1,72 @@
+import { describe, it, expect } from 'vitest';
+import { getObjectPath } from './get-object-path';
+
+describe('getObjectPath', () => {
+  const testObj = {
+    colors: {
+      bg: {
+        surface: '#ffffff',
+        accent: '#0000ff',
+      },
+      text: {
+        base: '#000000',
+      },
+    },
+    spacings: {
+      s4: 4,
+      s8: 8,
+      s16: 16,
+    },
+    nested: {
+      deep: {
+        value: 'found',
+      },
+    },
+  };
+
+  it('should access single level path', () => {
+    expect(getObjectPath(testObj, ['spacings'])).toEqual({
+      s4: 4,
+      s8: 8,
+      s16: 16,
+    });
+  });
+
+  it('should access two level path', () => {
+    expect(getObjectPath(testObj, ['colors', 'bg'])).toEqual({
+      surface: '#ffffff',
+      accent: '#0000ff',
+    });
+  });
+
+  it('should access three level path', () => {
+    expect(getObjectPath(testObj, ['colors', 'bg', 'surface'])).toBe('#ffffff');
+  });
+
+  it('should access deeply nested path', () => {
+    expect(getObjectPath(testObj, ['nested', 'deep', 'value'])).toBe('found');
+  });
+
+  it('should return undefined for non-existent path', () => {
+    expect(getObjectPath(testObj, ['nonexistent'])).toBeUndefined();
+    expect(getObjectPath(testObj, ['colors', 'nonexistent'])).toBeUndefined();
+    expect(
+      getObjectPath(testObj, ['colors', 'bg', 'nonexistent']),
+    ).toBeUndefined();
+  });
+
+  it('should return undefined for path through non-object', () => {
+    expect(
+      getObjectPath(testObj, ['spacings', 's4', 'invalid']),
+    ).toBeUndefined();
+  });
+
+  it('should handle empty path', () => {
+    expect(getObjectPath(testObj, [])).toEqual(testObj);
+  });
+
+  it('should work with type parameter', () => {
+    const result = getObjectPath<string>(testObj, ['colors', 'bg', 'surface']);
+    expect(result).toBe('#ffffff');
+  });
+});