inspector-ng 0.0.7 → 0.0.10

package/README.md

@@ -11,9 +11,11 @@ Inspired by [ibelick](https://github.com/ibelick)'s original design.
 ## Installation
 
 ```bash
-npm install inspector-ng
+npm install inspector-ng@0.0.8 @ngrx/store@^17.2.0
 ```
 
+For a complete new-project walkthrough with copy-paste Store, Router, Redux DevTools, state, local-package, and troubleshooting examples, see the [setup guide](https://github.com/destx0/inspector/blob/main/SETUP_GUIDE.md).
+
 ## Getting Started
 
 ### Step 1: Import the component
@@ -58,43 +60,25 @@ That's it. Press **`M`** in your browser to open the inspector toolbar. No furth
 
 ### Developer checkpoints
 
-Checkpoints save the current Angular Router URL plus state you explicitly register. They do **not** record or replay HTTP requests.
+Add `@ngrx/store` and provide a single root Store before `provideInspectorCheckpoints()`:
 
 ```ts
 import { ApplicationConfig } from '@angular/core';
-import { BehaviorSubject } from 'rxjs';
-import {
-  createBehaviorSubjectCheckpointAdapter,
-  InspectorCheckpointRegistry,
-  provideInspectorCheckpoints,
-} from 'inspector-ng';
+import { provideRouter } from '@angular/router';
+import { provideStore } from '@ngrx/store';
+import { provideInspectorCheckpoints } from 'inspector-ng';
+import { routes } from './app.routes';
 
 export const appConfig: ApplicationConfig = {
-  providers: [provideInspectorCheckpoints()],
+  providers: [provideRouter(routes), provideStore(), provideInspectorCheckpoints()],
 };
 ```
 
-Register serializable state from an application service or component:
+Use the compact toolbar button to save the current JSON-serializable NgRx root state immediately. Use `Ctrl/Cmd+Shift+P` to open the fuzzy checkpoint finder. `F2` renames the selected record and `Delete` opens inline confirmation.
 
-```ts
-const application = new BehaviorSubject({ customerName: '', amount: 0 });
-const unregister = checkpointRegistry.register(
-  createBehaviorSubjectCheckpointAdapter('workflow:application', application),
-);
-```
+Records are stored per origin in IndexedDB database `inspector-ng`, object store `checkpoints`. This needs no browser permission prompt and does not map to a visible or fixed OS path. Nothing is evicted automatically. Existing `inspector-checkpoints-v1` localStorage records are deliberately ignored.
 
-Open the inspector and use the checkpoint button to save, restore, rename, or delete snapshots. Checkpoints use `localStorage`; when the browser quota is reached, the oldest checkpoint is removed to make room. Do not register sensitive values.
-
-For Native Federation, the shell owns `provideInspectorCheckpoints()`. Remotes receive the shell's `InspectorCheckpointRegistry` and register namespaced adapters such as `workflow:application`. The shell should register a remote loader for each scope so remotes are loaded before state is restored:
-
-```ts
-checkpointRegistry.registerRemoteScope('workflow', async () => {
-  const remote = await loadRemoteModule('workflow', './CheckpointAdapters');
-  remote.registerInspectorCheckpointAdapters(checkpointRegistry);
-});
-```
-
-Repeated remote adapter registration is safe, so a bridge may run before every restore. Share `inspector-ng` as a Native Federation singleton in both shell and remotes.
+A checkpoint contains the root Store value and current route. Restore dispatches `[Inspector Checkpoints] Restore`, then navigates through Angular Router to the saved route, so NgRx Store DevTools records the state change normally. It does not restore action history, component-local state, HTTP activity, or backend state. Native Redux DevTools Import/Export files remain separate and cannot be searched from the Inspector command bar.
 
 ### Inputs
 
@@ -129,6 +113,9 @@ Repeated remote adapter registration is safe, so a bridge may run before every r
 | `Ctrl/Cmd + Z` | Undo last guide change |
 | `Ctrl/Cmd + Shift + Z` | Redo guide change |
 | `Backspace` / `Delete` | Delete the selected guide |
+| `Ctrl/Cmd + Shift + P` | Search and restore checkpoints when configured |
+
+Tool shortcuts never run while the Inspector is disabled or while focus is inside a form control, form, editable region, or textbox-like editor. Modified application/browser shortcuts such as `Ctrl/Cmd+S` are not intercepted. `Ctrl/Cmd+Shift+P` is the only intentional exception and remains available from inputs and with the Inspector rail disabled.
 
 ## Features
 
@@ -148,6 +135,8 @@ Repeated remote adapter registration is safe, so a bridge may run before every r
 |---|---|
 | `@angular/core` | `^17.3.0` |
 | `@angular/common` | `^17.3.0` |
+| `@angular/router` | `^17.3.0` |
+| `@ngrx/store` | `^17.2.0` (peer dependency used only for checkpoints) |
 
 Built as a standalone component with signal-based reactivity and `OnPush` change detection.
 

package/esm2022/lib/checkpoint-search.mjs

@@ -0,0 +1,50 @@
+export function fuzzyCheckpoints(checkpoints, query) {
+    const normalizedQuery = normalize(query.trim());
+    if (!normalizedQuery)
+        return [...checkpoints].sort(newestFirst);
+    return checkpoints
+        .map((checkpoint) => {
+        const score = fuzzyScore(checkpoint.name, normalizedQuery);
+        return score === null ? null : { checkpoint, score };
+    })
+        .filter((item) => item !== null)
+        .sort((a, b) => b.score - a.score || newestFirst(a.checkpoint, b.checkpoint))
+        .map(({ checkpoint }) => checkpoint);
+}
+export function fuzzyScore(value, normalizedQuery) {
+    const candidate = normalize(value);
+    if (candidate === normalizedQuery)
+        return 10_000;
+    if (candidate.startsWith(normalizedQuery))
+        return 8_000 - candidate.length;
+    const substringIndex = candidate.indexOf(normalizedQuery);
+    if (substringIndex >= 0)
+        return 6_000 - substringIndex * 10 - candidate.length;
+    let queryIndex = 0;
+    let firstIndex = -1;
+    let lastIndex = -1;
+    let gapPenalty = 0;
+    for (let index = 0; index < candidate.length && queryIndex < normalizedQuery.length; index += 1) {
+        if (candidate[index] !== normalizedQuery[queryIndex])
+            continue;
+        if (firstIndex < 0)
+            firstIndex = index;
+        if (lastIndex >= 0)
+            gapPenalty += index - lastIndex - 1;
+        lastIndex = index;
+        queryIndex += 1;
+    }
+    if (queryIndex !== normalizedQuery.length)
+        return null;
+    return 4_000 - firstIndex * 10 - gapPenalty * 20 - candidate.length;
+}
+function normalize(value) {
+    return value
+        .normalize('NFKD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .toLocaleLowerCase();
+}
+function newestFirst(a, b) {
+    return b.createdAt.localeCompare(a.createdAt) || b.id.localeCompare(a.id);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hlY2twb2ludC1zZWFyY2guanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9wcm9qZWN0cy9pbnNwZWN0b3Itbmcvc3JjL2xpYi9jaGVja3BvaW50LXNlYXJjaC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFPQSxNQUFNLFVBQVUsZ0JBQWdCLENBQzlCLFdBQXdDLEVBQ3hDLEtBQWE7SUFFYixNQUFNLGVBQWUsR0FBRyxTQUFTLENBQUMsS0FBSyxDQUFDLElBQUksRUFBRSxDQUFDLENBQUM7SUFDaEQsSUFBSSxDQUFDLGVBQWU7UUFBRSxPQUFPLENBQUMsR0FBRyxXQUFXLENBQUMsQ0FBQyxJQUFJLENBQUMsV0FBVyxDQUFDLENBQUM7SUFFaEUsT0FBTyxXQUFXO1NBQ2YsR0FBRyxDQUFDLENBQUMsVUFBVSxFQUEyQixFQUFFO1FBQzNDLE1BQU0sS0FBSyxHQUFHLFVBQVUsQ0FBQyxVQUFVLENBQUMsSUFBSSxFQUFFLGVBQWUsQ0FBQyxDQUFDO1FBQzNELE9BQU8sS0FBSyxLQUFLLElBQUksQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxFQUFFLFVBQVUsRUFBRSxLQUFLLEVBQUUsQ0FBQztJQUN2RCxDQUFDLENBQUM7U0FDRCxNQUFNLENBQUMsQ0FBQyxJQUFJLEVBQTRCLEVBQUUsQ0FBQyxJQUFJLEtBQUssSUFBSSxDQUFDO1NBQ3pELElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxLQUFLLEdBQUcsQ0FBQyxDQUFDLEtBQUssSUFBSSxXQUFXLENBQUMsQ0FBQyxDQUFDLFVBQVUsRUFBRSxDQUFDLENBQUMsVUFBVSxDQUFDLENBQUM7U0FDNUUsR0FBRyxDQUFDLENBQUMsRUFBRSxVQUFVLEVBQUUsRUFBRSxFQUFFLENBQUMsVUFBVSxDQUFDLENBQUM7QUFDekMsQ0FBQztBQUVELE1BQU0sVUFBVSxVQUFVLENBQUMsS0FBYSxFQUFFLGVBQXVCO0lBQy9ELE1BQU0sU0FBUyxHQUFHLFNBQVMsQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUNuQyxJQUFJLFNBQVMsS0FBSyxlQUFlO1FBQUUsT0FBTyxNQUFNLENBQUM7SUFDakQsSUFBSSxTQUFTLENBQUMsVUFBVSxDQUFDLGVBQWUsQ0FBQztRQUFFLE9BQU8sS0FBSyxHQUFHLFNBQVMsQ0FBQyxNQUFNLENBQUM7SUFFM0UsTUFBTSxjQUFjLEdBQUcsU0FBUyxDQUFDLE9BQU8sQ0FBQyxlQUFlLENBQUMsQ0FBQztJQUMxRCxJQUFJLGNBQWMsSUFBSSxDQUFDO1FBQUUsT0FBTyxLQUFLLEdBQUcsY0FBYyxHQUFHLEVBQUUsR0FBRyxTQUFTLENBQUMsTUFBTSxDQUFDO0lBRS9FLElBQUksVUFBVSxHQUFHLENBQUMsQ0FBQztJQUNuQixJQUFJLFVBQVUsR0FBRyxDQUFDLENBQUMsQ0FBQztJQUNwQixJQUFJLFNBQVMsR0FBRyxDQUFDLENBQUMsQ0FBQztJQUNuQixJQUFJLFVBQVUsR0FBRyxDQUFDLENBQUM7SUFDbkIsS0FBSyxJQUFJLEtBQUssR0FBRyxDQUFDLEVBQUUsS0FBSyxHQUFHLFNBQVMsQ0FBQyxNQUFNLElBQUksVUFBVSxHQUFHLGVBQWUsQ0FBQyxNQUFNLEVBQUUsS0FBSyxJQUFJLENBQUMsRUFBRSxDQUFDO1FBQ2hHLElBQUksU0FBUyxDQUFDLEtBQUssQ0FBQyxLQUFLLGVBQWUsQ0FBQyxVQUFVLENBQUM7WUFBRSxTQUFTO1FBQy9ELElBQUksVUFBVSxHQUFHLENBQUM7WUFBRSxVQUFVLEdBQUcsS0FBSyxDQUFDO1FBQ3ZDLElBQUksU0FBUyxJQUFJLENBQUM7WUFBRSxVQUFVLElBQUksS0FBSyxHQUFHLFNBQVMsR0FBRyxDQUFDLENBQUM7UUFDeEQsU0FBUyxHQUFHLEtBQUssQ0FBQztRQUNsQixVQUFVLElBQUksQ0FBQyxDQUFDO0lBQ2xCLENBQUM7SUFDRCxJQUFJLFVBQVUsS0FBSyxlQUFlLENBQUMsTUFBTTtRQUFFLE9BQU8sSUFBSSxDQUFDO0lBQ3ZELE9BQU8sS0FBSyxHQUFHLFVBQVUsR0FBRyxFQUFFLEdBQUcsVUFBVSxHQUFHLEVBQUUsR0FBRyxTQUFTLENBQUMsTUFBTSxDQUFDO0FBQ3RFLENBQUM7QUFFRCxTQUFTLFNBQVMsQ0FBQyxLQUFhO0lBQzlCLE9BQU8sS0FBSztTQUNULFNBQVMsQ0FBQyxNQUFNLENBQUM7U0FDakIsT0FBTyxDQUFDLGtCQUFrQixFQUFFLEVBQUUsQ0FBQztTQUMvQixpQkFBaUIsRUFBRSxDQUFDO0FBQ3pCLENBQUM7QUFFRCxTQUFTLFdBQVcsQ0FBQyxDQUE0QixFQUFFLENBQTRCO0lBQzdFLE9BQU8sQ0FBQyxDQUFDLFNBQVMsQ0FBQyxhQUFhLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxFQUFFLENBQUMsYUFBYSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQztBQUM1RSxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgSW5zcGVjdG9yQ2hlY2twb2ludFJlY29yZCB9IGZyb20gJy4vY2hlY2twb2ludHMnO1xuXG5pbnRlcmZhY2UgUmFua2VkQ2hlY2twb2ludCB7XG4gIGNoZWNrcG9pbnQ6IEluc3BlY3RvckNoZWNrcG9pbnRSZWNvcmQ7XG4gIHNjb3JlOiBudW1iZXI7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBmdXp6eUNoZWNrcG9pbnRzKFxuICBjaGVja3BvaW50czogSW5zcGVjdG9yQ2hlY2twb2ludFJlY29yZFtdLFxuICBxdWVyeTogc3RyaW5nLFxuKTogSW5zcGVjdG9yQ2hlY2twb2ludFJlY29yZFtdIHtcbiAgY29uc3Qgbm9ybWFsaXplZFF1ZXJ5ID0gbm9ybWFsaXplKHF1ZXJ5LnRyaW0oKSk7XG4gIGlmICghbm9ybWFsaXplZFF1ZXJ5KSByZXR1cm4gWy4uLmNoZWNrcG9pbnRzXS5zb3J0KG5ld2VzdEZpcnN0KTtcblxuICByZXR1cm4gY2hlY2twb2ludHNcbiAgICAubWFwKChjaGVja3BvaW50KTogUmFua2VkQ2hlY2twb2ludCB8IG51bGwgPT4ge1xuICAgICAgY29uc3Qgc2NvcmUgPSBmdXp6eVNjb3JlKGNoZWNrcG9pbnQubmFtZSwgbm9ybWFsaXplZFF1ZXJ5KTtcbiAgICAgIHJldHVybiBzY29yZSA9PT0gbnVsbCA/IG51bGwgOiB7IGNoZWNrcG9pbnQsIHNjb3JlIH07XG4gICAgfSlcbiAgICAuZmlsdGVyKChpdGVtKTogaXRlbSBpcyBSYW5rZWRDaGVja3BvaW50ID0+IGl0ZW0gIT09IG51bGwpXG4gICAgLnNvcnQoKGEsIGIpID0+IGIuc2NvcmUgLSBhLnNjb3JlIHx8IG5ld2VzdEZpcnN0KGEuY2hlY2twb2ludCwgYi5jaGVja3BvaW50KSlcbiAgICAubWFwKCh7IGNoZWNrcG9pbnQgfSkgPT4gY2hlY2twb2ludCk7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBmdXp6eVNjb3JlKHZhbHVlOiBzdHJpbmcsIG5vcm1hbGl6ZWRRdWVyeTogc3RyaW5nKTogbnVtYmVyIHwgbnVsbCB7XG4gIGNvbnN0IGNhbmRpZGF0ZSA9IG5vcm1hbGl6ZSh2YWx1ZSk7XG4gIGlmIChjYW5kaWRhdGUgPT09IG5vcm1hbGl6ZWRRdWVyeSkgcmV0dXJuIDEwXzAwMDtcbiAgaWYgKGNhbmRpZGF0ZS5zdGFydHNXaXRoKG5vcm1hbGl6ZWRRdWVyeSkpIHJldHVybiA4XzAwMCAtIGNhbmRpZGF0ZS5sZW5ndGg7XG5cbiAgY29uc3Qgc3Vic3RyaW5nSW5kZXggPSBjYW5kaWRhdGUuaW5kZXhPZihub3JtYWxpemVkUXVlcnkpO1xuICBpZiAoc3Vic3RyaW5nSW5kZXggPj0gMCkgcmV0dXJuIDZfMDAwIC0gc3Vic3RyaW5nSW5kZXggKiAxMCAtIGNhbmRpZGF0ZS5sZW5ndGg7XG5cbiAgbGV0IHF1ZXJ5SW5kZXggPSAwO1xuICBsZXQgZmlyc3RJbmRleCA9IC0xO1xuICBsZXQgbGFzdEluZGV4ID0gLTE7XG4gIGxldCBnYXBQZW5hbHR5ID0gMDtcbiAgZm9yIChsZXQgaW5kZXggPSAwOyBpbmRleCA8IGNhbmRpZGF0ZS5sZW5ndGggJiYgcXVlcnlJbmRleCA8IG5vcm1hbGl6ZWRRdWVyeS5sZW5ndGg7IGluZGV4ICs9IDEpIHtcbiAgICBpZiAoY2FuZGlkYXRlW2luZGV4XSAhPT0gbm9ybWFsaXplZFF1ZXJ5W3F1ZXJ5SW5kZXhdKSBjb250aW51ZTtcbiAgICBpZiAoZmlyc3RJbmRleCA8IDApIGZpcnN0SW5kZXggPSBpbmRleDtcbiAgICBpZiAobGFzdEluZGV4ID49IDApIGdhcFBlbmFsdHkgKz0gaW5kZXggLSBsYXN0SW5kZXggLSAxO1xuICAgIGxhc3RJbmRleCA9IGluZGV4O1xuICAgIHF1ZXJ5SW5kZXggKz0gMTtcbiAgfVxuICBpZiAocXVlcnlJbmRleCAhPT0gbm9ybWFsaXplZFF1ZXJ5Lmxlbmd0aCkgcmV0dXJuIG51bGw7XG4gIHJldHVybiA0XzAwMCAtIGZpcnN0SW5kZXggKiAxMCAtIGdhcFBlbmFsdHkgKiAyMCAtIGNhbmRpZGF0ZS5sZW5ndGg7XG59XG5cbmZ1bmN0aW9uIG5vcm1hbGl6ZSh2YWx1ZTogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIHZhbHVlXG4gICAgLm5vcm1hbGl6ZSgnTkZLRCcpXG4gICAgLnJlcGxhY2UoL1tcXHUwMzAwLVxcdTAzNmZdL2csICcnKVxuICAgIC50b0xvY2FsZUxvd2VyQ2FzZSgpO1xufVxuXG5mdW5jdGlvbiBuZXdlc3RGaXJzdChhOiBJbnNwZWN0b3JDaGVja3BvaW50UmVjb3JkLCBiOiBJbnNwZWN0b3JDaGVja3BvaW50UmVjb3JkKTogbnVtYmVyIHtcbiAgcmV0dXJuIGIuY3JlYXRlZEF0LmxvY2FsZUNvbXBhcmUoYS5jcmVhdGVkQXQpIHx8IGIuaWQubG9jYWxlQ29tcGFyZShhLmlkKTtcbn1cbiJdfQ==