@monotykamary/dsh-client-ui-trajectory 0.1.0-rc.5

package/lib/types/client/trajectory-search-index.d.ts

@@ -0,0 +1,20 @@
+/** Incremental full-text index for the trajectory ledger. */
+import type { TrajectoryTurnModel } from './layout.ts';
+/** Session-view-local index that reparses Markdown only when one record's source changes. */
+export declare class TrajectorySearchIndex {
+    private readonly entries;
+    private layouts;
+    /**
+     * Incrementally synchronize one or more current trajectory layout slices.
+     * @param layouts - Finalized and optional streaming layouts from the same view.
+     * @returns Whether the indexed layout version changed.
+     */
+    update(layouts: readonly (readonly TrajectoryTurnModel[])[]): boolean;
+    /**
+     * Match a query against the latest committed index version.
+     * @param query - Space-separated case-insensitive search terms.
+     * @returns Matching stable record identities, or `null` without a query.
+     */
+    search(query: string): ReadonlySet<string> | null;
+}
+//# sourceMappingURL=trajectory-search-index.d.ts.map

package/lib/types/client/trajectory-snapshot-builder.d.ts

@@ -0,0 +1,29 @@
+import type { Context } from '@monotykamary/cordis';
+import type { ConversationViewBuilder, ConversationViewDefinition } from '@monotykamary/dsh-client-runtime/client';
+import type { TrajectoryConversationViewNode, TrajectorySnapshot } from './trajectory-contract.ts';
+/** Stable empty target used until a Session has assembled Trajectory records. */
+export declare const EMPTY_TRAJECTORY_SNAPSHOT: TrajectorySnapshot;
+/** Simple keyed adapter retaining the old Trajectory snapshot and stage layout. */
+export declare class TrajectorySnapshotBuilder implements ConversationViewBuilder<TrajectoryConversationViewNode, TrajectorySnapshot> {
+    private readonly nodes;
+    private readonly positions;
+    private contributions;
+    readonly empty: TrajectorySnapshot;
+    replace(input: {
+        readonly nodes: readonly TrajectoryConversationViewNode[];
+    }): TrajectorySnapshot;
+    apply(input: {
+        readonly upserts: readonly TrajectoryConversationViewNode[];
+    }): TrajectorySnapshot;
+    private snapshot;
+    private rebuildContributions;
+}
+/** Trajectory target factory preserving the existing stage-oriented view model. */
+export declare const trajectoryViewDefinition: ConversationViewDefinition<TrajectoryConversationViewNode, TrajectorySnapshot>;
+/**
+ * Register the stage-oriented Trajectory target builder.
+ *
+ * @param ctx - Plugin context receiving the view Definition.
+ */
+export declare function registerTrajectoryConversationView(ctx: Context): void;
+//# sourceMappingURL=trajectory-snapshot-builder.d.ts.map

package/lib/types/client/trajectory-tool-definition.d.ts

@@ -0,0 +1,8 @@
+import type { Context } from '@monotykamary/cordis';
+/**
+ * Register the Trajectory Tool lifecycle.
+ *
+ * @param ctx - Plugin context receiving the Definition.
+ */
+export declare function registerTrajectoryToolDefinition(ctx: Context): void;
+//# sourceMappingURL=trajectory-tool-definition.d.ts.map

package/lib/types/client/trajectory-virtual-rows.d.ts

@@ -0,0 +1,34 @@
+/** Pure projection from trajectory records to measurable virtual ledger rows. */
+import type { TrajectoryCellProps } from './trajectory-record.ts';
+/** Minimal record shape required by the trajectory virtual-row projection. */
+export interface VirtualizableTrajectoryRecord {
+    cell: TrajectoryCellProps;
+    collapsedSummaryKind?: 'turn' | 'assistant';
+}
+/** One logical record retained inside a measurable virtual row. */
+export interface TrajectoryVirtualRowEntry<T extends VirtualizableTrajectoryRecord> {
+    logicalIndex: number;
+    record: T;
+}
+/** One virtualizer item, which may carry zero-height request boundaries. */
+export interface TrajectoryVirtualRow<T extends VirtualizableTrajectoryRecord> {
+    entries: readonly TrajectoryVirtualRowEntry<T>[];
+    height: number;
+    key: string;
+}
+/**
+ * Derive the DOM-safe row identity shared by React, the virtualizer, and
+ * browser scroll contracts.
+ * @param record - Display record whose identity is required.
+ * @returns Stable record identity with a suffix for synthetic fold summaries.
+ */
+export declare function trajectoryVirtualRecordKey(record: VirtualizableTrajectoryRecord): string;
+/**
+ * Attach separator-only records to the next content row so the virtualizer
+ * never owns a zero-height item. A terminal separator retains its CSS-owned
+ * lower-marker clearance as a standalone item.
+ * @param records - Final search/fold projection in ledger order.
+ * @returns Measurable virtual rows with original logical positions retained.
+ */
+export declare function groupTrajectoryVirtualRows<T extends VirtualizableTrajectoryRecord>(records: readonly T[]): readonly TrajectoryVirtualRow<T>[];
+//# sourceMappingURL=trajectory-virtual-rows.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,4 @@
+/** Host loader entry for the browser-only trajectory plugin. */
+/** Provides no host-side behavior. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@monotykamary/dsh-client-ui-trajectory`.
+ * @module @monotykamary/dsh-client-ui-trajectory/invariant
+ */
+import type { Context } from '@monotykamary/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-trajectory-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@monotykamary/dsh-client-ui-trajectory",
+  "description": "Trajectory event ledger with an interactive timing overview: pure-consumer plugin registering into the conversation ViewMap (no service)",
+  "version": "0.1.0-rc.5",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-trajectory"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@monotykamary/dsh-client-locale",
+        "@monotykamary/dsh-client-runtime",
+        "@monotykamary/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@tanstack/react-virtual": "^3.14.9",
+    "diff": "^9.0.0"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "@monotykamary/dsh-agent": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-locale": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-runtime": "^0.1.0-rc.5",
+    "@monotykamary/dsh-invariants": "^0.1.0-rc.5",
+    "@monotykamary/dsh-compaction": "^0.1.0-rc.5",
+    "@monotykamary/dsh-tools": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-primitives": "^0.1.0-rc.5",
+    "@monotykamary/cordis": "^4.0.1"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "@monotykamary/dsh-agent": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-conversation": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-primitives": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-runtime": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-test-runtime": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-locale": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-slots": "^0.1.0-rc.5",
+    "@monotykamary/cordis": "^4.0.1",
+    "@monotykamary/dsh-invariants": "^0.1.0-rc.5",
+    "@monotykamary/dsh-tools": "^0.1.0-rc.5",
+    "@monotykamary/dsh-compaction": "^0.1.0-rc.5"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}