@nexus-aethra/dshell-std 0.1.3 → 0.1.4

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,7 +1,7 @@
 {
   "name": "@nexus-aethra/dshell-std",
-  "version": "0.1.3",
-  "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.",
+  "version": "0.1.4",
+  "description": "dshell standard layer: the wire contracts every plugin shares (paths + shapes), with no dependency on dsh and no feature code \u2014 the single place a dsh interface change is absorbed.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -17,6 +17,10 @@
       "default": "./lib/index.js"
     }
   },
+  "scripts": {
+    "build": "tsc -p tsconfig.json --emitDeclarationOnly false",
+    "build:host": "tsc -p tsconfig.json --emitDeclarationOnly false"
+  },
   "files": [
     "lib"
   ],
@@ -27,9 +31,5 @@
   "peerDependencies": {},
   "devDependencies": {
     "typescript": "^6.0.3"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json --emitDeclarationOnly false",
-    "build:host": "tsc -p tsconfig.json --emitDeclarationOnly false"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Nexus Aethra
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.