@judo/guards 0.1.0

package/LICENSE

@@ -0,0 +1,277 @@
+Eclipse Public License - v 2.0
+
+    THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+    PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION
+    OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.
+
+1. DEFINITIONS
+
+"Contribution" means:
+
+  a) in the case of the initial Contributor, the initial content
+     Distributed under this Agreement, and
+
+  b) in the case of each subsequent Contributor:
+     i) changes to the Program, and
+     ii) additions to the Program;
+  where such changes and/or additions to the Program originate from
+  and are Distributed by that particular Contributor. A Contribution
+  "originates" from a Contributor if it was added to the Program by
+  such Contributor itself or anyone acting on such Contributor's behalf.
+  Contributions do not include changes or additions to the Program that
+  are not Modified Works.
+
+"Contributor" means any person or entity that Distributes the Program.
+
+"Licensed Patents" mean patent claims licensable by a Contributor which
+are necessarily infringed by the use or sale of its Contribution alone
+or when combined with the Program.
+
+"Program" means the Contributions Distributed in accordance with this
+Agreement.
+
+"Recipient" means anyone who receives the Program under this Agreement
+or any Secondary License (as applicable), including Contributors.
+
+"Derivative Works" shall mean any work, whether in Source Code or other
+form, that is based on (or derived from) the Program and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship.
+
+"Modified Works" shall mean any work in Source Code or other form that
+results from an addition to, deletion from, or modification of the
+contents of the Program, including, for purposes of clarity any new file
+in Source Code form that contains any contents of the Program. Modified
+Works shall not include works that contain only declarations,
+interfaces, types, classes, structures, or files of the Program solely
+in each case in order to link to, bind by name, or subclass the Program
+or Modified Works thereof.
+
+"Distribute" means the acts of a) distributing or b) making available
+in any manner that enables the transfer of a copy.
+
+"Source Code" means the form of a Program preferred for making
+modifications, including but not limited to software source code,
+documentation source, and configuration files.
+
+"Secondary License" means either the GNU General Public License,
+Version 2.0, or any later versions of that license, including any
+exceptions or additional permissions as identified by the initial
+Contributor.
+
+2. GRANT OF RIGHTS
+
+  a) Subject to the terms of this Agreement, each Contributor hereby
+  grants Recipient a non-exclusive, worldwide, royalty-free copyright
+  license to reproduce, prepare Derivative Works of, publicly display,
+  publicly perform, Distribute and sublicense the Contribution of such
+  Contributor, if any, and such Derivative Works.
+
+  b) Subject to the terms of this Agreement, each Contributor hereby
+  grants Recipient a non-exclusive, worldwide, royalty-free patent
+  license under Licensed Patents to make, use, sell, offer to sell,
+  import and otherwise transfer the Contribution of such Contributor,
+  if any, in Source Code or other form. This patent license shall
+  apply to the combination of the Contribution and the Program if, at
+  the time the Contribution is added by the Contributor, such addition
+  of the Contribution causes such combination to be covered by the
+  Licensed Patents. The patent license shall not apply to any other
+  combinations which include the Contribution. No hardware per se is
+  licensed hereunder.
+
+  c) Recipient understands that although each Contributor grants the
+  licenses to its Contributions set forth herein, no assurances are
+  provided by any Contributor that the Program does not infringe the
+  patent or other intellectual property rights of any other entity.
+  Each Contributor disclaims any liability to Recipient for claims
+  brought by any other entity based on infringement of intellectual
+  property rights or otherwise. As a condition to exercising the
+  rights and licenses granted hereunder, each Recipient hereby
+  assumes sole responsibility to secure any other intellectual
+  property rights needed, if any. For example, if a third party
+  patent license is required to allow Recipient to Distribute the
+  Program, it is Recipient's responsibility to acquire that license
+  before distributing the Program.
+
+  d) Each Contributor represents that to its knowledge it has
+  sufficient copyright rights in its Contribution, if any, to grant
+  the copyright license set forth in this Agreement.
+
+  e) Notwithstanding the terms of any Secondary License, no
+  Contributor makes additional grants to any Recipient (other than
+  those set forth in this Agreement) as a result of such Recipient's
+  receipt of the Program under the terms of a Secondary License
+  (if permitted under the terms of Section 3).
+
+3. REQUIREMENTS
+
+3.1 If a Contributor Distributes the Program in any form, then:
+
+  a) the Program must also be made available as Source Code, in
+  accordance with section 3.2, and the Contributor must accompany
+  the Program with a statement that the Source Code for the Program
+  is available under this Agreement, and informs Recipients how to
+  obtain it in a reasonable manner on or through a medium customarily
+  used for software exchange; and
+
+  b) the Contributor may Distribute the Program under a license
+  different than this Agreement, provided that such license:
+     i) effectively disclaims on behalf of all other Contributors all
+     warranties and conditions, express and implied, including
+     warranties or conditions of title and non-infringement, and
+     implied warranties or conditions of merchantability and fitness
+     for a particular purpose;
+
+     ii) effectively excludes on behalf of all other Contributors all
+     liability for damages, including direct, indirect, special,
+     incidental and consequential damages, such as lost profits;
+
+     iii) does not attempt to limit or alter the recipients' rights
+     in the Source Code under section 3.2; and
+
+     iv) requires any subsequent distribution of the Program by any
+     party to be under a license that satisfies the requirements
+     of this section 3.
+
+3.2 When the Program is Distributed as Source Code:
+
+  a) it must be made available under this Agreement, or if the
+  Program (i) is combined with other material in a separate file or
+  files made available under a Secondary License, and (ii) the initial
+  Contributor attached to the Source Code the notice described in
+  Exhibit A of this Agreement, then the Program may be made available
+  under the terms of such Secondary Licenses, and
+
+  b) a copy of this Agreement must be included with each copy of
+  the Program.
+
+3.3 Contributors may not remove or alter any copyright, patent,
+trademark, attribution notices, disclaimers of warranty, or limitations
+of liability ("notices") contained within the Program from any copy of
+the Program which they Distribute, provided that Contributors may add
+their own appropriate notices.
+
+4. COMMERCIAL DISTRIBUTION
+
+Commercial distributors of software may accept certain responsibilities
+with respect to end users, business partners and the like. While this
+license is intended to facilitate the commercial use of the Program,
+the Contributor who includes the Program in a commercial product
+offering should do so in a manner which does not create potential
+liability for other Contributors. Therefore, if a Contributor includes
+the Program in a commercial product offering, such Contributor
+("Commercial Contributor") hereby agrees to defend and indemnify every
+other Contributor ("Indemnified Contributor") against any losses,
+damages and costs (collectively "Losses") arising from claims, lawsuits
+and other legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such
+Commercial Contributor in connection with its distribution of the Program
+in a commercial product offering. The obligations in this section do not
+apply to any claims or Losses relating to any actual or alleged
+intellectual property infringement. In order to qualify, an Indemnified
+Contributor must: a) promptly notify the Commercial Contributor in
+writing of such claim, and b) allow the Commercial Contributor to control,
+and cooperate with the Commercial Contributor in, the defense and any
+related settlement negotiations. The Indemnified Contributor may
+participate in any such claim at its own expense.
+
+For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor's responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those performance
+claims and warranties, and if a court requires any other Contributor to
+pay any damages as a result, the Commercial Contributor must pay
+those damages.
+
+5. NO WARRANTY
+
+EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT
+PERMITTED BY APPLICABLE LAW, THE PROGRAM IS PROVIDED ON AN "AS IS"
+BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR
+IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF
+TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+PURPOSE. Each Recipient is solely responsible for determining the
+appropriateness of using and distributing the Program and assumes all
+risks associated with its exercise of rights under this Agreement,
+including but not limited to the risks and costs of program errors,
+compliance with applicable laws, damage to or loss of data, programs
+or equipment, and unavailability or interruption of operations.
+
+6. DISCLAIMER OF LIABILITY
+
+EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT
+PERMITTED BY APPLICABLE LAW, NEITHER RECIPIENT NOR ANY CONTRIBUTORS
+SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST
+PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE
+EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+7. GENERAL
+
+If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further
+action by the parties hereto, such provision shall be reformed to the
+minimum extent necessary to make such provision valid and enforceable.
+
+If Recipient institutes patent litigation against any entity
+(including a cross-claim or counterclaim in a lawsuit) alleging that the
+Program itself (excluding combinations of the Program with other software
+or hardware) infringes such Recipient's patent(s), then such Recipient's
+rights granted under Section 2(b) shall terminate as of the date such
+litigation is filed.
+
+All Recipient's rights under this Agreement shall terminate if it
+fails to comply with any of the material terms or conditions of this
+Agreement and does not cure such failure in a reasonable period of
+time after becoming aware of such noncompliance. If all Recipient's
+rights under this Agreement terminate, Recipient agrees to cease use
+and distribution of the Program as soon as reasonably practicable.
+However, Recipient's obligations under this Agreement and any licenses
+granted by Recipient relating to the Program shall continue and survive.
+
+Everyone is permitted to copy and distribute copies of this Agreement,
+but in order to avoid inconsistency the Agreement is copyrighted and
+may only be modified in the following manner. The Agreement Steward
+reserves the right to publish new versions (including revisions) of
+this Agreement from time to time. No one other than the Agreement
+Steward has the right to modify this Agreement. The Eclipse Foundation
+is the initial Agreement Steward. The Eclipse Foundation may assign the
+responsibility to serve as the Agreement Steward to a suitable separate
+entity. Each new version of the Agreement will be given a distinguishing
+version number. The Program (including Contributions) may always be
+Distributed subject to the version of the Agreement under which it was
+received. In addition, after a new version of the Agreement is published,
+Contributor may elect to Distribute the Program (including its
+Contributions) under the new version.
+
+Except as expressly stated in Sections 2(a) and 2(b) above, Recipient
+receives no rights or licenses to the intellectual property of any
+Contributor under this Agreement, whether expressly, by implication,
+estoppel or otherwise. All rights in the Program not expressly granted
+under this Agreement are reserved. Nothing in this Agreement is intended
+to be enforceable by any entity that is not a Contributor or Recipient.
+No third-party beneficiary rights are created under this Agreement.
+
+Exhibit A - Form of Secondary Licenses Notice
+
+"This Source Code may also be made available under the following 
+Secondary Licenses when the conditions for such availability set forth 
+in the Eclipse Public License, v. 2.0 are satisfied: {name license(s),
+version(s), and exceptions or additional permissions here}."
+
+  Simply including a copy of this Agreement, including this Exhibit A
+  is not sufficient to license the Source Code under Secondary Licenses.
+
+  If it is not possible or desirable to put the notice in a particular
+  file, then You may include the notice in a location (such as a LICENSE
+  file in a relevant directory) where a recipient would be likely to
+  look for such a notice.
+
+  You may add additional accurate notices of copyright ownership.

package/README.md

@@ -0,0 +1,89 @@
+# @judo/guards
+
+> Navigation guards for JUDO UI Runtime
+
+## Purpose
+
+Provides two runtime guard mechanisms:
+
+1. **Unsaved Changes Guard** — prevents navigation away from dirty forms, with browser `beforeunload` support
+2. **Session Timeout Guard** — monitors user inactivity, shows a warning dialog before session expiry, and forces logout on timeout
+
+## Architecture Layer
+
+**Layer 4 (Features)** — consumed by `app-shell` and `core` for navigation protection.
+
+## Dependencies
+
+- `@judo/model-api` — model type definitions (peer)
+- `@judo/feedback` — dialog service for confirmation dialogs (peer)
+- `@mui/material ^7` — MUI components for session timeout dialog (peer)
+- `react ^19` — React (peer)
+- `react-router ^7` — routing (peer)
+
+## File Structure
+
+```
+src/
+├── index.ts                              # Barrel re-exports
+├── unsaved-changes/
+│   ├── unsaved-changes-guard.ts          # Interface + class
+│   ├── use-unsaved-changes-guard.ts      # React hook
+│   ├── unsaved-changes-guard.test.ts
+│   └── use-unsaved-changes-guard.test.tsx
+└── session-timeout/
+    ├── session-timeout-guard.ts          # Interface + config + class
+    ├── session-timeout-dialog.tsx         # React component
+    ├── session-timeout-guard.test.tsx
+    └── session-timeout-dialog.test.tsx
+```
+
+## Exports Summary
+
+### Unsaved Changes Guard
+
+| Export                                   | Kind      | Description                                                                                                 |
+| ---------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------- |
+| `UnsavedChangesGuard`                    | interface | Interface for managing unsaved-changes warnings across multiple forms/pages.                                |
+| `UnsavedChangesGuardImpl`                | class     | Concrete implementation. Stores dirty-checkers in a `Map`. Uses `DialogService` for confirmation.           |
+| `useUnsavedChangesGuard(guard, isDirty)` | hook      | Registers the component with the guard when dirty. Attaches browser `beforeunload` handler. Auto-cleans up. |
+
+**`UnsavedChangesGuard` methods:**
+
+| Method                  | Returns            | Description                                                                  |
+| ----------------------- | ------------------ | ---------------------------------------------------------------------------- |
+| `hasUnsavedChanges()`   | `boolean`          | Iterates all registered dirty-checkers; returns `true` if any is dirty.      |
+| `register(id, isDirty)` | `() => void`       | Registers a form/page by ID with a dirty callback. Returns cleanup function. |
+| `unregister(id)`        | `void`             | Removes a previously registered dirty-checker.                               |
+| `confirmNavigation()`   | `Promise<boolean>` | If dirty, shows a confirm dialog; resolves `true` if user chooses to leave.  |
+
+### Session Timeout Guard
+
+| Export                      | Kind      | Description                                                                                                                    |
+| --------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| `SessionTimeoutGuard`       | interface | Interface for monitoring user inactivity and triggering timeout flows.                                                         |
+| `SessionTimeoutConfig`      | interface | Configuration: `timeoutMs?` (default: 30 min), `warningMs?` (default: 5 min), `onTimeout?`, `onWarning?`. All fields optional. |
+| `SessionTimeoutGuardImpl`   | class     | Implementation with timer cascade and DOM activity listeners.                                                                  |
+| `SessionTimeoutDialog`      | component | MUI Dialog showing either "Session Expiring" (with continue/logout) or "Session Expired" (with login).                         |
+| `SessionTimeoutDialogProps` | interface | Props: `guard`, `onLogout`.                                                                                                    |
+
+**`SessionTimeoutGuard` methods:**
+
+| Method                | Returns      | Description                                                                                                      |
+| --------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------- |
+| `start()`             | `void`       | Begins monitoring; attaches DOM listeners (`mousedown`, `keydown`, `scroll`, `touchstart`) and schedules timers. |
+| `stop()`              | `void`       | Clears timers, detaches listeners, resets state, notifies subscribers.                                           |
+| `resetActivity()`     | `void`       | Resets inactivity timer (no-op if already timed out).                                                            |
+| `isTimedOut()`        | `boolean`    | Returns current timed-out state.                                                                                 |
+| `subscribe(listener)` | `() => void` | Subscribes to `(isWarning, isTimedOut)` state changes; returns unsubscribe function.                             |
+
+## Key Patterns
+
+- **Interface + Impl class**: Both guards define an interface and a separate `*Impl` class, enabling DI and testability
+- **Manual pub/sub**: `SessionTimeoutGuardImpl` uses a `Set<listener>` with `subscribe` returning unsubscribe — compatible with `useSyncExternalStore`
+- **`useSyncExternalStore`**: `SessionTimeoutDialog` bridges the imperative guard to React's concurrent-safe external store API
+- **`useId` for registration**: `useUnsavedChangesGuard` uses React 18+ `useId` for a stable, unique registration key
+- **Browser `beforeunload`**: The unsaved-changes hook traps browser-level navigation (tab close, refresh)
+- **Timer cascade**: Session timeout uses a two-phase timer: `scheduleWarning()` fires first (at `timeoutMs - warningMs`), then chains to `scheduleTimeout()` which fires after the remaining `warningMs` window. On timeout, activity listeners are detached.
+- **No React context/provider**: Guards are plain classes passed as props or hook arguments — no provider in this package
+- **Dependency on `@judo/feedback`**: `UnsavedChangesGuardImpl` takes a `DialogService` for confirmation dialogs

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { type UnsavedChangesGuard, UnsavedChangesGuardImpl, useUnsavedChangesGuard } from './unsaved-changes';
+export { type SessionTimeoutGuard, type SessionTimeoutConfig, SessionTimeoutGuardImpl, SessionTimeoutDialog, type SessionTimeoutDialogProps, } from './session-timeout';
+//# 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":"AACA,OAAO,EAAE,KAAK,mBAAmB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAG9G,OAAO,EACN,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,KAAK,yBAAyB,GAC9B,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,156 @@
+import { useCallback, useEffect, useId, useState, useSyncExternalStore } from "react";
+import Button from "@mui/material/Button";
+import Dialog from "@mui/material/Dialog";
+import DialogActions from "@mui/material/DialogActions";
+import DialogContent from "@mui/material/DialogContent";
+import DialogContentText from "@mui/material/DialogContentText";
+import DialogTitle from "@mui/material/DialogTitle";
+import { jsx, jsxs } from "react/jsx-runtime";
+var UnsavedChangesGuardImpl = class {
+	dirtyCheckers = /* @__PURE__ */ new Map();
+	dialogService;
+	constructor(e) {
+		this.dialogService = e;
+	}
+	hasUnsavedChanges() {
+		for (let [, e] of this.dirtyCheckers) if (e()) return !0;
+		return !1;
+	}
+	register(e, l) {
+		return this.dirtyCheckers.set(e, l), () => this.unregister(e);
+	}
+	unregister(e) {
+		this.dirtyCheckers.delete(e);
+	}
+	async confirmNavigation() {
+		return this.hasUnsavedChanges() ? this.dialogService.confirm({
+			title: "Unsaved Changes",
+			message: "You have unsaved changes. Are you sure you want to leave?",
+			confirmText: "Leave",
+			cancelText: "Stay",
+			destructive: !0
+		}) : !0;
+	}
+};
+function useUnsavedChangesGuard(e, d) {
+	let f = useId();
+	useEffect(() => {
+		if (d) return e.register(f, () => d);
+	}, [
+		d,
+		e,
+		f
+	]), useEffect(() => {
+		if (!d) return;
+		let e = (e) => {
+			e.preventDefault();
+		};
+		return window.addEventListener("beforeunload", e), () => window.removeEventListener("beforeunload", e);
+	}, [d]);
+}
+var DEFAULT_TIMEOUT_MS = 1800 * 1e3, DEFAULT_WARNING_MS = 300 * 1e3, SessionTimeoutGuardImpl = class {
+	config;
+	timeoutId = null;
+	warningTimeoutId = null;
+	lastActivity = Date.now();
+	isWarningState = !1;
+	isTimedOutState = !1;
+	listeners = /* @__PURE__ */ new Set();
+	activityEvents = [
+		"mousedown",
+		"keydown",
+		"scroll",
+		"touchstart"
+	];
+	boundResetActivity;
+	constructor(e = {}) {
+		this.config = {
+			timeoutMs: e.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+			warningMs: e.warningMs ?? DEFAULT_WARNING_MS,
+			onTimeout: e.onTimeout ?? (() => {}),
+			onWarning: e.onWarning ?? (() => {})
+		}, this.boundResetActivity = this.resetActivity.bind(this);
+	}
+	start() {
+		this.lastActivity = Date.now(), this.isWarningState = !1, this.isTimedOutState = !1, this.scheduleWarning(), this.attachActivityListeners();
+	}
+	stop() {
+		this.clearTimers(), this.detachActivityListeners(), this.isWarningState = !1, this.isTimedOutState = !1, this.notifyListeners();
+	}
+	resetActivity() {
+		this.isTimedOutState || (this.lastActivity = Date.now(), this.isWarningState = !1, this.clearTimers(), this.scheduleWarning(), this.notifyListeners());
+	}
+	isTimedOut() {
+		return this.isTimedOutState;
+	}
+	subscribe(e) {
+		return this.listeners.add(e), () => this.listeners.delete(e);
+	}
+	scheduleWarning() {
+		let e = this.config.timeoutMs - this.config.warningMs;
+		this.warningTimeoutId = setTimeout(() => {
+			this.isWarningState = !0, this.config.onWarning(), this.notifyListeners(), this.scheduleTimeout();
+		}, e);
+	}
+	scheduleTimeout() {
+		this.timeoutId = setTimeout(() => {
+			this.isTimedOutState = !0, this.config.onTimeout(), this.detachActivityListeners(), this.notifyListeners();
+		}, this.config.warningMs);
+	}
+	clearTimers() {
+		this.timeoutId &&= (clearTimeout(this.timeoutId), null), this.warningTimeoutId &&= (clearTimeout(this.warningTimeoutId), null);
+	}
+	attachActivityListeners() {
+		for (let e of this.activityEvents) window.addEventListener(e, this.boundResetActivity, { passive: !0 });
+	}
+	detachActivityListeners() {
+		for (let e of this.activityEvents) window.removeEventListener(e, this.boundResetActivity);
+	}
+	notifyListeners() {
+		for (let e of this.listeners) e(this.isWarningState, this.isTimedOutState);
+	}
+};
+function SessionTimeoutDialog({ guard: u, onLogout: p }) {
+	let m = useCallback((e) => u.subscribe(() => e()), [u]), h = useCallback(() => u.isTimedOut(), [u]), g = useSyncExternalStore(m, h, h), [_, v] = useState(!1);
+	useEffect(() => u.subscribe((e, l) => {
+		v(e && !l);
+	}), [u]);
+	let y = () => {
+		u.resetActivity();
+	}, b = () => {
+		u.stop(), p();
+	};
+	return _ && !g ? /* @__PURE__ */ jsxs(Dialog, {
+		open: !0,
+		"data-testid": "session-timeout-warning-dialog",
+		children: [
+			/* @__PURE__ */ jsx(DialogTitle, { children: "Session Expiring" }),
+			/* @__PURE__ */ jsx(DialogContent, { children: /* @__PURE__ */ jsx(DialogContentText, { children: "Your session is about to expire due to inactivity. Would you like to continue?" }) }),
+			/* @__PURE__ */ jsxs(DialogActions, { children: [/* @__PURE__ */ jsx(Button, {
+				onClick: b,
+				"data-testid": "session-timeout-logout-button",
+				children: "Log Out"
+			}), /* @__PURE__ */ jsx(Button, {
+				onClick: y,
+				variant: "contained",
+				autoFocus: !0,
+				"data-testid": "session-timeout-continue-button",
+				children: "Continue Session"
+			})] })
+		]
+	}) : g ? /* @__PURE__ */ jsxs(Dialog, {
+		open: !0,
+		"data-testid": "session-timeout-dialog",
+		children: [
+			/* @__PURE__ */ jsx(DialogTitle, { children: "Session Expired" }),
+			/* @__PURE__ */ jsx(DialogContent, { children: /* @__PURE__ */ jsx(DialogContentText, { children: "Your session has expired. Please log in again to continue." }) }),
+			/* @__PURE__ */ jsx(DialogActions, { children: /* @__PURE__ */ jsx(Button, {
+				onClick: b,
+				variant: "contained",
+				"data-testid": "session-timeout-login-button",
+				children: "Log In"
+			}) })
+		]
+	}) : null;
+}
+export { SessionTimeoutDialog, SessionTimeoutGuardImpl, UnsavedChangesGuardImpl, useUnsavedChangesGuard };

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/unsaved-changes/unsaved-changes-guard.ts","../src/unsaved-changes/use-unsaved-changes-guard.ts","../src/session-timeout/session-timeout-guard.ts","../src/session-timeout/session-timeout-dialog.tsx"],"sourcesContent":["import type { DialogService } from \"@judo/feedback\";\n\n/**\n * UnsavedChangesGuard interface for managing unsaved changes warnings.\n */\nexport interface UnsavedChangesGuard {\n\t/** Check if there are unsaved changes */\n\thasUnsavedChanges(): boolean;\n\n\t/** Register a form/page with unsaved changes check */\n\tregister(id: string, isDirty: () => boolean): () => void;\n\n\t/** Unregister a form/page */\n\tunregister(id: string): void;\n\n\t/** Prompt user and return true if navigation allowed */\n\tconfirmNavigation(): Promise<boolean>;\n}\n\n/**\n * Implementation of UnsavedChangesGuard.\n */\nexport class UnsavedChangesGuardImpl implements UnsavedChangesGuard {\n\tprivate dirtyCheckers = new Map<string, () => boolean>();\n\tprivate dialogService: DialogService;\n\n\tconstructor(dialogService: DialogService) {\n\t\tthis.dialogService = dialogService;\n\t}\n\n\thasUnsavedChanges(): boolean {\n\t\tfor (const [, isDirty] of this.dirtyCheckers) {\n\t\t\tif (isDirty()) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\t\treturn false;\n\t}\n\n\tregister(id: string, isDirty: () => boolean): () => void {\n\t\tthis.dirtyCheckers.set(id, isDirty);\n\t\treturn () => this.unregister(id);\n\t}\n\n\tunregister(id: string): void {\n\t\tthis.dirtyCheckers.delete(id);\n\t}\n\n\tasync confirmNavigation(): Promise<boolean> {\n\t\tif (!this.hasUnsavedChanges()) {\n\t\t\treturn true;\n\t\t}\n\n\t\treturn this.dialogService.confirm({\n\t\t\ttitle: \"Unsaved Changes\",\n\t\t\tmessage: \"You have unsaved changes. Are you sure you want to leave?\",\n\t\t\tconfirmText: \"Leave\",\n\t\t\tcancelText: \"Stay\",\n\t\t\tdestructive: true,\n\t\t});\n\t}\n}\n","import { useEffect, useId } from \"react\";\nimport type { UnsavedChangesGuard } from \"./unsaved-changes-guard\";\n\n/**\n * Hook to register unsaved changes for a form/page.\n */\nexport function useUnsavedChangesGuard(guard: UnsavedChangesGuard, isDirty: boolean) {\n\tconst id = useId();\n\n\t// Register with guard when dirty\n\tuseEffect(() => {\n\t\tif (isDirty) {\n\t\t\treturn guard.register(id, () => isDirty);\n\t\t}\n\t\treturn undefined;\n\t}, [isDirty, guard, id]);\n\n\t// Handle browser beforeunload\n\tuseEffect(() => {\n\t\tif (!isDirty) return;\n\n\t\tconst handleBeforeUnload = (e: BeforeUnloadEvent) => {\n\t\t\te.preventDefault();\n\t\t};\n\n\t\twindow.addEventListener(\"beforeunload\", handleBeforeUnload);\n\t\treturn () => window.removeEventListener(\"beforeunload\", handleBeforeUnload);\n\t}, [isDirty]);\n}\n","/**\n * SessionTimeoutGuard interface for managing session timeout warnings.\n */\nexport interface SessionTimeoutGuard {\n\t/** Start monitoring for session timeout */\n\tstart(): void;\n\n\t/** Stop monitoring */\n\tstop(): void;\n\n\t/** Reset activity timer (called on user activity) */\n\tresetActivity(): void;\n\n\t/** Check if session is timed out */\n\tisTimedOut(): boolean;\n\n\t/** Subscribe to timeout state changes */\n\tsubscribe(listener: (isWarning: boolean, isTimedOut: boolean) => void): () => void;\n}\n\nexport interface SessionTimeoutConfig {\n\t/** Timeout duration in milliseconds (default: 30 minutes) */\n\ttimeoutMs?: number;\n\t/** Warning before timeout in milliseconds (default: 5 minutes) */\n\twarningMs?: number;\n\t/** Callback when session times out */\n\tonTimeout?: () => void;\n\t/** Callback when warning period starts */\n\tonWarning?: () => void;\n}\n\nconst DEFAULT_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes\nconst DEFAULT_WARNING_MS = 5 * 60 * 1000; // 5 minutes\n\n/**\n * Implementation of SessionTimeoutGuard.\n */\nexport class SessionTimeoutGuardImpl implements SessionTimeoutGuard {\n\tprivate config: Required<SessionTimeoutConfig>;\n\tprivate timeoutId: ReturnType<typeof setTimeout> | null = null;\n\tprivate warningTimeoutId: ReturnType<typeof setTimeout> | null = null;\n\tprivate lastActivity: number = Date.now();\n\tprivate isWarningState = false;\n\tprivate isTimedOutState = false;\n\tprivate listeners = new Set<(isWarning: boolean, isTimedOut: boolean) => void>();\n\tprivate activityEvents = [\"mousedown\", \"keydown\", \"scroll\", \"touchstart\"];\n\tprivate boundResetActivity: () => void;\n\n\tconstructor(config: SessionTimeoutConfig = {}) {\n\t\tthis.config = {\n\t\t\ttimeoutMs: config.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n\t\t\twarningMs: config.warningMs ?? DEFAULT_WARNING_MS,\n\t\t\tonTimeout: config.onTimeout ?? (() => {}),\n\t\t\tonWarning: config.onWarning ?? (() => {}),\n\t\t};\n\t\tthis.boundResetActivity = this.resetActivity.bind(this);\n\t}\n\n\tstart(): void {\n\t\tthis.lastActivity = Date.now();\n\t\tthis.isWarningState = false;\n\t\tthis.isTimedOutState = false;\n\t\tthis.scheduleWarning();\n\t\tthis.attachActivityListeners();\n\t}\n\n\tstop(): void {\n\t\tthis.clearTimers();\n\t\tthis.detachActivityListeners();\n\t\tthis.isWarningState = false;\n\t\tthis.isTimedOutState = false;\n\t\tthis.notifyListeners();\n\t}\n\n\tresetActivity(): void {\n\t\tif (this.isTimedOutState) return;\n\n\t\tthis.lastActivity = Date.now();\n\t\tthis.isWarningState = false;\n\t\tthis.clearTimers();\n\t\tthis.scheduleWarning();\n\t\tthis.notifyListeners();\n\t}\n\n\tisTimedOut(): boolean {\n\t\treturn this.isTimedOutState;\n\t}\n\n\tsubscribe(listener: (isWarning: boolean, isTimedOut: boolean) => void): () => void {\n\t\tthis.listeners.add(listener);\n\t\treturn () => this.listeners.delete(listener);\n\t}\n\n\tprivate scheduleWarning(): void {\n\t\tconst warningTime = this.config.timeoutMs - this.config.warningMs;\n\t\tthis.warningTimeoutId = setTimeout(() => {\n\t\t\tthis.isWarningState = true;\n\t\t\tthis.config.onWarning();\n\t\t\tthis.notifyListeners();\n\t\t\tthis.scheduleTimeout();\n\t\t}, warningTime);\n\t}\n\n\tprivate scheduleTimeout(): void {\n\t\tthis.timeoutId = setTimeout(() => {\n\t\t\tthis.isTimedOutState = true;\n\t\t\tthis.config.onTimeout();\n\t\t\tthis.detachActivityListeners();\n\t\t\tthis.notifyListeners();\n\t\t}, this.config.warningMs);\n\t}\n\n\tprivate clearTimers(): void {\n\t\tif (this.timeoutId) {\n\t\t\tclearTimeout(this.timeoutId);\n\t\t\tthis.timeoutId = null;\n\t\t}\n\t\tif (this.warningTimeoutId) {\n\t\t\tclearTimeout(this.warningTimeoutId);\n\t\t\tthis.warningTimeoutId = null;\n\t\t}\n\t}\n\n\tprivate attachActivityListeners(): void {\n\t\tfor (const event of this.activityEvents) {\n\t\t\twindow.addEventListener(event, this.boundResetActivity, { passive: true });\n\t\t}\n\t}\n\n\tprivate detachActivityListeners(): void {\n\t\tfor (const event of this.activityEvents) {\n\t\t\twindow.removeEventListener(event, this.boundResetActivity);\n\t\t}\n\t}\n\n\tprivate notifyListeners(): void {\n\t\tfor (const listener of this.listeners) {\n\t\t\tlistener(this.isWarningState, this.isTimedOutState);\n\t\t}\n\t}\n}\n","import Button from \"@mui/material/Button\";\nimport Dialog from \"@mui/material/Dialog\";\nimport DialogActions from \"@mui/material/DialogActions\";\nimport DialogContent from \"@mui/material/DialogContent\";\nimport DialogContentText from \"@mui/material/DialogContentText\";\nimport DialogTitle from \"@mui/material/DialogTitle\";\nimport { useCallback, useEffect, useState, useSyncExternalStore } from \"react\";\nimport type { SessionTimeoutGuard } from \"./session-timeout-guard\";\n\nexport interface SessionTimeoutDialogProps {\n\tguard: SessionTimeoutGuard;\n\tonLogout: () => void;\n}\n\n/**\n * Session timeout warning dialog component.\n */\nexport function SessionTimeoutDialog({ guard, onLogout }: SessionTimeoutDialogProps) {\n\t// Track state with refs updated via subscribe\n\tconst subscribe = useCallback(\n\t\t(callback: () => void) => {\n\t\t\treturn guard.subscribe(() => callback());\n\t\t},\n\t\t[guard]\n\t);\n\n\tconst getSnapshot = useCallback(() => {\n\t\treturn guard.isTimedOut();\n\t}, [guard]);\n\n\tconst isTimedOut = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n\t// For warning state, we need to track it via the guard's internal state\n\t// Since there's no isWarning() method, we'll add a separate subscription pattern\n\tconst [isWarning, setIsWarning] = useState(false);\n\n\tuseEffect(() => {\n\t\tconst unsub = guard.subscribe((warning, timedOut) => {\n\t\t\tsetIsWarning(warning && !timedOut);\n\t\t});\n\t\treturn unsub;\n\t}, [guard]);\n\n\tconst handleContinue = () => {\n\t\tguard.resetActivity();\n\t};\n\n\tconst handleLogout = () => {\n\t\tguard.stop();\n\t\tonLogout();\n\t};\n\n\t// Show warning dialog\n\tif (isWarning && !isTimedOut) {\n\t\treturn (\n\t\t\t<Dialog open data-testid=\"session-timeout-warning-dialog\">\n\t\t\t\t<DialogTitle>Session Expiring</DialogTitle>\n\t\t\t\t<DialogContent>\n\t\t\t\t\t<DialogContentText>\n\t\t\t\t\t\tYour session is about to expire due to inactivity. Would you like to continue?\n\t\t\t\t\t</DialogContentText>\n\t\t\t\t</DialogContent>\n\t\t\t\t<DialogActions>\n\t\t\t\t\t<Button onClick={handleLogout} data-testid=\"session-timeout-logout-button\">\n\t\t\t\t\t\tLog Out\n\t\t\t\t\t</Button>\n\t\t\t\t\t{/* oxlint-disable jsx-a11y/no-autofocus */}\n\t\t\t\t\t<Button onClick={handleContinue} variant=\"contained\" autoFocus data-testid=\"session-timeout-continue-button\">\n\t\t\t\t\t\tContinue Session\n\t\t\t\t\t</Button>\n\t\t\t\t\t{/* oxlint-enable jsx-a11y/no-autofocus */}\n\t\t\t\t</DialogActions>\n\t\t\t</Dialog>\n\t\t);\n\t}\n\n\t// Show timeout dialog\n\tif (isTimedOut) {\n\t\treturn (\n\t\t\t<Dialog open data-testid=\"session-timeout-dialog\">\n\t\t\t\t<DialogTitle>Session Expired</DialogTitle>\n\t\t\t\t<DialogContent>\n\t\t\t\t\t<DialogContentText>Your session has expired. Please log in again to continue.</DialogContentText>\n\t\t\t\t</DialogContent>\n\t\t\t\t<DialogActions>\n\t\t\t\t\t<Button onClick={handleLogout} variant=\"contained\" data-testid=\"session-timeout-login-button\">\n\t\t\t\t\t\tLog In\n\t\t\t\t\t</Button>\n\t\t\t\t</DialogActions>\n\t\t\t</Dialog>\n\t\t);\n\t}\n\n\treturn null;\n}\n"],"mappings":"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"}

package/dist/session-timeout/index.d.ts

@@ -0,0 +1,3 @@
+export { type SessionTimeoutGuard, type SessionTimeoutConfig, SessionTimeoutGuardImpl } from './session-timeout-guard';
+export { SessionTimeoutDialog, type SessionTimeoutDialogProps } from './session-timeout-dialog';
+//# sourceMappingURL=index.d.ts.map

package/dist/session-timeout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session-timeout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvH,OAAO,EAAE,oBAAoB,EAAE,KAAK,yBAAyB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/session-timeout/session-timeout-dialog.d.ts

@@ -0,0 +1,10 @@
+import { SessionTimeoutGuard } from './session-timeout-guard';
+export interface SessionTimeoutDialogProps {
+    guard: SessionTimeoutGuard;
+    onLogout: () => void;
+}
+/**
+ * Session timeout warning dialog component.
+ */
+export declare function SessionTimeoutDialog({ guard, onLogout }: SessionTimeoutDialogProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=session-timeout-dialog.d.ts.map

package/dist/session-timeout/session-timeout-dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-timeout-dialog.d.ts","sourceRoot":"","sources":["../../src/session-timeout/session-timeout-dialog.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,WAAW,yBAAyB;IACzC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,yBAAyB,kDA6ElF"}

package/dist/session-timeout/session-timeout-guard.d.ts

@@ -0,0 +1,52 @@
+/**
+ * SessionTimeoutGuard interface for managing session timeout warnings.
+ */
+export interface SessionTimeoutGuard {
+    /** Start monitoring for session timeout */
+    start(): void;
+    /** Stop monitoring */
+    stop(): void;
+    /** Reset activity timer (called on user activity) */
+    resetActivity(): void;
+    /** Check if session is timed out */
+    isTimedOut(): boolean;
+    /** Subscribe to timeout state changes */
+    subscribe(listener: (isWarning: boolean, isTimedOut: boolean) => void): () => void;
+}
+export interface SessionTimeoutConfig {
+    /** Timeout duration in milliseconds (default: 30 minutes) */
+    timeoutMs?: number;
+    /** Warning before timeout in milliseconds (default: 5 minutes) */
+    warningMs?: number;
+    /** Callback when session times out */
+    onTimeout?: () => void;
+    /** Callback when warning period starts */
+    onWarning?: () => void;
+}
+/**
+ * Implementation of SessionTimeoutGuard.
+ */
+export declare class SessionTimeoutGuardImpl implements SessionTimeoutGuard {
+    private config;
+    private timeoutId;
+    private warningTimeoutId;
+    private lastActivity;
+    private isWarningState;
+    private isTimedOutState;
+    private listeners;
+    private activityEvents;
+    private boundResetActivity;
+    constructor(config?: SessionTimeoutConfig);
+    start(): void;
+    stop(): void;
+    resetActivity(): void;
+    isTimedOut(): boolean;
+    subscribe(listener: (isWarning: boolean, isTimedOut: boolean) => void): () => void;
+    private scheduleWarning;
+    private scheduleTimeout;
+    private clearTimers;
+    private attachActivityListeners;
+    private detachActivityListeners;
+    private notifyListeners;
+}
+//# sourceMappingURL=session-timeout-guard.d.ts.map

package/dist/session-timeout/session-timeout-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-timeout-guard.d.ts","sourceRoot":"","sources":["../../src/session-timeout/session-timeout-guard.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,2CAA2C;IAC3C,KAAK,IAAI,IAAI,CAAC;IAEd,sBAAsB;IACtB,IAAI,IAAI,IAAI,CAAC;IAEb,qDAAqD;IACrD,aAAa,IAAI,IAAI,CAAC;IAEtB,oCAAoC;IACpC,UAAU,IAAI,OAAO,CAAC;IAEtB,yCAAyC;IACzC,SAAS,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACnF;AAED,MAAM,WAAW,oBAAoB;IACpC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAKD;;GAEG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IAClE,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,SAAS,CAAgE;IACjF,OAAO,CAAC,cAAc,CAAoD;IAC1E,OAAO,CAAC,kBAAkB,CAAa;gBAE3B,MAAM,GAAE,oBAAyB;IAU7C,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;IAQZ,aAAa,IAAI,IAAI;IAUrB,UAAU,IAAI,OAAO;IAIrB,SAAS,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAKlF,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,eAAe;CAKvB"}

package/dist/unsaved-changes/index.d.ts

@@ -0,0 +1,3 @@
+export { type UnsavedChangesGuard, UnsavedChangesGuardImpl } from './unsaved-changes-guard';
+export { useUnsavedChangesGuard } from './use-unsaved-changes-guard';
+//# sourceMappingURL=index.d.ts.map

package/dist/unsaved-changes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/unsaved-changes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/unsaved-changes/unsaved-changes-guard.d.ts

@@ -0,0 +1,27 @@
+import { DialogService } from '@judo/feedback';
+/**
+ * UnsavedChangesGuard interface for managing unsaved changes warnings.
+ */
+export interface UnsavedChangesGuard {
+    /** Check if there are unsaved changes */
+    hasUnsavedChanges(): boolean;
+    /** Register a form/page with unsaved changes check */
+    register(id: string, isDirty: () => boolean): () => void;
+    /** Unregister a form/page */
+    unregister(id: string): void;
+    /** Prompt user and return true if navigation allowed */
+    confirmNavigation(): Promise<boolean>;
+}
+/**
+ * Implementation of UnsavedChangesGuard.
+ */
+export declare class UnsavedChangesGuardImpl implements UnsavedChangesGuard {
+    private dirtyCheckers;
+    private dialogService;
+    constructor(dialogService: DialogService);
+    hasUnsavedChanges(): boolean;
+    register(id: string, isDirty: () => boolean): () => void;
+    unregister(id: string): void;
+    confirmNavigation(): Promise<boolean>;
+}
+//# sourceMappingURL=unsaved-changes-guard.d.ts.map

package/dist/unsaved-changes/unsaved-changes-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsaved-changes-guard.d.ts","sourceRoot":"","sources":["../../src/unsaved-changes/unsaved-changes-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,yCAAyC;IACzC,iBAAiB,IAAI,OAAO,CAAC;IAE7B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC;IAEzD,6BAA6B;IAC7B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,wDAAwD;IACxD,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IAClE,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,aAAa,CAAgB;gBAEzB,aAAa,EAAE,aAAa;IAIxC,iBAAiB,IAAI,OAAO;IAS5B,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,MAAM,IAAI;IAKxD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAItB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;CAa3C"}

package/dist/unsaved-changes/use-unsaved-changes-guard.d.ts

@@ -0,0 +1,6 @@
+import { UnsavedChangesGuard } from './unsaved-changes-guard';
+/**
+ * Hook to register unsaved changes for a form/page.
+ */
+export declare function useUnsavedChangesGuard(guard: UnsavedChangesGuard, isDirty: boolean): void;
+//# sourceMappingURL=use-unsaved-changes-guard.d.ts.map

package/dist/unsaved-changes/use-unsaved-changes-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-unsaved-changes-guard.d.ts","sourceRoot":"","sources":["../../src/unsaved-changes/use-unsaved-changes-guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,QAsBlF"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@judo/guards",
+  "version": "0.1.0",
+  "description": "Navigation guards for JUDO UI Runtime",
+  "license": "EPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BlackBeltTechnology/judo-frontend-runtime.git",
+    "directory": "packages/guards"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@judo/feedback": "0.1.0",
+    "@judo/model-api": "0.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.2.14",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18",
+    "@judo/feedback": "0.1.0",
+    "@judo/model-api": "0.1.0",
+    "@judo/testing": "0.1.0"
+  },
+  "peerDependencies": {
+    "@mui/material": "^7.0.0",
+    "react": "^19.0.0",
+    "react-router": "^7.0.0",
+    "@judo/feedback": "0.1.0",
+    "@judo/model-api": "0.1.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "type-check": "tsgo --noEmit"
+  }
+}