@ibgib/space-gib 0.0.33 → 0.0.35

package/src/client/ui/component/cosmos-navigator/index.mts

@@ -0,0 +1,18 @@
+/**
+ * @module ui/component/cosmos-navigator
+ *
+ * space-gib-cosmos-navigator Web Component barrel export and registration.
+ */
+
+export * from './cosmos-navigator.mjs';
+
+import { getComponentSvc } from "@ibgib/web-gib/dist/ui/component/ibgib-component-service.mjs";
+import { CosmosNavigatorComponentMeta } from "./cosmos-navigator.mjs";
+
+/**
+ * Registers the CosmosNavigator Web Component with the central component service.
+ */
+export async function registerCosmosNavigatorComponent(): Promise<void> {
+    const componentSvc = await getComponentSvc();
+    componentSvc.registerComponentMeta(new CosmosNavigatorComponentMeta());
+}

package/src/client/ui/component/file-explorer/IMPLEMENTATION.md

@@ -0,0 +1,42 @@
+# space-gib-file-explorer Component Specification
+
+## Overview
+`space-gib-file-explorer` is an encapsulated `@ibgib` Web Component (Custom Element) representing a Branch File Explorer in the `space-gib` Left Panel.
+
+## Component Identity
+- **Tag**: `<space-gib-file-explorer>`
+- **Meta Class**: `FileExplorerComponentMeta`
+- **Instance Class**: `FileExplorerComponentInstance`
+- **Path Constant**: `space-gib-file-explorer`
+- **Initial Backing ibGib**: `ROOT_ADDR` (`ibgib` root address)
+
+## Visual Architecture & Shadow DOM Layout
+1. **Branch Worktree Header**:
+   - Chevron collapse toggle (`▼` / `▶`)
+   - Branch icon: `🌿`
+   - Branch label: `main` (or active branch name)
+   - Worktree badge: `worktree`
+   - Action icons (visible on hover):
+     - `+ New File` (`📄+`)
+     - `+ New Folder` (`📁+`)
+     - `Collapse All` (`⇱`)
+2. **File Tree Container**:
+   - Hierarchical collapsible folders (`📂 src/`, `📁 docs/`)
+   - File items (`📄 index.ts`, `📄 helper.ts`, `📝 README.md`, `⚙️ package.json`)
+   - Living companion note indicator badges (`💬`)
+   - Indentation guides (`.tree-indent`, `.tree-indent-2`)
+   - Active / selected file indicator with accent glow
+
+## Event Contracts
+Dispatched across Shadow DOM boundary (`bubbles: true`, `composed: true`):
+- `space-gib-file-selected`: `{ branch: string, path: string, name: string }`
+- `space-gib-branch-selected`: `{ branch: string }`
+- `space-gib-new-file-requested`: `{ branch: string, folder?: string }`
+- `space-gib-new-folder-requested`: `{ branch: string, folder?: string }`
+
+## Lifecycle Checklist
+- [x] Extends `IbGibDynamicComponentMetaBase` and `IbGibDynamicComponentInstanceBase`.
+- [x] Queries elements in `created()`.
+- [x] Cleans up event listeners in `disconnected()`.
+- [x] Renders worktree branch file tree with folder expansion toggling.
+- [x] Dispatches composed events to app shell.