@burdenoff/microfe-assethandler 2026.713.1 → 2026.714.1

package/dist/assethandler/hooks/useCopy.d.ts

@@ -0,0 +1,28 @@
+type TranslationParams = Record<string, string | number>;
+/**
+ * Resolves a single piece of module copy.
+ *
+ * @param key      i18n key, e.g. "assethandler.dashboard.metrics.totalAssets".
+ * @param fallback The module's own English copy, used when neither the host nor
+ *                 the platform provides a string. May contain terminology
+ *                 tokens (see {@link useCopy}).
+ */
+export type CopyFn = (key: string, fallback: string, params?: TranslationParams) => string;
+/**
+ * Copy resolver for the module, in precedence order:
+ *
+ *   1. the host's `copy[key]` override (the `copy` prop on `AssetHandlerRoot`),
+ *   2. the platform translation for `key`, when the locale provides one,
+ *   3. the module's own default fallback.
+ *
+ * The resolved string then has its `{{asset}}` / `{{assets}}` /
+ * `{{assetLower}}` / `{{assetsLower}}` tokens substituted with the terminology
+ * from the `terminology` prop.
+ *
+ * With no `copy` and no `terminology` props the tokens resolve to
+ * "Asset"/"Assets"/"asset"/"assets", so output is identical to the module's
+ * previous `tWithFallback(t, key, fallback)` behaviour.
+ */
+export declare function useCopy(): CopyFn;
+export {};
+//# sourceMappingURL=useCopy.d.ts.map

package/dist/assethandler/hooks/useCopy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopy.d.ts","sourceRoot":"","sources":["../../../src/assethandler/hooks/useCopy.ts"],"names":[],"mappings":"AAKA,KAAK,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,KAAK,MAAM,CAAC;AAK3F;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAiChC"}

package/dist/assethandler/hooks/useCopy.js

@@ -0,0 +1,33 @@
+import { useAssetHandler as e, useAssetTerminology as t } from "../providers/AssetHandlerProvider.js";
+import { useCallback as n } from "react";
+import { useI18n as r } from "@burdenoff/fe-libs/shared/providers/shell/I18nProvider";
+//#region src/assethandler/hooks/useCopy.ts
+var i = /\{\{(asset|assets|assetLower|assetsLower)\}\}/g;
+function a() {
+	let { t: a } = r(), { copy: o } = e(), { asset: s, assets: c } = t();
+	return n((e, t, n) => {
+		let r = o?.[e];
+		if (r === void 0) {
+			let i = a(e, n);
+			r = i === e ? t : i;
+		}
+		return r.includes("{{") ? r.replace(i, (e, t) => {
+			switch (t) {
+				case "asset": return s;
+				case "assets": return c;
+				case "assetLower": return s.toLowerCase();
+				case "assetsLower": return c.toLowerCase();
+				default: return e;
+			}
+		}) : r;
+	}, [
+		o,
+		a,
+		s,
+		c
+	]);
+}
+//#endregion
+export { a as useCopy };
+
+//# sourceMappingURL=useCopy.js.map

package/dist/assethandler/hooks/useCopy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopy.js","names":[],"sources":["../../../src/assethandler/hooks/useCopy.ts"],"sourcesContent":["import { useCallback } from 'react';\nimport { useI18n } from '@burdenoff/fe-libs/shared/providers/shell/I18nProvider';\n\nimport { useAssetHandler, useAssetTerminology } from '../providers/AssetHandlerProvider';\n\ntype TranslationParams = Record<string, string | number>;\n\n/**\n * Resolves a single piece of module copy.\n *\n * @param key      i18n key, e.g. \"assethandler.dashboard.metrics.totalAssets\".\n * @param fallback The module's own English copy, used when neither the host nor\n *                 the platform provides a string. May contain terminology\n *                 tokens (see {@link useCopy}).\n */\nexport type CopyFn = (key: string, fallback: string, params?: TranslationParams) => string;\n\n/** Terminology tokens substituted into resolved copy. */\nconst TOKEN_PATTERN = /\\{\\{(asset|assets|assetLower|assetsLower)\\}\\}/g;\n\n/**\n * Copy resolver for the module, in precedence order:\n *\n *   1. the host's `copy[key]` override (the `copy` prop on `AssetHandlerRoot`),\n *   2. the platform translation for `key`, when the locale provides one,\n *   3. the module's own default fallback.\n *\n * The resolved string then has its `{{asset}}` / `{{assets}}` /\n * `{{assetLower}}` / `{{assetsLower}}` tokens substituted with the terminology\n * from the `terminology` prop.\n *\n * With no `copy` and no `terminology` props the tokens resolve to\n * \"Asset\"/\"Assets\"/\"asset\"/\"assets\", so output is identical to the module's\n * previous `tWithFallback(t, key, fallback)` behaviour.\n */\nexport function useCopy(): CopyFn {\n  const { t } = useI18n();\n  const { copy } = useAssetHandler();\n  const { asset, assets } = useAssetTerminology();\n\n  return useCallback(\n    (key: string, fallback: string, params?: TranslationParams): string => {\n      // 1. host override, 2. platform translation, 3. module fallback.\n      let resolved = copy?.[key];\n      if (resolved === undefined) {\n        const translated = t(key, params);\n        resolved = translated === key ? fallback : translated;\n      }\n\n      if (!resolved.includes('{{')) return resolved;\n\n      return resolved.replace(TOKEN_PATTERN, (_match, token: string) => {\n        switch (token) {\n          case 'asset':\n            return asset;\n          case 'assets':\n            return assets;\n          case 'assetLower':\n            return asset.toLowerCase();\n          case 'assetsLower':\n            return assets.toLowerCase();\n          default:\n            return _match;\n        }\n      });\n    },\n    [copy, t, asset, assets]\n  );\n}\n"],"mappings":";;;;AAkBA,IAAM,IAAgB;AAiBtB,SAAgB,IAAkB;CAChC,IAAM,EAAE,SAAM,GAAS,EACjB,EAAE,YAAS,GAAiB,EAC5B,EAAE,UAAO,cAAW,GAAqB;AAE/C,QAAO,GACJ,GAAa,GAAkB,MAAuC;EAErE,IAAI,IAAW,IAAO;AACtB,MAAI,MAAa,KAAA,GAAW;GAC1B,IAAM,IAAa,EAAE,GAAK,EAAO;AACjC,OAAW,MAAe,IAAM,IAAW;;AAK7C,SAFK,EAAS,SAAS,KAAK,GAErB,EAAS,QAAQ,IAAgB,GAAQ,MAAkB;AAChE,WAAQ,GAAR;IACE,KAAK,QACH,QAAO;IACT,KAAK,SACH,QAAO;IACT,KAAK,aACH,QAAO,EAAM,aAAa;IAC5B,KAAK,cACH,QAAO,EAAO,aAAa;IAC7B,QACE,QAAO;;IAEX,GAfmC;IAiBvC;EAAC;EAAM;EAAG;EAAO;EAAO,CACzB"}

package/dist/assethandler/index.d.ts

@@ -1,5 +1,5 @@
 export { AssetHandlerRoot } from './AssetHandlerRoot';
-export type { AssetHandlerRootProps, NavItem, FooterItem } from './types';
+export type { AssetHandlerRootProps, AssetHandlerCopy, AssetHandlerTerminology, NavItem, FooterItem, } from './types';
 export { useAssetHandler } from './providers/AssetHandlerProvider';
 export { useAssetHandlerStore } from './store/assethandlerStore';
 //# sourceMappingURL=index.d.ts.map

package/dist/assethandler/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assethandler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assethandler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,OAAO,EACP,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/assethandler/pages/AnalyticsPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsPage.d.ts","sourceRoot":"","sources":["../../../src/assethandler/pages/AnalyticsPage.tsx"],"names":[],"mappings":"AAqJA,wBAAgB,aAAa,gCA+rB5B"}
+{"version":3,"file":"AnalyticsPage.d.ts","sourceRoot":"","sources":["../../../src/assethandler/pages/AnalyticsPage.tsx"],"names":[],"mappings":"AAsJA,wBAAgB,aAAa,gCAgsB5B"}