@moyarich/console-addon-selection 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# @moyarich/console-addon-selection
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Select Console messages. Select message IDs individually or in visible ranges, with optional message actions and decorations.
+
+## Install
+
+```bash
+npm install @moyarich/console @moyarich/console-addon-selection
+```
+
+## Quick start
+
+```tsx
+import { Console } from "@moyarich/console";
+import { createConsoleSelectionAddon } from "@moyarich/console-addon-selection";
+
+const addons = [createConsoleSelectionAddon()];
+
+// Pass your application's structured messages to Console.
+<Console messages={messages} addons={addons} />;
+```
+
+The addon is optional and can be combined with other Console addons. The host application remains responsible for supplying and retaining messages.
+
+## Learn more
+
+Explore [runnable package examples](./examples) and the [Console documentation](https://moyarich.github.io/console/) for available settings and integration patterns.
+
+Review the [changelog](./CHANGELOG.md) for changes by version and [package metadata](./package.json) for dependency requirements.
+
+## License
+
+MIT

package/dist/components/SelectedMessageIndicator/SelectedMessageIndicator.d.ts

@@ -0,0 +1,2 @@
+/** Default selection indicator. No stylesheet or addon runtime required. */
+export declare function SelectedMessageIndicator(): import("react").JSX.Element;

package/dist/index.cjs

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const consoleCore = require("@moyarich/console-core");
+function SelectedMessageIndicator() {
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "span",
+    {
+      "aria-label": "Selected message",
+      title: "Selected",
+      style: { fontSize: 12, lineHeight: 1 },
+      children: "●"
+    }
+  );
+}
+const CONSOLE_SELECTION_ADDON_ID = "@moyarich/console-addon-selection";
+const consoleSelectionService = consoleCore.createConsoleServiceToken(
+  `${CONSOLE_SELECTION_ADDON_ID}.controller`
+);
+function normalizeId(value) {
+  const normalized = value.trim();
+  return normalized || void 0;
+}
+function uniqueIds(ids) {
+  return Object.freeze(
+    Array.from(
+      new Set(ids.map((id) => normalizeId(id)).filter(Boolean))
+    )
+  );
+}
+function snapshotIds(data) {
+  const snapshot = data?.getSnapshot();
+  if (!snapshot) return [];
+  if (snapshot.mode === "console") {
+    return snapshot.visible.flatMap(
+      (message) => message.id ? [message.id] : []
+    );
+  }
+  return snapshot.visible.flatMap(({ entry }) => entry.id ? [entry.id] : []);
+}
+function createConsoleSelectionController(getData = () => void 0) {
+  let state = Object.freeze({
+    selectedIds: Object.freeze([])
+  });
+  const listeners = /* @__PURE__ */ new Set();
+  const update = (selectedIds, anchorId) => {
+    state = Object.freeze({
+      selectedIds: uniqueIds(selectedIds),
+      ...anchorId ? { anchorId } : {}
+    });
+    for (const listener of listeners) listener();
+  };
+  const controller = {
+    getState: () => state,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
+    },
+    isSelected(id) {
+      const normalized = normalizeId(id);
+      return Boolean(normalized && state.selectedIds.includes(normalized));
+    },
+    select(id, additive = false) {
+      const normalized = normalizeId(id);
+      if (!normalized) return false;
+      const next = additive ? uniqueIds([...state.selectedIds, normalized]) : [normalized];
+      const changed = next.length !== state.selectedIds.length || next.some((value, index) => value !== state.selectedIds[index]);
+      if (changed || state.anchorId !== normalized) {
+        update(next, normalized);
+      }
+      return changed;
+    },
+    deselect(id) {
+      const normalized = normalizeId(id);
+      if (!normalized || !state.selectedIds.includes(normalized)) return false;
+      const next = state.selectedIds.filter((value) => value !== normalized);
+      update(next, state.anchorId === normalized ? void 0 : state.anchorId);
+      return true;
+    },
+    toggle(id) {
+      const normalized = normalizeId(id);
+      if (!normalized) return false;
+      if (controller.isSelected(normalized)) {
+        controller.deselect(normalized);
+        return false;
+      }
+      controller.select(normalized, true);
+      return true;
+    },
+    clear() {
+      if (state.selectedIds.length === 0 && !state.anchorId) return;
+      update([]);
+    },
+    setSelectedIds(ids) {
+      const next = uniqueIds(ids);
+      update(next, next.at(-1));
+    },
+    selectRange(fromId, toId) {
+      const ordered = snapshotIds(getData());
+      const start = ordered.indexOf(fromId);
+      const end = ordered.indexOf(toId);
+      if (start < 0 || end < 0) return state.selectedIds;
+      const [from, to] = start <= end ? [start, end] : [end, start];
+      const range = ordered.slice(from, to + 1);
+      update(range, toId);
+      return range;
+    },
+    getVisibleSelectedIds() {
+      const visible = new Set(snapshotIds(getData()));
+      return Object.freeze(state.selectedIds.filter((id) => visible.has(id)));
+    }
+  };
+  return controller;
+}
+function createDecoration(controller) {
+  return {
+    id: `${CONSOLE_SELECTION_ADDON_ID}:selected`,
+    placement: "gutter",
+    match({ message }) {
+      return Boolean(message.id && controller.isSelected(message.id));
+    },
+    render({ message }) {
+      if (!message.id || !controller.isSelected(message.id)) return void 0;
+      return /* @__PURE__ */ jsxRuntime.jsx(SelectedMessageIndicator, {});
+    }
+  };
+}
+function createMessageAction(controller) {
+  return {
+    id: `${CONSOLE_SELECTION_ADDON_ID}:toggle`,
+    label: "Toggle selection",
+    ariaLabel: "Toggle message selection",
+    visible({ message }) {
+      return Boolean(message.id);
+    },
+    onSelect({ message }) {
+      if (message.id) controller.toggle(message.id);
+    }
+  };
+}
+function createConsoleSelectionAddon(options = {}) {
+  let activeData;
+  const controller = options.controller ?? createConsoleSelectionController(() => activeData);
+  const withDecoration = options.decoration !== false;
+  const withMessageAction = options.messageAction !== false;
+  return {
+    id: CONSOLE_SELECTION_ADDON_ID,
+    controller,
+    activate(host) {
+      activeData = host.services.get(consoleCore.consoleServices.data);
+      host.services.provide(consoleSelectionService, controller);
+      let decorationRegistration;
+      let actionRegistration;
+      const registerContributions = () => {
+        decorationRegistration?.dispose();
+        actionRegistration?.dispose();
+        if (withDecoration) {
+          decorationRegistration = host.extensions.register(
+            consoleCore.consoleExtensionPoints.messageDecoration,
+            createDecoration(controller),
+            { id: `${CONSOLE_SELECTION_ADDON_ID}:selected` }
+          );
+        }
+        if (withMessageAction) {
+          actionRegistration = host.extensions.register(
+            consoleCore.consoleExtensionPoints.messageAction,
+            createMessageAction(controller),
+            { id: `${CONSOLE_SELECTION_ADDON_ID}:toggle` }
+          );
+        }
+      };
+      registerContributions();
+      host.scope.defer(controller.subscribe(registerContributions));
+      host.scope.defer(() => decorationRegistration?.dispose());
+      host.scope.defer(() => actionRegistration?.dispose());
+      return () => {
+        activeData = void 0;
+      };
+    }
+  };
+}
+exports.CONSOLE_SELECTION_ADDON_ID = CONSOLE_SELECTION_ADDON_ID;
+exports.SelectedMessageIndicator = SelectedMessageIndicator;
+exports.consoleSelectionService = consoleSelectionService;
+exports.createConsoleSelectionAddon = createConsoleSelectionAddon;
+exports.createConsoleSelectionController = createConsoleSelectionController;

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+export { SelectedMessageIndicator } from "./components/SelectedMessageIndicator/SelectedMessageIndicator";
+import { type ConsoleAddon, type ConsoleDataService } from "@moyarich/console-core";
+export declare const CONSOLE_SELECTION_ADDON_ID = "@moyarich/console-addon-selection";
+export interface ConsoleSelectionState {
+    readonly selectedIds: readonly string[];
+    readonly anchorId?: string;
+}
+export interface ConsoleSelectionController {
+    getState(): ConsoleSelectionState;
+    subscribe(listener: () => void): () => void;
+    isSelected(id: string): boolean;
+    select(id: string, additive?: boolean): boolean;
+    deselect(id: string): boolean;
+    toggle(id: string): boolean;
+    clear(): void;
+    setSelectedIds(ids: readonly string[]): void;
+    selectRange(fromId: string, toId: string): readonly string[];
+    getVisibleSelectedIds(): readonly string[];
+}
+export interface ConsoleSelectionAddonOptions {
+    controller?: ConsoleSelectionController;
+    decoration?: boolean;
+    messageAction?: boolean;
+}
+export interface ConsoleSelectionAddon extends ConsoleAddon {
+    readonly controller: ConsoleSelectionController;
+}
+export declare const consoleSelectionService: import("@moyarich/console-core").ConsoleServiceToken<ConsoleSelectionController>;
+export declare function createConsoleSelectionController(getData?: () => ConsoleDataService | undefined): ConsoleSelectionController;
+export declare function createConsoleSelectionAddon(options?: ConsoleSelectionAddonOptions): ConsoleSelectionAddon;

package/dist/index.js

@@ -0,0 +1,186 @@
+import { jsx } from "react/jsx-runtime";
+import { createConsoleServiceToken, consoleServices, consoleExtensionPoints } from "@moyarich/console-core";
+function SelectedMessageIndicator() {
+  return /* @__PURE__ */ jsx(
+    "span",
+    {
+      "aria-label": "Selected message",
+      title: "Selected",
+      style: { fontSize: 12, lineHeight: 1 },
+      children: "●"
+    }
+  );
+}
+const CONSOLE_SELECTION_ADDON_ID = "@moyarich/console-addon-selection";
+const consoleSelectionService = createConsoleServiceToken(
+  `${CONSOLE_SELECTION_ADDON_ID}.controller`
+);
+function normalizeId(value) {
+  const normalized = value.trim();
+  return normalized || void 0;
+}
+function uniqueIds(ids) {
+  return Object.freeze(
+    Array.from(
+      new Set(ids.map((id) => normalizeId(id)).filter(Boolean))
+    )
+  );
+}
+function snapshotIds(data) {
+  const snapshot = data?.getSnapshot();
+  if (!snapshot) return [];
+  if (snapshot.mode === "console") {
+    return snapshot.visible.flatMap(
+      (message) => message.id ? [message.id] : []
+    );
+  }
+  return snapshot.visible.flatMap(({ entry }) => entry.id ? [entry.id] : []);
+}
+function createConsoleSelectionController(getData = () => void 0) {
+  let state = Object.freeze({
+    selectedIds: Object.freeze([])
+  });
+  const listeners = /* @__PURE__ */ new Set();
+  const update = (selectedIds, anchorId) => {
+    state = Object.freeze({
+      selectedIds: uniqueIds(selectedIds),
+      ...anchorId ? { anchorId } : {}
+    });
+    for (const listener of listeners) listener();
+  };
+  const controller = {
+    getState: () => state,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
+    },
+    isSelected(id) {
+      const normalized = normalizeId(id);
+      return Boolean(normalized && state.selectedIds.includes(normalized));
+    },
+    select(id, additive = false) {
+      const normalized = normalizeId(id);
+      if (!normalized) return false;
+      const next = additive ? uniqueIds([...state.selectedIds, normalized]) : [normalized];
+      const changed = next.length !== state.selectedIds.length || next.some((value, index) => value !== state.selectedIds[index]);
+      if (changed || state.anchorId !== normalized) {
+        update(next, normalized);
+      }
+      return changed;
+    },
+    deselect(id) {
+      const normalized = normalizeId(id);
+      if (!normalized || !state.selectedIds.includes(normalized)) return false;
+      const next = state.selectedIds.filter((value) => value !== normalized);
+      update(next, state.anchorId === normalized ? void 0 : state.anchorId);
+      return true;
+    },
+    toggle(id) {
+      const normalized = normalizeId(id);
+      if (!normalized) return false;
+      if (controller.isSelected(normalized)) {
+        controller.deselect(normalized);
+        return false;
+      }
+      controller.select(normalized, true);
+      return true;
+    },
+    clear() {
+      if (state.selectedIds.length === 0 && !state.anchorId) return;
+      update([]);
+    },
+    setSelectedIds(ids) {
+      const next = uniqueIds(ids);
+      update(next, next.at(-1));
+    },
+    selectRange(fromId, toId) {
+      const ordered = snapshotIds(getData());
+      const start = ordered.indexOf(fromId);
+      const end = ordered.indexOf(toId);
+      if (start < 0 || end < 0) return state.selectedIds;
+      const [from, to] = start <= end ? [start, end] : [end, start];
+      const range = ordered.slice(from, to + 1);
+      update(range, toId);
+      return range;
+    },
+    getVisibleSelectedIds() {
+      const visible = new Set(snapshotIds(getData()));
+      return Object.freeze(state.selectedIds.filter((id) => visible.has(id)));
+    }
+  };
+  return controller;
+}
+function createDecoration(controller) {
+  return {
+    id: `${CONSOLE_SELECTION_ADDON_ID}:selected`,
+    placement: "gutter",
+    match({ message }) {
+      return Boolean(message.id && controller.isSelected(message.id));
+    },
+    render({ message }) {
+      if (!message.id || !controller.isSelected(message.id)) return void 0;
+      return /* @__PURE__ */ jsx(SelectedMessageIndicator, {});
+    }
+  };
+}
+function createMessageAction(controller) {
+  return {
+    id: `${CONSOLE_SELECTION_ADDON_ID}:toggle`,
+    label: "Toggle selection",
+    ariaLabel: "Toggle message selection",
+    visible({ message }) {
+      return Boolean(message.id);
+    },
+    onSelect({ message }) {
+      if (message.id) controller.toggle(message.id);
+    }
+  };
+}
+function createConsoleSelectionAddon(options = {}) {
+  let activeData;
+  const controller = options.controller ?? createConsoleSelectionController(() => activeData);
+  const withDecoration = options.decoration !== false;
+  const withMessageAction = options.messageAction !== false;
+  return {
+    id: CONSOLE_SELECTION_ADDON_ID,
+    controller,
+    activate(host) {
+      activeData = host.services.get(consoleServices.data);
+      host.services.provide(consoleSelectionService, controller);
+      let decorationRegistration;
+      let actionRegistration;
+      const registerContributions = () => {
+        decorationRegistration?.dispose();
+        actionRegistration?.dispose();
+        if (withDecoration) {
+          decorationRegistration = host.extensions.register(
+            consoleExtensionPoints.messageDecoration,
+            createDecoration(controller),
+            { id: `${CONSOLE_SELECTION_ADDON_ID}:selected` }
+          );
+        }
+        if (withMessageAction) {
+          actionRegistration = host.extensions.register(
+            consoleExtensionPoints.messageAction,
+            createMessageAction(controller),
+            { id: `${CONSOLE_SELECTION_ADDON_ID}:toggle` }
+          );
+        }
+      };
+      registerContributions();
+      host.scope.defer(controller.subscribe(registerContributions));
+      host.scope.defer(() => decorationRegistration?.dispose());
+      host.scope.defer(() => actionRegistration?.dispose());
+      return () => {
+        activeData = void 0;
+      };
+    }
+  };
+}
+export {
+  CONSOLE_SELECTION_ADDON_ID,
+  SelectedMessageIndicator,
+  consoleSelectionService,
+  createConsoleSelectionAddon,
+  createConsoleSelectionController
+};

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@moyarich/console-addon-selection",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "First-party semantic output selection for @moyarich/console hosts.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "development": "./src/index.tsx",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com"
+  },
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@moyarich/console-core": "^0.1.0",
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@moyarich/console-core": "0.1.0",
+    "@types/react": "^19.1.12",
+    "react": "^19.2.7",
+    "typescript": "^5.9.2",
+    "vite": "^7.1.5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moyarich/console.git",
+    "directory": "packages/addons/selection"
+  },
+  "bugs": {
+    "url": "https://github.com/moyarich/console/issues"
+  },
+  "homepage": "https://github.com/moyarich/console#readme",
+  "keywords": [
+    "console",
+    "addon",
+    "selection",
+    "developer-tools"
+  ],
+  "publisher": "moyarich",
+  "author": "Moya Richards",
+  "private": false
+}