opencode-flema-engram-sidebar 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,32 +1,35 @@
1
- # Flema Engram para OpenCode
1
+ # Flema Engram para OpenCode y Pi
2
2
 
3
3
  [![CI](https://github.com/oniricosistemas/flema-engram/actions/workflows/ci.yml/badge.svg)](https://github.com/oniricosistemas/flema-engram/actions/workflows/ci.yml)
4
4
  [![npm](https://img.shields.io/npm/v/opencode-flema-engram-sidebar?logo=npm)](https://www.npmjs.com/package/opencode-flema-engram-sidebar)
5
5
  [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D22-339933?logo=nodedotjs&logoColor=white)](https://nodejs.org/)
6
6
  [![License: MIT](https://img.shields.io/github/license/oniricosistemas/flema-engram)](https://github.com/oniricosistemas/flema-engram/blob/main/LICENSE)
7
7
 
8
- Un sidebar local y de solo lectura que mantiene visible el contexto reciente de
9
- [Engram](https://github.com/Gentleman-Programming/engram) mientras trabajás dentro de OpenCode.
8
+ Una integración local-first y de solo lectura que mantiene visible el contexto reciente de
9
+ [Engram](https://github.com/Gentleman-Programming/engram) mientras trabajás dentro de OpenCode o Pi/Gentle Shell.
10
10
 
11
11
  La canción **“Y aún yo te recuerdo”** inspiró artísticamente la idea central: que la
12
12
  última memoria guardada siga presente en el contexto de desarrollo. Esta referencia
13
13
  es un homenaje a esa inspiración; no implica afiliación, patrocinio ni titularidad
14
14
  sobre la obra.
15
15
 
16
- > **English summary:** Flema Engram is a local-first, read-only OpenCode
17
- > plugin/sidebar that surfaces Engram health, project context, recent memories,
16
+ > **English summary:** Flema Engram is a local-first, read-only OpenCode and Pi
17
+ > integration that surfaces Engram health, project context, recent memories,
18
18
  > blockers, and ODD task progress by default. An MCP stdio adapter is included only as an optional
19
19
  > integration path.
20
20
 
21
- ## Inicio rápido
21
+ ## Inicio rápido — 0.4.0
22
+
23
+ Elegí el registro en `tui.json` para OpenCode o la [instalación Pi / Gentle Shell](#viewer-para-pi--gentle-shell).
24
+ No hace falta una instalación global npm para ninguno de los viewers.
22
25
 
23
26
  ### Requisitos
24
27
 
25
28
  | Componente | Requisito |
26
29
  | --- | --- |
27
30
  | Node.js | 22 o posterior |
28
- | OpenCode | 1.18.25 o posterior |
29
- | Engram | Servicio HTTP local activo en `http://127.0.0.1:7437` (o accesible vía red en `<host>:7437` cuando se usa `opencode attach`) |
31
+ | Host visual | OpenCode 1.18.25+ **o** Pi con API de extensiones/UI compatible; Gentle Shell fullscreen para el rail lateral |
32
+ | Engram | Servicio HTTP accesible desde el proceso del viewer; por defecto `http://127.0.0.1:7437` |
30
33
  | Proyecto | Alguna observación o sesión reciente que permita validar el nombre |
31
34
 
32
35
  ### 1. Registrá el sidebar en `tui.json`
@@ -36,7 +39,7 @@ Configuración mínima:
36
39
  ```json
37
40
  {
38
41
  "$schema": "https://opencode.ai/tui.json",
39
- "plugin": ["opencode-flema-engram-sidebar@0.2.0"]
42
+ "plugin": ["opencode-flema-engram-sidebar@0.4.0"]
40
43
  }
41
44
  ```
42
45
 
@@ -85,29 +88,92 @@ OpenCode 2 dispone además de `opencode plugin check` y `opencode plugin update`
85
88
  CLI usa la sintaxis nativa correspondiente a la versión detectada.
86
89
 
87
90
  #### Usando `opencode attach`
88
- Si vas a conectarte a una instancia remota de OpenCode mediante `opencode attach <url>`, el plugin funcionará siempre que:
89
- - El servicio Engram en la máquina remota sea accesible en el puerto 7437 (por defecto solo escucha en 127.0.0.1; se recomienda crear un puente TCP como se describe en los documentos internos o usar `engram-bridge.service`).
90
- - Usá una versión exacta del plugin y actualizala explícitamente; `opencode attach` puede reutilizar una copia npm ya resuelta en la caché local.
91
- - La detección automática usa el host recibido por `opencode attach`; si el puente de Engram usa otra URL, configurá `baseUrl` explícitamente en `tui.json`.
92
- - Verás en el sidebar la línea `🔌 Target: Local=<host>:7437 | Cloud=<URL>` para confirmar a qué endpoints se está conectando.
91
+ La configuración incluye detección del host de `opencode attach <url>` para intentar
92
+ consultar Engram en el puerto 7437, pero no crea túneles ni expone el servicio remoto.
93
+ La conectividad debe existir desde el proceso que carga el viewer; el loopback remoto
94
+ no es accesible automáticamente desde otra máquina. Configurá `baseUrl` explícitamente
95
+ si la detección no representa tu endpoint y comprobá su `/health` desde ese proceso.
96
+ No se garantiza compatibilidad con todas las topologías attach, proxies o URLs.
97
+
98
+ Usá una versión exacta: attach también puede reutilizar paquetes en caché. La línea
99
+ `🔌 Target: Local=… | Cloud=…` informa los destinos configurados; no prueba una
100
+ sincronización ni garantiza que ambos respondan. No expongas el puerto de Engram sin
101
+ controles de acceso.
93
102
 
94
103
  ### 2. Iniciá Engram y abrí OpenCode en tu proyecto
95
104
 
96
105
  El sidebar hace una carga inicial, vuelve a consultar cada 30 segundos de forma
97
106
  predeterminada y permite refrescar manualmente con <kbd>Alt</kbd>+<kbd>R</kbd>.
98
107
 
108
+ ## Viewer para Pi / Gentle Shell
109
+
110
+ El mismo paquete incluye una extensión Pi de solo lectura. Para Pi convencional,
111
+ instalá la versión exacta compatible con esta documentación:
112
+
113
+ ```sh
114
+ pi install npm:opencode-flema-engram-sidebar@0.4.0
115
+ ```
116
+
117
+ Gentle Shell usa un home de paquetes aislado. Instalá allí la misma versión:
118
+
119
+ ```sh
120
+ PI_CODING_AGENT_DIR="$HOME/.gentle-shell/agent" \
121
+ pi install npm:opencode-flema-engram-sidebar@0.4.0
122
+ ```
123
+
124
+ En Gentle Shell fullscreen, la extensión participa del rail lateral sin reemplazar
125
+ el status existente. El panel empieza visible y expandido, con marco redondeado:
126
+ el borde usa el color semántico `border` y el título `accent` del theme activo.
127
+ Un clic izquierdo en el título colapsa o expande el panel, igual que el comando.
128
+ Muestra proyecto, salud, progreso ODD, bloqueos y actividad reciente. En Pi sin el
129
+ rail de Gentle Shell usa un overlay pasivo a la derecha cuando el terminal tiene
130
+ ancho suficiente. Los comandos de presentación son independientes:
131
+
132
+ ```text
133
+ /engram-refresh # Refrescar datos y status; notificar el resultado
134
+ /engram-sidebar # Mostrar u ocultar el sidebar
135
+ /engram-sidebar-collapse # Colapsar o expandir el sidebar
136
+ /engram-widget # Mostrar u ocultar el widget debajo del editor
137
+ ```
138
+
139
+ El widget compacto empieza oculto en cada sesión y su visibilidad no se persiste.
140
+ El sidebar y el widget refrescan al iniciar, reanudar o recargar una sesión y después
141
+ de que `mem_save` (o el alias `save_memory`) termina correctamente. Ocultar cualquiera
142
+ de las dos vistas no detiene el controller ni desactiva `/engram-refresh`.
143
+
144
+ No usa polling periódico y no agrega herramientas para escribir memorias. En modos
145
+ sin UI no consulta Engram ni intenta renderizar componentes terminales. En RPC no
146
+ monta el rail ni el overlay terminal.
147
+
148
+ Para el endpoint principal, definí `ENGRAM_URL` o `ENGRAM_BASE_URL`; sin configuración
149
+ se usa `http://127.0.0.1:7437` (el factory compartido también reconoce argumentos attach).
150
+ La configuración cloud compartida se describe en
151
+ [Seguridad y enfoque local-first](#seguridad-privacidad-y-enfoque-local-first).
152
+ `ENGRAM_PROJECT` puede fijar el candidato de proyecto; de lo contrario se valida el
153
+ nombre del directorio actual contra Engram. Los fallos de
154
+ inicialización se contienen en un estado `Engram unavailable` sin mostrar URLs,
155
+ tokens ni diagnósticos con credenciales.
156
+
157
+ Para desarrollo local, después de compilar el paquete:
158
+
159
+ ```sh
160
+ npm run build
161
+ pi --extension ./dist/pi.js
162
+ ```
163
+
99
164
  ## Qué es — y qué no es
100
165
 
101
166
  | Sí es | No es |
102
167
  | --- | --- |
103
- | Un plugin para el slot `sidebar_content` de OpenCode | Una TUI independiente |
104
- | Una vista local y de solo lectura sobre Engram | Un reemplazo de Engram |
105
- | Project context, activity, and ODD task progress | A memory editor or manager |
106
- | Un cliente del HTTP local de Engram | Un servicio cloud o de sincronización |
168
+ | Un plugin para `sidebar_content` de OpenCode y una extensión Pi | Una TUI independiente |
169
+ | Una vista local-first y de solo lectura sobre Engram | Un reemplazo de Engram |
170
+ | Contexto de proyecto, actividad y progreso ODD | Un editor o administrador de memorias |
171
+ | Un cliente HTTP de Engram | Un servicio cloud o de sincronización |
107
172
  | Un paquete con un adaptador MCP stdio opcional | Un producto centrado en MCP |
108
173
 
109
- El sidebar es el producto principal. El comando MCP existe para integraciones
110
- avanzadas y puede ignorarse por completo al usar el plugin de OpenCode.
174
+ Los viewers de OpenCode y Pi son las integraciones visuales principales. El comando
175
+ MCP existe para integraciones avanzadas y puede ignorarse por completo al usar cualquiera
176
+ de los viewers.
111
177
 
112
178
  ## Cómo funciona
113
179
 
@@ -115,13 +181,13 @@ avanzadas y puede ignorarse por completo al usar el plugin de OpenCode.
115
181
  2. El plugin resuelve un candidato de proyecto, lo prueba primero con una consulta
116
182
  acotada por proyecto y conserva la enumeración reciente como fallback.
117
183
  3. Consulta en paralelo salud, proyectos y observaciones del proyecto.
118
- 4. Derives ODD task state from canonical `odd/<feature>/tasks` mirrors, orders
119
- recent activity by update time, and recognizes explicit blockers.
184
+ 4. Deriva tareas ODD desde espejos canónicos `odd/<feature>/tasks`, ordena la
185
+ actividad por actualización y reconoce bloqueos explícitos.
120
186
  5. Renderiza texto dentro del sidebar de la sesión visible y conserva datos útiles
121
187
  como `STALE` si una actualización posterior queda incompleta.
122
188
 
123
- Las llamadas usan exclusivamente `GET` contra el Engram local. El plugin no guarda,
124
- edita ni elimina memorias.
189
+ Las llamadas usan exclusivamente `GET` contra los endpoints Engram configurados.
190
+ Los viewers no guardan, editan ni eliminan memorias.
125
191
 
126
192
  ### Endpoints utilizados
127
193
 
@@ -148,7 +214,7 @@ Usá la forma `[plugin, options]` solamente cuando necesites opciones:
148
214
  "$schema": "https://opencode.ai/tui.json",
149
215
  "plugin": [
150
216
  [
151
- "opencode-flema-engram-sidebar@0.2.0",
217
+ "opencode-flema-engram-sidebar@0.4.0",
152
218
  {
153
219
  "enabled": true,
154
220
  "project": "mi-proyecto",
@@ -166,7 +232,7 @@ Usá la forma `[plugin, options]` solamente cuando necesites opciones:
166
232
  | `enabled` | `boolean` | `false` evita que el plugin registre el sidebar. Por defecto está habilitado. |
167
233
  | `project` | `string` | Nombre exacto de proyecto Engram. Tiene la prioridad más alta. |
168
234
  | `pollInterval` | `number` | Intervalo automático en milisegundos; debe ser mayor que cero. Por defecto: `30000`. |
169
- | `baseUrl` | `string` | Endpoint HTTP(S) de Engram local. Gana sobre variables de entorno y detección por `opencode attach`. Por defecto: `http://127.0.0.1:7437`. |
235
+ | `baseUrl` | `string` | Endpoint HTTP(S) principal de Engram. Gana sobre variables de entorno y detección por `opencode attach`. Por defecto: `http://127.0.0.1:7437`. |
170
236
  | `timeoutMs` | `number` | Presupuesto común para requests locales y guards de etapas; debe ser finito y mayor que cero. Por defecto: `5000`. |
171
237
 
172
238
  La precedencia del endpoint local es `baseUrl` explícito, `ENGRAM_URL`,
@@ -232,8 +298,9 @@ vacío explícito.
232
298
  The sidebar derives ODD state from full feature-document mirrors whose `topic_key`
233
299
  is `odd/<feature>/tasks`. Each feature shows explicit task counts: done out of total,
234
300
  cancelled, in progress, blocked, and pending. Cancelled tasks are reported separately,
235
- not counted as done. See [the ODD state contract](docs/odd-state-contract.md) for the
236
- canonical checklist format and newest-valid-document selection.
301
+ not counted as done. See [the ODD state contract](https://github.com/oniricosistemas/flema-engram/blob/main/docs/odd-state-contract.md) for the
302
+ canonical checklist format and newest-valid-document selection. This shared ODD
303
+ contract also applies to Pi; the legacy workflow commands below are OpenCode-only.
237
304
 
238
305
  This is a bounded recent-observation view (up to 20 canonical project observations),
239
306
  not a complete project inventory. ODD derivation uses that entire window, not just
@@ -258,9 +325,12 @@ legacy opt-in described below.
258
325
 
259
326
  ### Bloqueos
260
327
 
261
- Lista títulos de observaciones reconocidas como bloqueos por tipo, título o frases
262
- explícitas como `status: blocked`, `blocker:`, `blocked by`, `depends on` o
263
- `waiting for`. No infiere bloqueos a partir de sentimiento o contexto ambiguo.
328
+ Lista títulos de observaciones de tipo `blocker`, o de otras observaciones con
329
+ `blocked` en el título o frases explícitas como `status: blocked`, `blocker:`,
330
+ `blocked by`, `depends on` o `waiting for`. Las observaciones `session_summary`
331
+ se excluyen de esas heurísticas de título y contenido: un resumen histórico no es
332
+ un bloqueo activo. Los registros de tipo `blocker` siguen contando. No infiere
333
+ bloqueos a partir de sentimiento o contexto ambiguo.
264
334
 
265
335
  ### Actividad reciente
266
336
 
@@ -274,7 +344,11 @@ reciente ocupa el primer lugar de **Recent Activity**. La vista muestra su títu
274
344
  el contenido completo. Así mantiene presente la referencia más nueva sin convertir
275
345
  el sidebar en un explorador de memorias.
276
346
 
277
- ### Refresh, carga y errores
347
+ ### Refresh, carga y errores — OpenCode
348
+
349
+ Pi no usa este polling ni estos atajos: refresca por eventos y con
350
+ `/engram-refresh`, que actualiza el status y notifica `Engram refreshed` o
351
+ `Engram refresh incomplete`. Las reglas de vista acotada y datos `STALE` son compartidas.
278
352
 
279
353
  - La primera carga se agenda una sola vez para el sidebar de la sesión visible.
280
354
  - El polling automático usa `pollInterval` o 30 segundos.
@@ -303,7 +377,7 @@ Si Engram conoce `mi-proyecto`, el sidebar valida ese nombre y carga sus memoria
303
377
  {
304
378
  "$schema": "https://opencode.ai/tui.json",
305
379
  "plugin": [
306
- ["opencode-flema-engram-sidebar@0.2.0", { "project": "backend-api" }]
380
+ ["opencode-flema-engram-sidebar@0.4.0", { "project": "backend-api" }]
307
381
  ]
308
382
  }
309
383
  ```
@@ -317,7 +391,7 @@ Engram. El valor debe coincidir; una configuración incorrecta queda como `unres
317
391
  {
318
392
  "$schema": "https://opencode.ai/tui.json",
319
393
  "plugin": [
320
- ["opencode-flema-engram-sidebar@0.2.0", { "pollInterval": 60000 }]
394
+ ["opencode-flema-engram-sidebar@0.4.0", { "pollInterval": 60000 }]
321
395
  ]
322
396
  }
323
397
  ```
@@ -367,9 +441,9 @@ Preservá el resto de tus plugins y opciones al fusionar la configuración.
367
441
  ### Engram aparece offline
368
442
 
369
443
  - Confirmá que Engram escuche en `127.0.0.1:7437` o en el endpoint declarado por `baseUrl`.
370
- - Probá `<baseUrl>/health` desde la misma máquina donde corre OpenCode.
371
- - Revisá firewalls o proxies locales; el plugin no intenta conectarse a un servicio
372
- cloud como alternativa.
444
+ - Probá `<baseUrl>/health` desde el proceso o máquina que carga el viewer.
445
+ - Revisá firewalls, proxies y los destinos de `Target`. El cloud solo se consulta
446
+ si está configurado; no es una alternativa automática garantizada al endpoint local.
373
447
  - Si una red o puente responde lentamente, aumentá `timeoutMs`; el mismo valor limita
374
448
  requests HTTP y etapas del refresh.
375
449
  - Una URL que no use `http:` o `https:` se rechaza dentro del sidebar con un diagnóstico
@@ -388,7 +462,8 @@ Preservá el resto de tus plugins y opciones al fusionar la configuración.
388
462
  ### Los datos parecen viejos
389
463
 
390
464
  - Mirá si Health dice `STALE` y leé el detalle de etapa/endpoint.
391
- - Esperá el próximo polling o usá <kbd>Alt</kbd>+<kbd>R</kbd>.
465
+ - En OpenCode esperá el próximo polling o usá <kbd>Alt</kbd>+<kbd>R</kbd>;
466
+ en Pi usá `/engram-refresh` (no hay polling).
392
467
  - Confirmá que la memoria pertenece exactamente al proyecto resuelto.
393
468
  - El feed solo muestra cinco títulos y la consulta del sidebar está acotada a 20
394
469
  observaciones.
@@ -509,9 +584,16 @@ La lista `files` permite publicar `dist`, `README.md` y `LICENSE`; npm agrega ad
509
584
  la metadata obligatoria. El verificador exige, como mínimo:
510
585
 
511
586
  - API raíz: `dist/index.js` y `dist/index.d.ts`;
512
- - plugin: `dist/sidebar/plugin.js` y `dist/sidebar/plugin.d.ts`;
513
- - CLI opcional: `dist/stdio.js`;
514
- - README, licencia y `package.json`.
587
+ - plugin OpenCode (`./tui`): `dist/sidebar/plugin.js` y `dist/sidebar/plugin.d.ts`;
588
+ - controller compartido (`./core`): `dist/core.js` y `dist/core.d.ts`;
589
+ - extensión Pi (`./pi`): `dist/pi.js` y `dist/pi.d.ts`, registrada en `pi.extensions`;
590
+ - panel Pi: `dist/pi/sidebar.js` y `dist/pi/sidebar.d.ts`;
591
+ - CLI de mantenimiento `flema-engram`: `dist/maintenance.js`;
592
+ - MCP opcional `mcp-flema-engram`: `dist/stdio.js`;
593
+ - `README.md`, `LICENSE` y `package.json`.
594
+
595
+ `docs/` y `site/` no se incluyen en npm; las referencias de documentación apuntan al
596
+ repositorio público.
515
597
 
516
598
  `prepublishOnly` ejecuta automáticamente:
517
599
 
@@ -557,7 +639,7 @@ Ejemplo de configuración local de OpenCode, equivalente a `opencode.example.jso
557
639
 
558
640
  The server offers read-only MCP tools and resources for health, projects,
559
641
  observations, sessions, ODD state, and explicit legacy SDD access. It uses the same
560
- local Engram HTTP service, without adding persistence or cloud synchronization.
642
+ Engram HTTP configuration (loopback by default), without adding persistence or cloud synchronization.
561
643
 
562
644
  ### ODD-first project state and explicit legacy access
563
645
 
@@ -573,7 +655,7 @@ loaded exact-project observation window. Existing project metadata, observation
573
655
  counts, explicit blockers, and recent activity remain available. Invalid mirrors
574
656
  stay visible as diagnostics and never cause SDD fallback. Counts and derived
575
657
  workflow state describe bounded recent observations, not an exhaustive inventory
576
- or historical total. See [the ODD state contract](docs/odd-state-contract.md).
658
+ or historical total. See [the ODD state contract](https://github.com/oniricosistemas/flema-engram/blob/main/docs/odd-state-contract.md).
577
659
 
578
660
  `includeLegacySdd` is an optional boolean, defaulting to `false`. By default the
579
661
  tool does not derive legacy SDD or expose `changes`. To add legacy SDD changes to
@@ -593,24 +675,31 @@ behavior is unchanged.
593
675
 
594
676
  ## Seguridad, privacidad y enfoque local-first
595
677
 
596
- - Los datos de Engram permanecen en la máquina y el runtime consulta loopback.
597
- - El sidebar no requiere credenciales, telemetría ni servicios cloud.
678
+ - Por defecto el viewer consulta loopback; no requiere un servicio cloud ni telemetría.
679
+ - Un endpoint remoto explícito o detectado por attach implica tráfico de red: los
680
+ datos no están necesariamente limitados a esta máquina.
681
+ - El factory compartido puede agregar lecturas cloud si encuentra `ENGRAM_CLOUD_URL`
682
+ o configuración en `~/.engram/cloud.json`. Puede usar `ENGRAM_CLOUD_TOKEN` o
683
+ `ENGRAM_TOKEN` como Bearer token; revisá esa configuración antes de asumir un
684
+ runtime exclusivamente local.
598
685
  - No ejecuta operaciones de escritura sobre memorias.
599
686
  - No crea logs propios con contenido de observaciones.
600
687
  - El contenido de memorias puede ser sensible: protegé el acceso al proceso y puerto
601
688
  local de Engram como protegerías cualquier herramienta de desarrollo.
602
- - Las conexiones externas solo son necesarias para tareas ajenas al runtime local,
603
- como instalar desde npm o abrir enlaces de documentación.
689
+ - Instalar desde npm y abrir documentación también puede requerir conexiones externas.
604
690
 
605
- El repositorio contiene una clase experimental de adaptador cloud con operaciones no
606
- implementadas. No forma parte del flujo del plugin ni constituye soporte cloud.
691
+ El adaptador cloud implementa lecturas HTTP y puede combinarse con el local; no es
692
+ un servicio alojado ni un mecanismo de sincronización. No se promete seguridad de
693
+ transporte para despliegues arbitrarios: el adaptador cloud permite certificados TLS
694
+ no verificados por defecto. Preferí loopback o una red controlada y no envíes tokens
695
+ a destinos no confiables.
607
696
 
608
697
  ## Roadmap y alcance diferido
609
698
 
610
699
  Están explícitamente fuera del MVP actual:
611
700
 
612
701
  - dashboard visual y acciones/atajos para abrirlo;
613
- - conexión remota mediante `opencode attach`;
702
+ - túneles automáticos y compatibilidad garantizada con cualquier despliegue attach;
614
703
  - selector manual de proyecto, navegación `j`/`k` y más atajos globales;
615
704
  - sincronización cloud y edición de memorias.
616
705
 
package/dist/core.d.ts ADDED
@@ -0,0 +1,4 @@
1
+ export * from "./adapters/types.js";
2
+ export * from "./viewer/core.js";
3
+ export { resolveProject, resolveProjectName, type ProjectResolution, type ProjectResolutionOptions, type ProjectValidation, } from "./utils/project-resolver.js";
4
+ //# sourceMappingURL=core.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,GACvB,MAAM,6BAA6B,CAAC"}
package/dist/core.js ADDED
@@ -0,0 +1,4 @@
1
+ export * from "./adapters/types.js";
2
+ export * from "./viewer/core.js";
3
+ export { resolveProject, resolveProjectName, } from "./utils/project-resolver.js";
4
+ //# sourceMappingURL=core.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,kBAAkB,GAInB,MAAM,6BAA6B,CAAC"}
@@ -0,0 +1,49 @@
1
+ import type { SidebarViewModel } from "../viewer/core.js";
2
+ export interface PiSidebarTheme {
3
+ fg: (token: string, text: string) => string;
4
+ bold?: (text: string) => string;
5
+ }
6
+ export interface PiSidebarRenderHost {
7
+ requestRender: () => void;
8
+ }
9
+ export interface PiSidebarMouseEvent {
10
+ type: string;
11
+ button: string;
12
+ x: number;
13
+ y: number;
14
+ width: number;
15
+ height: number;
16
+ [key: string]: unknown;
17
+ }
18
+ export interface PiSidebarMouseResult {
19
+ handled?: boolean;
20
+ render?: boolean;
21
+ [key: string]: unknown;
22
+ }
23
+ export interface PiSidebarPanel {
24
+ render: (width: number) => string[];
25
+ invalidate: () => void;
26
+ digest: () => string;
27
+ handleMouse?: (event: PiSidebarMouseEvent) => PiSidebarMouseResult | undefined;
28
+ setState: (state: SidebarViewModel) => void;
29
+ setCollapsed: (collapsed: boolean) => void;
30
+ isCollapsed: () => boolean;
31
+ }
32
+ export interface PiSidebarTui extends PiSidebarRenderHost {
33
+ mode?: string;
34
+ terminal?: Record<symbol, unknown>;
35
+ }
36
+ export interface GentleShellRailAttachment {
37
+ isMounted: () => boolean;
38
+ isActive: () => boolean;
39
+ setVisible: (visible: boolean) => void;
40
+ invalidate: () => void;
41
+ dispose: () => void;
42
+ }
43
+ export declare const GENTLE_SHELL_SIDEBAR_STATE: unique symbol;
44
+ type RailComponent = Pick<PiSidebarPanel, "render" | "invalidate" | "digest" | "handleMouse">;
45
+ export declare function visibleTextWidth(value: string): number;
46
+ export declare function attachGentleShellRailPanel(tui: PiSidebarTui, component: RailComponent): GentleShellRailAttachment | undefined;
47
+ export declare function createPiSidebarPanel(tui: PiSidebarRenderHost, theme: PiSidebarTheme, initialState: SidebarViewModel, onCollapsedChange?: (collapsed: boolean) => void): PiSidebarPanel;
48
+ export {};
49
+ //# sourceMappingURL=sidebar.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../src/pi/sidebar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,oBAAoB,GAAG,SAAS,CAAC;IAC/E,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,YAAY,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,WAAW,EAAE,MAAM,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,YAAa,SAAQ,mBAAmB;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,0BAA0B,eAAqD,CAAC;AAG7F,KAAK,aAAa,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,aAAa,CAAC,CAAC;AAoB9F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAStD;AAgLD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,aAAa,GACvB,yBAAyB,GAAG,SAAS,CAuDvC;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,mBAAmB,EACxB,KAAK,EAAE,cAAc,EACrB,YAAY,EAAE,gBAAgB,EAC9B,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,GAC/C,cAAc,CAyFhB"}