@ibgib/space-gib 0.0.33 → 0.0.35

package/src/client/ui/component/file-explorer/index.mts

@@ -0,0 +1,9 @@
+import { getComponentSvc } from "@ibgib/web-gib/dist/ui/component/ibgib-component-service.mjs";
+import { FileExplorerComponentMeta } from "./file-explorer.mjs";
+
+export * from "./file-explorer.mjs";
+
+export async function registerFileExplorerComponent(): Promise<void> {
+    const componentSvc = await getComponentSvc();
+    componentSvc.registerComponentMeta(new FileExplorerComponentMeta());
+}

package/src/client/ui/component/nested-chat/IMPLEMENTATION.md

@@ -0,0 +1,18 @@
+# space-gib-nested-chat Component Implementation
+
+## 1. Overview
+`space-gib-nested-chat` is a dynamic container Web Component that hosts recursive `space-gib-chat` instances in the `space-gib` right panel. It extends `IbGibDynamicComponentInstanceBase_ParentOfTabs` to manage child tabs formatted as an interactive breadcrumb navigation rail.
+
+## 2. Core Concepts & Navigation Paradigm
+- **Breadcrumb-Styled Tabs**:
+  - Rather than traditional square tabs, tabs are styled as a horizontal breadcrumb path (`[🌿 src/index.ts] › [💬 Architectural Rationale...] › [💬 Boundary Try/Catch...]`).
+  - The currently active breadcrumb has high-contrast accent styling.
+- **Non-Destructive Ancestor Navigation**:
+  - Clicking any ancestor breadcrumb activates that ancestor's `space-gib-chat` component in the main content viewport (`this.activateIbGib({ addr })`).
+  - Descendant breadcrumb tabs remain in the rail so the user can easily hop back and forth along the conversation trail.
+- **Branch Divergence**:
+  - If the user is currently focused on an ancestor tab and selects a *different* comment to drill down into, any descendant tabs beyond the active tab are pruned and the new child comment is appended as the new active tab.
+
+## 3. Events Handled & Dispatched
+- Listens for `space-gib-chat-drill-down`: Triggers drill-down into child comment context.
+- Dispatches `space-gib-chat-closed` / `space-gib-chat-close-requested`: Requests shell collapse/close of right chat panel.

package/src/client/ui/component/nested-chat/chat/IMPLEMENTATION.md

@@ -0,0 +1,14 @@
+# space-gib-chat Component Implementation
+
+## 1. Overview
+`space-gib-chat` is a dynamic Web Component representing a single chatroom context within the `space-gib-nested-chat` container. In the ibGib model, any ibGib (a source file, commit, diff, or individual comment) can act as a chatroom context.
+
+## 2. Responsibilities
+- Renders the list of living comments attached to the context ibGib (`this.ibGib.rel8ns.chat`).
+- Renders author identity, avatar, role (Keystone/Peer/Agent), timestamps, and optional code anchors.
+- Provides a drill-down trigger (`↳ N replies / Drill In 🔍`) that fires `space-gib-chat-drill-down` custom event upward to `space-gib-nested-chat`.
+- Provides an inline message composer to append new living comments to the current context.
+
+## 3. Events Dispatched
+- `space-gib-chat-drill-down`: Bubbling, composed event carrying `{ addr: IbGibAddr, text: string, author?: string }`.
+- `space-gib-chat-message-sent`: Notification event carrying `{ message: ChatCommentItem, contextAddr: IbGibAddr }`.

package/src/client/ui/component/nested-chat/chat/chat-constants.mts

@@ -0,0 +1,14 @@
+/**
+ * in the chat component, there are two different types of behavior for ENTER
+ * key: "send" | "newline".
+ *
+ * This is the key used in storage for storing this small settings locally.
+ *
+ * ## driving use case
+ *
+ * It drives me bonkers when I have to remember to hit SHIFT+ENTER in order to
+ * avoid sending a complex message/text.
+ */
+export const SPACE_GIB_CHAT_ENTER_BEHAVIOR_KEY = 'space_gib_enter_behavior';
+
+export const SPACE_GIB_CHAT_ENTER_BEHAVIOR_KEY_DEFAULT = 'newline';

package/src/client/ui/component/nested-chat/chat/chat-helpers.mts

@@ -0,0 +1,66 @@
+import { extractErrorMsg } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { storageGet, storagePut } from "@ibgib/web-gib/dist/storage/storage-helpers.web.mjs";
+
+
+import { APP_CONFIG, GLOBAL_LOG_A_LOT } from "../../../../constants.mjs";
+import { SPACE_GIB_CHAT_ENTER_BEHAVIOR_KEY, SPACE_GIB_CHAT_ENTER_BEHAVIOR_KEY_DEFAULT } from "./chat-constants.mjs";
+
+const logalot = GLOBAL_LOG_A_LOT;
+
+/**
+ * gets value of how the ENTER key should behave when pressed in the chat.
+ * First looks in storage, and if not found (or errored), returns default.
+ *
+ * ## driving use case
+ *
+ * It drives me bonkers when I have to remember to hit SHIFT+ENTER in order to
+ * avoid sending a complex message/text.
+ *
+ * @returns enter behavior from storage or default
+ *
+ * @see {@link SPACE_GIB_CHAT_ENTER_BEHAVIOR_KEY}
+ * @see {@link SPACE_GIB_CHAT_ENTER_BEHAVIOR_KEY_DEFAULT}
+ */
+export async function getSavedEnterBehavior(): Promise<'send' | 'newline'> {
+    const lc = `[${getSavedEnterBehavior.name}]`;
+    try {
+        const saved = await storageGet({
+            dbName: APP_CONFIG.dbName,
+            storeName: APP_CONFIG.storeName,
+            key: SPACE_GIB_CHAT_ENTER_BEHAVIOR_KEY,
+        });
+        if (saved === 'newline' || saved === 'send') {
+            return saved;
+        } else {
+            throw new Error(`invalid saved value: ${saved}. expected "newline" or "send" (E: 2ff05888161f88781ec3a778b8dbdc26)`);
+        }
+    } catch (error) {
+        console.log(`${lc} (NOT THROWN) error: ${extractErrorMsg(error)}. returning default value: ${SPACE_GIB_CHAT_ENTER_BEHAVIOR_KEY_DEFAULT} (E: 71a0df6714c22a322e65702a2f743126)`);
+        return SPACE_GIB_CHAT_ENTER_BEHAVIOR_KEY_DEFAULT;
+    }
+}
+
+/**
+ * @see {@link getSavedEnterBehavior}
+ */
+export async function setSavedEnterBehavior(value: 'send' | 'newline'): Promise<void> {
+    const lc = `[${setSavedEnterBehavior.name}]`;
+    try {
+        if (logalot) { console.log(`${lc} starting... (I: 39e3f846651cb92cfec3da4ee305ea26)`); }
+
+        if (value !== "send" && value !== "newline") {
+            throw new Error(`(UNEXPECTED) invalid val (val)? should be "send" or "newline" (E: b5323681d3d66ddb3868cc9aa7fae826)`);
+        }
+
+        await storagePut({
+            dbName: APP_CONFIG.dbName,
+            storeName: APP_CONFIG.storeName,
+            key: SPACE_GIB_CHAT_ENTER_BEHAVIOR_KEY,
+            value,
+        });
+    } catch (error) {
+        console.error(`${lc} (NOT THROWN) ${extractErrorMsg(error)}`);
+    } finally {
+        if (logalot) { console.log(`${lc} complete.`); }
+    }
+}