@nexus-aethra/dshell-std 0.1.3 → 0.1.5

package/lib/index.js

@@ -17,6 +17,7 @@
 export * from './contracts.js';
 export * from './data-root.js';
 export * from './host-copy.js';
+export * from './session-view.js';
 export * from './shell-line.js';
 export * from './storage.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}

package/lib/session-view.js

@@ -0,0 +1,36 @@
+/**
+ * Which Session the main view is holding.
+ *
+ * The host's rule, taken once. `0.1.5-rc.2` published the Session on screen as
+ * `sessions.list.current`; `0.1.6-alpha.2` removed that field, because a Client
+ * may now hold several generations at once and no service owns "the one on
+ * screen" — navigation belongs to view owners. What replaced the field is
+ * RETENTION: the surface displaying a Session claims it with
+ * `retain(target, { source: 'mainView' })`, and the Session on screen is the row
+ * whose `mainView` count is positive.
+ *
+ * The derivation is what the host itself repeats wherever it needs the answer —
+ * `ui-workspace/tree.ts`, `ui-layout/DocumentTitle.tsx`, `ui-session`,
+ * `ui-settings-general` all write it out — so reading it here is not a dshell
+ * invention, it is the same reading taken once instead of once per package.
+ *
+ * `undefined` means no view holds a Session: on a page that has not navigated
+ * yet, and in the window between a release and the next retain.
+ */
+/**
+ * The Session the main view is holding, by the host's own rule.
+ * @param rows - the session-list rows, in any order.
+ * @returns the held Session's id, or undefined when no view holds one.
+ */
+export function mainSessionId(rows) {
+    for (const row of rows) {
+        // The cast is the point of the structural parameter: the host publishes a
+        // frozen partial record whose source names are its own, and the one this
+        // rule reads is `mainView`.
+        const counts = row.retainedBy;
+        if ((counts?.mainView ?? 0) > 0)
+            return row.id;
+    }
+    return undefined;
+}
+//# sourceMappingURL=session-view.js.map

package/lib/session-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-view.js","sourceRoot":"","sources":["../src/session-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAoBH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAK,IAAsC;IACtE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,0EAA0E;QAC1E,yEAAyE;QACzE,4BAA4B;QAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,UAAsE,CAAA;QACzF,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC,EAAE,CAAA;IAChD,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/lib/types/index.d.ts

@@ -17,6 +17,7 @@
 export * from './contracts.js';
 export * from './data-root.js';
 export * from './host-copy.js';
+export * from './session-view.js';
 export * from './shell-line.js';
 export * from './storage.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}

package/lib/types/session-view.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Which Session the main view is holding.
+ *
+ * The host's rule, taken once. `0.1.5-rc.2` published the Session on screen as
+ * `sessions.list.current`; `0.1.6-alpha.2` removed that field, because a Client
+ * may now hold several generations at once and no service owns "the one on
+ * screen" — navigation belongs to view owners. What replaced the field is
+ * RETENTION: the surface displaying a Session claims it with
+ * `retain(target, { source: 'mainView' })`, and the Session on screen is the row
+ * whose `mainView` count is positive.
+ *
+ * The derivation is what the host itself repeats wherever it needs the answer —
+ * `ui-workspace/tree.ts`, `ui-layout/DocumentTitle.tsx`, `ui-session`,
+ * `ui-settings-general` all write it out — so reading it here is not a dshell
+ * invention, it is the same reading taken once instead of once per package.
+ *
+ * `undefined` means no view holds a Session: on a page that has not navigated
+ * yet, and in the window between a release and the next retain.
+ */
+/**
+ * The fields the rule reads.
+ *
+ * Structural rather than imported: `dshell-std` is the layer allowed to care
+ * about how dsh spells things, and the cheapest way to keep that true is to
+ * state the fields instead of depending on the package that owns them.
+ */
+export interface RetainedSessionRow<Id> {
+    readonly id: Id;
+    /**
+     * The host's retention counts. Left as `object` rather than spelled out: the
+     * host types them as a partial record of its own source names, and restating
+     * that here would tie this module to the package that owns it — which is the
+     * dependency this layer exists to avoid.
+     */
+    readonly retainedBy?: object | undefined;
+}
+/**
+ * The Session the main view is holding, by the host's own rule.
+ * @param rows - the session-list rows, in any order.
+ * @returns the held Session's id, or undefined when no view holds one.
+ */
+export declare function mainSessionId<Id>(rows: Iterable<RetainedSessionRow<Id>>): Id | undefined;
+//# sourceMappingURL=session-view.d.ts.map

package/lib/types/session-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-view.d.ts","sourceRoot":"","sources":["../../src/session-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB,CAAC,EAAE;IACpC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAA;IACf;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACzC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,SAAS,CASxF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-aethra/dshell-std",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "dshell standard layer: the wire contracts every plugin shares (paths + shapes), with no dependency on dsh and no feature code — the single place a dsh interface change is absorbed.",
   "license": "MIT",
   "repository": {