@venizia/ardor-admin 0.4.4 → 0.4.6-0

package/dist/hooks/use-document-title.d.ts

@@ -4,11 +4,18 @@ export interface IUseDocumentTitleOptions {
     appTitle: string;
     separator?: string;
     enabled?: boolean;
+    /**
+     * A base title for a layout. It shows only while no other call is mounted, so a screen's title
+     * wins on the first mount although the layout's effect runs after the screen's. Of two fallbacks,
+     * the one mounted last shows. @default false
+     */
+    fallback?: boolean;
 }
 /**
  * Sets the tab title to the screen title before `appTitle` (`Orders · Back Office`). On unmount it
  * puts back the title it replaced - unless someone wrote a newer one since - so one call per screen
- * is enough, with no reset on navigation.
+ * is enough, with no reset on navigation. A layout passes `fallback: true` for a base title the
+ * screens override.
  */
 export declare const useDocumentTitle: (opts: IUseDocumentTitleOptions) => void;
 export {};

package/dist/hooks/use-document-title.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-document-title.d.ts","sourceRoot":"","sources":["../../src/hooks/use-document-title.ts"],"names":[],"mappings":"AAEA,KAAK,qBAAqB,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,qBAAqB,GAAG,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,wBAAwB,SAsB9D,CAAC"}
+{"version":3,"file":"use-document-title.d.ts","sourceRoot":"","sources":["../../src/hooks/use-document-title.ts"],"names":[],"mappings":"AAEA,KAAK,qBAAqB,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,qBAAqB,GAAG,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA+DD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,wBAAwB,SAkB9D,CAAC"}

package/dist/hooks/use-document-title.js

@@ -1,26 +1,67 @@
 import React from 'react';
+// The calls mounted now, in the order they registered, with the tab title before the first one and
+// the title this module wrote last: the last is how a later writer outside the hook is recognised.
+const entries = [];
+let originalTitle;
+let writtenTitle;
+/** The last screen title mounted; with none, the last fallback. */
+const resolveTitle = () => {
+    let fallback;
+    for (let index = entries.length - 1; index >= 0; index--) {
+        const entry = entries[index];
+        if (!entry.isFallback) {
+            return entry.title;
+        }
+        fallback ??= entry.title;
+    }
+    return fallback;
+};
+const writeTitle = () => {
+    writtenTitle = resolveTitle();
+    if (writtenTitle !== undefined) {
+        document.title = writtenTitle;
+    }
+};
+const register = (entry) => {
+    if (entries.length === 0) {
+        originalTitle = document.title;
+    }
+    entries.push(entry);
+    writeTitle();
+};
+const unregister = (entry) => {
+    entries.splice(entries.indexOf(entry), 1);
+    if (entries.length > 0) {
+        writeTitle();
+        return;
+    }
+    // Restore only our own write: a later writer (a layout re-mounted for a new locale, or a twin
+    // call React cleans up first) owns the title now.
+    if (originalTitle !== undefined && document.title === writtenTitle) {
+        document.title = originalTitle;
+    }
+    originalTitle = undefined;
+    writtenTitle = undefined;
+};
 /**
  * Sets the tab title to the screen title before `appTitle` (`Orders · Back Office`). On unmount it
  * puts back the title it replaced - unless someone wrote a newer one since - so one call per screen
- * is enough, with no reset on navigation.
+ * is enough, with no reset on navigation. A layout passes `fallback: true` for a base title the
+ * screens override.
  */
 export const useDocumentTitle = (opts) => {
-    const { title, appTitle, separator = ' · ', enabled = true } = opts;
+    const { title, appTitle, separator = ' · ', enabled = true, fallback = false } = opts;
     const segments = Array.isArray(title) ? title : [title];
     const documentTitle = [...segments, appTitle].filter(Boolean).join(separator);
     React.useEffect(() => {
         if (!enabled) {
             return;
         }
-        const previousTitle = document.title;
-        document.title = documentTitle;
+        const entry = { title: documentTitle, isFallback: fallback };
+        register(entry);
         return () => {
-            // Restore only our own write: a later writer (a layout re-mounted for a new locale, or a twin
-            // call React cleans up first) owns the title now.
-            if (document.title === documentTitle) {
-                document.title = previousTitle;
-            }
+            unregister(entry);
         };
-    }, [enabled, documentTitle]);
+    }, [enabled, documentTitle, fallback]);
 };
 //# sourceMappingURL=use-document-title.js.map

package/dist/hooks/use-document-title.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-document-title.js","sourceRoot":"","sources":["../../src/hooks/use-document-title.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAW1B;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAA8B,EAAE,EAAE;IACjE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,GAAG,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAEpE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,CAAC,GAAG,QAAQ,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE9E,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC;QACrC,QAAQ,CAAC,KAAK,GAAG,aAAa,CAAC;QAE/B,OAAO,GAAG,EAAE;YACV,8FAA8F;YAC9F,kDAAkD;YAClD,IAAI,QAAQ,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;gBACrC,QAAQ,CAAC,KAAK,GAAG,aAAa,CAAC;YACjC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;AAC/B,CAAC,CAAC"}
+{"version":3,"file":"use-document-title.js","sourceRoot":"","sources":["../../src/hooks/use-document-title.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ardor-admin",
-  "version": "0.4.4",
+  "version": "0.4.6-0",
   "description": "ARDOR react-admin adapter - the REST data provider, auth provider and i18n provider wired through IGNIS inversion, the ArdorApplication root component, the translate and notify hooks, and the English and Vietnamese message bundles.",
   "keywords": [
     "admin",
@@ -60,8 +60,8 @@
     "prepublishOnly": "make rebuild"
   },
   "dependencies": {
-    "@venizia/ardor-kernel": "0.4.4",
-    "@venizia/ardor-react": "0.4.4",
+    "@venizia/ardor-kernel": "0.4.6-0",
+    "@venizia/ardor-react": "0.4.6-0",
     "lodash": "^4.18.1"
   },
   "devDependencies": {
@@ -73,11 +73,11 @@
     "@types/bun": "^1.4.3",
     "@types/lodash": "^4.17.27",
     "@types/react": "^19",
-    "@venizia/dev-configs": "^0.4.4",
-    "@venizia/ignis-filter": "^0.4.4",
-    "@venizia/ignis-helpers": "^0.4.4",
-    "@venizia/ignis-inversion": "^0.4.4",
-    "@venizia/ignis-kernel": "^0.4.4",
+    "@venizia/dev-configs": "^0.4.6-0",
+    "@venizia/ignis-filter": "^0.4.5-0",
+    "@venizia/ignis-helpers": "^0.4.6-0",
+    "@venizia/ignis-inversion": "^0.4.5-0",
+    "@venizia/ignis-kernel": "^0.4.6-0",
     "eslint": "^10.13.0",
     "oxlint": "1.89.0",
     "oxlint-tsgolint": "7.0.2004",