@dxos/plugin-deck 0.8.3 → 0.8.4-main.03d5cd7b56

package/dist/types/src/util/index.d.ts

@@ -1,4 +1,5 @@
 export * from './layoutAppliesTopbar';
-export * from './overscroll';
+export * from './plank-url-params';
+export * from './sanitize-persisted-state';
 export * from './set-active';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/util/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/util/index.ts"],"names":[],"mappings":"AAIA,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/util/index.ts"],"names":[],"mappings":"AAIA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC"}

package/dist/types/src/util/layoutAppliesTopbar.d.ts

@@ -1,3 +1,3 @@
-import { type LayoutMode } from '../types';
+import { type LayoutMode } from '#types';
 export declare const layoutAppliesTopbar: (breakpoint: string, layoutMode?: LayoutMode) => boolean;
 //# sourceMappingURL=layoutAppliesTopbar.d.ts.map

package/dist/types/src/util/layoutAppliesTopbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layoutAppliesTopbar.d.ts","sourceRoot":"","sources":["../../../../src/util/layoutAppliesTopbar.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,EAAE,aAAa,UAAU,YAM9E,CAAC"}
+{"version":3,"file":"layoutAppliesTopbar.d.ts","sourceRoot":"","sources":["../../../../src/util/layoutAppliesTopbar.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,eAAO,MAAM,mBAAmB,eAAgB,MAAM,eAAe,UAAU,YAM9E,CAAC"}

package/dist/types/src/util/plank-url-params.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Serialize deck active qualified IDs into a URL search string.
+ * Preserves non-plank query params from the existing search string.
+ */
+export declare const serializePlanks: (active: readonly string[], existingSearch: string) => string;
+/**
+ * Deserialize plank query params from a URL back to qualified graph IDs.
+ */
+export declare const deserializePlanks: (url: URL) => string[];
+/**
+ * Strip plank query params from a search string, preserving all others.
+ */
+export declare const stripPlanks: (existingSearch: string) => string;
+//# sourceMappingURL=plank-url-params.d.ts.map

package/dist/types/src/util/plank-url-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plank-url-params.d.ts","sourceRoot":"","sources":["../../../../src/util/plank-url-params.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,eAAO,MAAM,eAAe,WAAY,SAAS,MAAM,EAAE,kBAAkB,MAAM,KAAG,MAOnF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAS,GAAG,KAAG,MAAM,EAElD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,mBAAoB,MAAM,KAAG,MAIpD,CAAC"}

package/dist/types/src/util/plank-url-params.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plank-url-params.test.d.ts.map

package/dist/types/src/util/plank-url-params.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plank-url-params.test.d.ts","sourceRoot":"","sources":["../../../../src/util/plank-url-params.test.ts"],"names":[],"mappings":""}

package/dist/types/src/util/sanitize-persisted-state.d.ts

@@ -0,0 +1,19 @@
+import { type StoredDeckState } from '#types';
+/**
+ * Sanitizes persisted deck state on startup.
+ *
+ * Persisted state may contain values that are inappropriate to restore across sessions:
+ *
+ * - **Fullscreen**: Cleared unconditionally to prevent the user from getting stuck in fullscreen
+ *   mode if the app was closed (or crashed) while fullscreen was active.
+ *
+ * - **Active planks in solo-mode decks**: When a deck is in solo mode, any items in `active`
+ *   represent planks that were kept mounted (hidden) during the session for fast deck↔solo
+ *   switching. After a restart these planks would need to fully remount anyway, so retaining
+ *   them only adds unnecessary load. Clearing `active` for solo-mode decks avoids rendering
+ *   stale planks in the background on startup.
+ *
+ * Returns a new state object if any changes were made, or the original state if clean.
+ */
+export declare const sanitizePersistedState: (state: StoredDeckState) => StoredDeckState;
+//# sourceMappingURL=sanitize-persisted-state.d.ts.map

package/dist/types/src/util/sanitize-persisted-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-persisted-state.d.ts","sourceRoot":"","sources":["../../../../src/util/sanitize-persisted-state.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE9C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,UAAW,eAAe,KAAG,eA6B/D,CAAC"}

package/dist/types/src/util/sanitize-persisted-state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sanitize-persisted-state.test.d.ts.map

package/dist/types/src/util/sanitize-persisted-state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-persisted-state.test.d.ts","sourceRoot":"","sources":["../../../../src/util/sanitize-persisted-state.test.ts"],"names":[],"mappings":""}

package/dist/types/src/util/set-active.d.ts

@@ -1,9 +1,24 @@
-import { type AttentionManager } from '@dxos/plugin-attention';
-import { type DeckPluginState } from '../types';
+import { type AttentionManager } from '@dxos/react-ui-attention';
+import { type DeckState } from '#types';
 export type SetActiveOptions = {
     next: string[];
-    state: DeckPluginState;
+    deck: DeckState;
     attention?: AttentionManager;
 };
-export declare const setActive: ({ next, state, attention }: SetActiveOptions) => string | undefined;
+export type SetActiveResult = {
+    /** Updates to apply to the deck. */
+    deckUpdates: {
+        inactive: string[];
+        solo: string | undefined;
+        active: string[];
+        fullscreen: boolean;
+    };
+    /** ID of the item to attend (scroll into view) if attention changed. */
+    toAttend?: string;
+};
+/**
+ * Computes the new active state for the deck without mutating.
+ * Returns the updates to apply and optionally an item to attend.
+ */
+export declare const computeActiveUpdates: ({ next, deck, attention }: SetActiveOptions) => SetActiveResult;
 //# sourceMappingURL=set-active.d.ts.map

package/dist/types/src/util/set-active.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set-active.d.ts","sourceRoot":"","sources":["../../../../src/util/set-active.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,4BAA4B,gBAAgB,uBA8BrE,CAAC"}
+{"version":3,"file":"set-active.d.ts","sourceRoot":"","sources":["../../../../src/util/set-active.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,oCAAoC;IACpC,WAAW,EAAE;QACX,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,8BAA+B,gBAAgB,KAAG,eAoClF,CAAC"}

package/dist/types/src/util/set-active.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=set-active.test.d.ts.map

package/dist/types/src/util/set-active.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-active.test.d.ts","sourceRoot":"","sources":["../../../../src/util/set-active.test.ts"],"names":[],"mappings":""}