@moyarich/console-addon-process-state 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# @moyarich/console-addon-process-state
 
-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.
+Track terminal process progress. Interpret OSC progress, working directory, command lifecycle, and notifications without requiring xterm.js.
+
+[Documentation and live examples](https://moyarich.github.io/console/)
+
+## Install
+
+```bash
+npm install @moyarich/console @moyarich/console-addon-process-state react
+```
+
+Configure the `@moyarich` scope and authenticate with GitHub Packages as described in the [installation guide](../../../README.md#installation).
+
+Required peer dependencies: `@moyarich/console-core@^0.2.0`, `react@>=18`.
+
+## Quick start
+
+```tsx
+import { Console } from "@moyarich/console";
+import { createConsoleProcessStateAddon } from "@moyarich/console-addon-process-state";
+
+const addons = [createConsoleProcessStateAddon()];
+
+// Pass your application's terminal output entries to Console.
+<Console mode="terminal" messages={messages} addons={addons} />;
+```
+
+The addon is optional and can be combined with other Console addons. Use terminal mode when passing process output.
+
+## 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/ProgressIndicator.d.cts

@@ -0,0 +1,19 @@
+import { type ProcessStateTranslations } from "./localization.cjs";
+import { type CSSProperties } from "react";
+import type { ProcessStateController } from "./index.cjs";
+
+export interface ConsoleProgressIndicatorOptions {
+    locale?: string;
+    translations?: ProcessStateTranslations;
+    className?: string;
+    style?: CSSProperties;
+    /** Custom label for the determinate progress mode. */
+    format?: (percentage: number, state: number) => string;
+    /** Keep the progress strip visible after a clear command. */
+    showCleared?: boolean;
+}
+export interface ConsoleProgressIndicatorProps extends ConsoleProgressIndicatorOptions {
+    controller: ProcessStateController;
+}
+/** Read-only, optional status strip; it never modifies terminal output or scroll position. */
+export declare function ConsoleProgressIndicator({ controller, className, style, format, showCleared, locale, translations, }: ConsoleProgressIndicatorProps): import("react").JSX.Element | null;

package/dist/ProgressIndicator.d.ts

@@ -0,0 +1,19 @@
+import { type ProcessStateTranslations } from "./localization.js";
+import { type CSSProperties } from "react";
+import type { ProcessStateController } from "./index.js";
+
+export interface ConsoleProgressIndicatorOptions {
+    locale?: string;
+    translations?: ProcessStateTranslations;
+    className?: string;
+    style?: CSSProperties;
+    /** Custom label for the determinate progress mode. */
+    format?: (percentage: number, state: number) => string;
+    /** Keep the progress strip visible after a clear command. */
+    showCleared?: boolean;
+}
+export interface ConsoleProgressIndicatorProps extends ConsoleProgressIndicatorOptions {
+    controller: ProcessStateController;
+}
+/** Read-only, optional status strip; it never modifies terminal output or scroll position. */
+export declare function ConsoleProgressIndicator({ controller, className, style, format, showCleared, locale, translations, }: ConsoleProgressIndicatorProps): import("react").JSX.Element | null;

package/dist/console-addon-process-state.css

@@ -0,0 +1,66 @@
+.console-progress-indicator {
+  --_progress-fg: var(
+    --console-progress-color,
+    var(--console-color-accent, currentColor)
+  );
+  --_progress-track: var(
+    --console-progress-track,
+    color-mix(in srgb, currentColor 12%, transparent)
+  );
+  --_progress-text: var(--console-progress-text, inherit);
+  /* This overlay has no layout height: updates cannot resize or scroll the terminal. */
+  position: sticky;
+  top: 0;
+  z-index: 2;
+  display: flex;
+  justify-content: flex-end;
+  align-items: center;
+  gap: var(--console-progress-gap, 0.75rem);
+  box-sizing: border-box;
+  height: 0;
+  min-height: 0;
+  padding: 0 var(--console-progress-inline-padding, 0.75rem);
+  pointer-events: none;
+  color: var(--_progress-text);
+  font: inherit;
+  transform: translateY(var(--console-progress-offset, 0.25rem));
+}
+.console-progress-indicator__label {
+  flex: none;
+  font-size: 0.8em;
+}
+.console-progress-indicator__track {
+  flex: 1;
+  height: 0.35rem;
+  border-radius: 999px;
+  background: var(--_progress-track);
+  overflow: hidden;
+}
+.console-progress-indicator__fill {
+  height: 100%;
+  background: var(--_progress-fg);
+  transition: width 120ms linear;
+}
+.console-progress-indicator[data-state="2"] .console-progress-indicator__fill {
+  background: var(--console-progress-error, #b42318);
+}
+.console-progress-indicator[data-state="4"] .console-progress-indicator__fill {
+  background: var(--console-progress-paused, #a46b00);
+}
+.console-progress-indicator[data-state="3"] .console-progress-indicator__fill {
+  animation: console-progress-motion 1.5s ease-in-out infinite alternate;
+}
+@keyframes console-progress-motion {
+  from {
+    transform: translateX(0);
+  }
+  to {
+    transform: translateX(230%);
+  }
+}
+@media (prefers-reduced-motion: reduce) {
+  .console-progress-indicator__fill {
+    transition: none;
+    animation: none !important;
+  }
+}

package/dist/index.cjs

@@ -0,0 +1,326 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const jsxRuntime = require("react/jsx-runtime");
+const consoleCore = require("@moyarich/console-core");
+const cleared$3 = "Progress cleared";
+const working$3 = "Working";
+const error$3 = "Process error";
+const paused$3 = "Paused";
+const progress$3 = "In progress";
+const en = {
+  cleared: cleared$3,
+  working: working$3,
+  error: error$3,
+  paused: paused$3,
+  progress: progress$3
+};
+const cleared$2 = "Progreso borrado";
+const working$2 = "Trabajando";
+const error$2 = "Error del proceso";
+const paused$2 = "En pausa";
+const progress$2 = "En curso";
+const es = {
+  cleared: cleared$2,
+  working: working$2,
+  error: error$2,
+  paused: paused$2,
+  progress: progress$2
+};
+const cleared$1 = "Progression effacée";
+const working$1 = "En cours";
+const error$1 = "Erreur du processus";
+const paused$1 = "En pause";
+const progress$1 = "En progression";
+const fr = {
+  cleared: cleared$1,
+  working: working$1,
+  error: error$1,
+  paused: paused$1,
+  progress: progress$1
+};
+const cleared = "Progresso limpo";
+const working = "Trabalhando";
+const error = "Erro do processo";
+const paused = "Pausado";
+const progress = "Em andamento";
+const pt = {
+  cleared,
+  working,
+  error,
+  paused,
+  progress
+};
+const locales = { en, es, fr, pt };
+function resolveProcessStateMessages(locale = "en", overrides) {
+  const tag = locale.replace(/_/g, "-").toLowerCase();
+  return {
+    ...en,
+    ...locales[tag] ?? locales[tag.split("-")[0]] ?? {},
+    ...overrides
+  };
+}
+function ConsoleProgressIndicator({
+  controller,
+  className,
+  style,
+  format,
+  showCleared = false,
+  locale = "en",
+  translations
+}) {
+  const state = react.useSyncExternalStore(
+    controller.subscribe,
+    controller.getState,
+    controller.getState
+  );
+  const progress2 = state.progress;
+  const labels = resolveProcessStateMessages(locale, translations);
+  if (!progress2 || progress2.state === 0 && !showCleared) return null;
+  const value = progress2.value ?? 0;
+  const label = progress2.state === 0 ? labels.cleared : progress2.state === 3 ? labels.working : progress2.state === 2 ? labels.error : progress2.state === 4 ? labels.paused : labels.progress;
+  const description = progress2.state === 0 ? label : progress2.state === 3 ? label : format?.(value, progress2.state) ?? `${label}: ${value}%`;
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      className: ["console-progress-indicator", className].filter(Boolean).join(" "),
+      "data-state": progress2.state,
+      style,
+      role: "status",
+      "aria-live": "polite",
+      "aria-label": description,
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "console-progress-indicator__label", children: description }),
+        progress2.state !== 0 && /* @__PURE__ */ jsxRuntime.jsx(
+          "div",
+          {
+            className: "console-progress-indicator__track",
+            role: "progressbar",
+            "aria-label": label,
+            "aria-valuemin": 0,
+            "aria-valuemax": 100,
+            "aria-valuenow": progress2.state === 3 ? void 0 : value,
+            children: /* @__PURE__ */ jsxRuntime.jsx(
+              "div",
+              {
+                className: "console-progress-indicator__fill",
+                style: { width: `${progress2.state === 3 ? 30 : value}%` }
+              }
+            )
+          }
+        )
+      ]
+    }
+  );
+}
+const CONSOLE_PROCESS_STATE_ADDON_ID = "@moyarich/console-addon-process-state";
+const consoleProcessStateService = consoleCore.createConsoleServiceToken(
+  CONSOLE_PROCESS_STATE_ADDON_ID + ".controller"
+);
+function createProcessStateController() {
+  let state = { notifications: [] };
+  let events = [];
+  const listeners = /* @__PURE__ */ new Set();
+  const emit = () => {
+    for (const listener of listeners) listener();
+  };
+  return {
+    getState: () => state,
+    getEvents: () => events,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    reset() {
+      state = { notifications: [] };
+      events = [];
+      emit();
+    },
+    apply(event) {
+      events = [...events, event];
+      switch (event.type) {
+        case "progress": {
+          const previous = state.progress?.value ?? 0;
+          const value = event.state === 0 ? 0 : event.state === 3 ? previous : (event.state === 2 || event.state === 4) && !event.value ? previous : event.value ?? previous;
+          state = {
+            ...state,
+            progress: {
+              state: event.state,
+              value: Math.max(0, Math.min(100, value))
+            }
+          };
+          break;
+        }
+        case "cwd":
+          state = { ...state, cwd: event.cwd };
+          break;
+        case "command":
+          state = {
+            ...state,
+            command: {
+              phase: event.phase,
+              ...event.exitCode === void 0 ? {} : { exitCode: event.exitCode }
+            }
+          };
+          break;
+        case "notification":
+          state = {
+            ...state,
+            notifications: [
+              ...state.notifications,
+              { title: event.title, message: event.message }
+            ]
+          };
+          break;
+      }
+      emit();
+    }
+  };
+}
+const sanitize = (value) => Array.from(value).filter((character) => {
+  const code = character.charCodeAt(0);
+  return code >= 32 && code !== 127 && code !== 155;
+}).join("").slice(0, 1024);
+function interpret(payload) {
+  const parts = payload.split(";");
+  if (parts[0] === "9" && parts[1] === "4") {
+    if (!/^[0-4]$/.test(parts[2] ?? "")) return void 0;
+    if (parts.length > 4) return void 0;
+    const numeric = parts[3] === void 0 || parts[3] === "" ? void 0 : parts[3];
+    if (numeric !== void 0 && !/^\d+$/.test(numeric)) return void 0;
+    if (parts[2] === "1" && numeric === void 0) return void 0;
+    const value = numeric === void 0 ? void 0 : Math.min(100, Number(numeric));
+    return {
+      type: "progress",
+      state: Number(parts[2]),
+      ...value === void 0 ? {} : { value }
+    };
+  }
+  if (parts[0] === "9" && parts[1] === "9") {
+    const cwd = sanitize(parts.slice(2).join(";"));
+    return cwd ? { type: "cwd", cwd } : void 0;
+  }
+  if (parts[0] === "133") {
+    const phases = {
+      A: { type: "command", phase: "prompt" },
+      B: { type: "command", phase: "started" },
+      C: { type: "command", phase: "executing" }
+    };
+    if (parts[1] === "D") {
+      if (parts.length > 3 || parts[2] !== void 0 && !/^-?\d{1,8}$/.test(parts[2]))
+        return void 0;
+      return {
+        type: "command",
+        phase: "finished",
+        ...parts[2] === void 0 ? {} : { exitCode: Number(parts[2]) }
+      };
+    }
+    return parts.length === 2 ? phases[parts[1] ?? ""] : void 0;
+  }
+  if (parts[0] === "777" && parts[1] === "notify") {
+    const title = sanitize(parts[2] ?? "");
+    const message = sanitize(parts.slice(3).join(";"));
+    return title || message ? { type: "notification", title, message } : void 0;
+  }
+  return void 0;
+}
+function createProcessStateParser(controller) {
+  let pending = "";
+  return {
+    id: CONSOLE_PROCESS_STATE_ADDON_ID,
+    reset() {
+      pending = "";
+      controller.reset();
+    },
+    parse({ output }) {
+      const input = pending + output.data;
+      pending = "";
+      let visible = "";
+      const events = [];
+      let pos = 0;
+      while (pos < input.length) {
+        const begin = input.indexOf("\x1B", pos);
+        if (begin < 0) {
+          visible += input.slice(pos);
+          break;
+        }
+        visible += input.slice(pos, begin);
+        if (begin === input.length - 1) {
+          pending = input.slice(begin);
+          break;
+        }
+        if (input[begin + 1] !== "]") {
+          visible += "\x1B";
+          pos = begin + 1;
+          continue;
+        }
+        let end = begin + 2;
+        while (end < input.length && input[end] !== "\x07" && !(input[end] === "\x1B" && input[end + 1] === "\\"))
+          end++;
+        if (end >= input.length || input[end] === "\x1B" && end + 1 >= input.length) {
+          pending = input.slice(begin).slice(0, 8192);
+          break;
+        }
+        const payload = input.slice(begin + 2, end);
+        const event = payload.length <= 4096 ? interpret(payload) : void 0;
+        if (event) {
+          events.push(event);
+          controller.apply(event);
+        } else {
+          visible += input.slice(begin, end + (input[end] === "\x07" ? 1 : 2));
+        }
+        pos = end + (input[end] === "\x07" ? 1 : 2);
+      }
+      return {
+        data: visible,
+        events: events.map((event) => ({
+          type: event.type,
+          data: { ...event }
+        })),
+        omit: visible.length === 0
+      };
+    }
+  };
+}
+function createConsoleProcessStateAddon(options = {}) {
+  const isController = "apply" in options;
+  const controller = isController ? options : options.controller ?? createProcessStateController();
+  const indicator = isController ? false : options.indicator;
+  return {
+    id: CONSOLE_PROCESS_STATE_ADDON_ID,
+    controller,
+    activate(host) {
+      host.services.provide(consoleProcessStateService, controller);
+      host.extensions.register(
+        consoleCore.consoleExtensionPoints.processControlParser,
+        createProcessStateParser(controller),
+        {
+          id: CONSOLE_PROCESS_STATE_ADDON_ID + ":parser"
+        }
+      );
+      if (indicator) {
+        host.extensions.register(
+          consoleCore.consoleExtensionPoints.panelElement,
+          {
+            id: CONSOLE_PROCESS_STATE_ADDON_ID + ":indicator",
+            placement: "before-output",
+            render: () => react.createElement(ConsoleProgressIndicator, {
+              controller,
+              ...typeof indicator === "object" ? indicator : {}
+            })
+          },
+          { id: CONSOLE_PROCESS_STATE_ADDON_ID + ":indicator" }
+        );
+      }
+    }
+  };
+}
+exports.CONSOLE_PROCESS_STATE_ADDON_ID = CONSOLE_PROCESS_STATE_ADDON_ID;
+exports.ConsoleProgressIndicator = ConsoleProgressIndicator;
+exports.consoleProcessStateService = consoleProcessStateService;
+exports.createConsoleProcessStateAddon = createConsoleProcessStateAddon;
+exports.createProcessStateController = createProcessStateController;
+exports.createProcessStateParser = createProcessStateParser;
+exports.resolveProcessStateMessages = resolveProcessStateMessages;

package/dist/index.d.cts

@@ -0,0 +1,58 @@
+import { type ConsoleProgressIndicatorOptions } from "./ProgressIndicator.cjs";
+export { ConsoleProgressIndicator } from "./ProgressIndicator.cjs";
+export { resolveProcessStateMessages } from "./localization.cjs";
+export type { ProcessStateTranslations } from "./localization.cjs";
+export type { ConsoleProgressIndicatorOptions } from "./ProgressIndicator.cjs";
+import { type ConsoleAddon, type ConsoleProcessControlParser } from "@moyarich/console-core";
+export declare const CONSOLE_PROCESS_STATE_ADDON_ID = "@moyarich/console-addon-process-state";
+export interface ProcessState {
+    readonly progress?: {
+        readonly state: number;
+        readonly value?: number;
+    };
+    readonly cwd?: string;
+    readonly command?: {
+        readonly phase: "prompt" | "started" | "executing" | "finished";
+        readonly exitCode?: number;
+    };
+    readonly notifications: readonly {
+        readonly title: string;
+        readonly message: string;
+    }[];
+}
+export type ProcessStateEvent = {
+    readonly type: "progress";
+    readonly state: number;
+    readonly value?: number;
+} | {
+    readonly type: "cwd";
+    readonly cwd: string;
+} | {
+    readonly type: "command";
+    readonly phase: "prompt" | "started" | "executing" | "finished";
+    readonly exitCode?: number;
+} | {
+    readonly type: "notification";
+    readonly title: string;
+    readonly message: string;
+};
+export interface ProcessStateController {
+    getState(): ProcessState;
+    getEvents(): readonly ProcessStateEvent[];
+    subscribe(listener: () => void): () => void;
+    reset(): void;
+    apply(event: ProcessStateEvent): void;
+}
+export declare const consoleProcessStateService: import("@moyarich/console-core").ConsoleServiceToken<ProcessStateController>;
+export declare function createProcessStateController(): ProcessStateController;
+/** Stateful OSC decoder; parsed sequences are removed while printable text is preserved. */
+export declare function createProcessStateParser(controller: ProcessStateController): ConsoleProcessControlParser;
+export interface ProcessStateAddon extends ConsoleAddon {
+    readonly controller: ProcessStateController;
+}
+export interface ProcessStateAddonOptions {
+    controller?: ProcessStateController;
+    /** Set to true or provide options to display a compact status strip. Default: headless. */
+    indicator?: boolean | ConsoleProgressIndicatorOptions;
+}
+export declare function createConsoleProcessStateAddon(options?: ProcessStateController | ProcessStateAddonOptions): ProcessStateAddon;

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+import { type ConsoleProgressIndicatorOptions } from "./ProgressIndicator.js";
+export { ConsoleProgressIndicator } from "./ProgressIndicator.js";
+export { resolveProcessStateMessages } from "./localization.js";
+export type { ProcessStateTranslations } from "./localization.js";
+export type { ConsoleProgressIndicatorOptions } from "./ProgressIndicator.js";
+import { type ConsoleAddon, type ConsoleProcessControlParser } from "@moyarich/console-core";
+export declare const CONSOLE_PROCESS_STATE_ADDON_ID = "@moyarich/console-addon-process-state";
+export interface ProcessState {
+    readonly progress?: {
+        readonly state: number;
+        readonly value?: number;
+    };
+    readonly cwd?: string;
+    readonly command?: {
+        readonly phase: "prompt" | "started" | "executing" | "finished";
+        readonly exitCode?: number;
+    };
+    readonly notifications: readonly {
+        readonly title: string;
+        readonly message: string;
+    }[];
+}
+export type ProcessStateEvent = {
+    readonly type: "progress";
+    readonly state: number;
+    readonly value?: number;
+} | {
+    readonly type: "cwd";
+    readonly cwd: string;
+} | {
+    readonly type: "command";
+    readonly phase: "prompt" | "started" | "executing" | "finished";
+    readonly exitCode?: number;
+} | {
+    readonly type: "notification";
+    readonly title: string;
+    readonly message: string;
+};
+export interface ProcessStateController {
+    getState(): ProcessState;
+    getEvents(): readonly ProcessStateEvent[];
+    subscribe(listener: () => void): () => void;
+    reset(): void;
+    apply(event: ProcessStateEvent): void;
+}
+export declare const consoleProcessStateService: import("@moyarich/console-core").ConsoleServiceToken<ProcessStateController>;
+export declare function createProcessStateController(): ProcessStateController;
+/** Stateful OSC decoder; parsed sequences are removed while printable text is preserved. */
+export declare function createProcessStateParser(controller: ProcessStateController): ConsoleProcessControlParser;
+export interface ProcessStateAddon extends ConsoleAddon {
+    readonly controller: ProcessStateController;
+}
+export interface ProcessStateAddonOptions {
+    controller?: ProcessStateController;
+    /** Set to true or provide options to display a compact status strip. Default: headless. */
+    indicator?: boolean | ConsoleProgressIndicatorOptions;
+}
+export declare function createConsoleProcessStateAddon(options?: ProcessStateController | ProcessStateAddonOptions): ProcessStateAddon;

package/dist/index.js

@@ -0,0 +1,326 @@
+import { useSyncExternalStore, createElement } from "react";
+import { jsxs, jsx } from "react/jsx-runtime";
+import { createConsoleServiceToken, consoleExtensionPoints } from "@moyarich/console-core";
+const cleared$3 = "Progress cleared";
+const working$3 = "Working";
+const error$3 = "Process error";
+const paused$3 = "Paused";
+const progress$3 = "In progress";
+const en = {
+  cleared: cleared$3,
+  working: working$3,
+  error: error$3,
+  paused: paused$3,
+  progress: progress$3
+};
+const cleared$2 = "Progreso borrado";
+const working$2 = "Trabajando";
+const error$2 = "Error del proceso";
+const paused$2 = "En pausa";
+const progress$2 = "En curso";
+const es = {
+  cleared: cleared$2,
+  working: working$2,
+  error: error$2,
+  paused: paused$2,
+  progress: progress$2
+};
+const cleared$1 = "Progression effacée";
+const working$1 = "En cours";
+const error$1 = "Erreur du processus";
+const paused$1 = "En pause";
+const progress$1 = "En progression";
+const fr = {
+  cleared: cleared$1,
+  working: working$1,
+  error: error$1,
+  paused: paused$1,
+  progress: progress$1
+};
+const cleared = "Progresso limpo";
+const working = "Trabalhando";
+const error = "Erro do processo";
+const paused = "Pausado";
+const progress = "Em andamento";
+const pt = {
+  cleared,
+  working,
+  error,
+  paused,
+  progress
+};
+const locales = { en, es, fr, pt };
+function resolveProcessStateMessages(locale = "en", overrides) {
+  const tag = locale.replace(/_/g, "-").toLowerCase();
+  return {
+    ...en,
+    ...locales[tag] ?? locales[tag.split("-")[0]] ?? {},
+    ...overrides
+  };
+}
+function ConsoleProgressIndicator({
+  controller,
+  className,
+  style,
+  format,
+  showCleared = false,
+  locale = "en",
+  translations
+}) {
+  const state = useSyncExternalStore(
+    controller.subscribe,
+    controller.getState,
+    controller.getState
+  );
+  const progress2 = state.progress;
+  const labels = resolveProcessStateMessages(locale, translations);
+  if (!progress2 || progress2.state === 0 && !showCleared) return null;
+  const value = progress2.value ?? 0;
+  const label = progress2.state === 0 ? labels.cleared : progress2.state === 3 ? labels.working : progress2.state === 2 ? labels.error : progress2.state === 4 ? labels.paused : labels.progress;
+  const description = progress2.state === 0 ? label : progress2.state === 3 ? label : format?.(value, progress2.state) ?? `${label}: ${value}%`;
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: ["console-progress-indicator", className].filter(Boolean).join(" "),
+      "data-state": progress2.state,
+      style,
+      role: "status",
+      "aria-live": "polite",
+      "aria-label": description,
+      children: [
+        /* @__PURE__ */ jsx("span", { className: "console-progress-indicator__label", children: description }),
+        progress2.state !== 0 && /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: "console-progress-indicator__track",
+            role: "progressbar",
+            "aria-label": label,
+            "aria-valuemin": 0,
+            "aria-valuemax": 100,
+            "aria-valuenow": progress2.state === 3 ? void 0 : value,
+            children: /* @__PURE__ */ jsx(
+              "div",
+              {
+                className: "console-progress-indicator__fill",
+                style: { width: `${progress2.state === 3 ? 30 : value}%` }
+              }
+            )
+          }
+        )
+      ]
+    }
+  );
+}
+const CONSOLE_PROCESS_STATE_ADDON_ID = "@moyarich/console-addon-process-state";
+const consoleProcessStateService = createConsoleServiceToken(
+  CONSOLE_PROCESS_STATE_ADDON_ID + ".controller"
+);
+function createProcessStateController() {
+  let state = { notifications: [] };
+  let events = [];
+  const listeners = /* @__PURE__ */ new Set();
+  const emit = () => {
+    for (const listener of listeners) listener();
+  };
+  return {
+    getState: () => state,
+    getEvents: () => events,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    reset() {
+      state = { notifications: [] };
+      events = [];
+      emit();
+    },
+    apply(event) {
+      events = [...events, event];
+      switch (event.type) {
+        case "progress": {
+          const previous = state.progress?.value ?? 0;
+          const value = event.state === 0 ? 0 : event.state === 3 ? previous : (event.state === 2 || event.state === 4) && !event.value ? previous : event.value ?? previous;
+          state = {
+            ...state,
+            progress: {
+              state: event.state,
+              value: Math.max(0, Math.min(100, value))
+            }
+          };
+          break;
+        }
+        case "cwd":
+          state = { ...state, cwd: event.cwd };
+          break;
+        case "command":
+          state = {
+            ...state,
+            command: {
+              phase: event.phase,
+              ...event.exitCode === void 0 ? {} : { exitCode: event.exitCode }
+            }
+          };
+          break;
+        case "notification":
+          state = {
+            ...state,
+            notifications: [
+              ...state.notifications,
+              { title: event.title, message: event.message }
+            ]
+          };
+          break;
+      }
+      emit();
+    }
+  };
+}
+const sanitize = (value) => Array.from(value).filter((character) => {
+  const code = character.charCodeAt(0);
+  return code >= 32 && code !== 127 && code !== 155;
+}).join("").slice(0, 1024);
+function interpret(payload) {
+  const parts = payload.split(";");
+  if (parts[0] === "9" && parts[1] === "4") {
+    if (!/^[0-4]$/.test(parts[2] ?? "")) return void 0;
+    if (parts.length > 4) return void 0;
+    const numeric = parts[3] === void 0 || parts[3] === "" ? void 0 : parts[3];
+    if (numeric !== void 0 && !/^\d+$/.test(numeric)) return void 0;
+    if (parts[2] === "1" && numeric === void 0) return void 0;
+    const value = numeric === void 0 ? void 0 : Math.min(100, Number(numeric));
+    return {
+      type: "progress",
+      state: Number(parts[2]),
+      ...value === void 0 ? {} : { value }
+    };
+  }
+  if (parts[0] === "9" && parts[1] === "9") {
+    const cwd = sanitize(parts.slice(2).join(";"));
+    return cwd ? { type: "cwd", cwd } : void 0;
+  }
+  if (parts[0] === "133") {
+    const phases = {
+      A: { type: "command", phase: "prompt" },
+      B: { type: "command", phase: "started" },
+      C: { type: "command", phase: "executing" }
+    };
+    if (parts[1] === "D") {
+      if (parts.length > 3 || parts[2] !== void 0 && !/^-?\d{1,8}$/.test(parts[2]))
+        return void 0;
+      return {
+        type: "command",
+        phase: "finished",
+        ...parts[2] === void 0 ? {} : { exitCode: Number(parts[2]) }
+      };
+    }
+    return parts.length === 2 ? phases[parts[1] ?? ""] : void 0;
+  }
+  if (parts[0] === "777" && parts[1] === "notify") {
+    const title = sanitize(parts[2] ?? "");
+    const message = sanitize(parts.slice(3).join(";"));
+    return title || message ? { type: "notification", title, message } : void 0;
+  }
+  return void 0;
+}
+function createProcessStateParser(controller) {
+  let pending = "";
+  return {
+    id: CONSOLE_PROCESS_STATE_ADDON_ID,
+    reset() {
+      pending = "";
+      controller.reset();
+    },
+    parse({ output }) {
+      const input = pending + output.data;
+      pending = "";
+      let visible = "";
+      const events = [];
+      let pos = 0;
+      while (pos < input.length) {
+        const begin = input.indexOf("\x1B", pos);
+        if (begin < 0) {
+          visible += input.slice(pos);
+          break;
+        }
+        visible += input.slice(pos, begin);
+        if (begin === input.length - 1) {
+          pending = input.slice(begin);
+          break;
+        }
+        if (input[begin + 1] !== "]") {
+          visible += "\x1B";
+          pos = begin + 1;
+          continue;
+        }
+        let end = begin + 2;
+        while (end < input.length && input[end] !== "\x07" && !(input[end] === "\x1B" && input[end + 1] === "\\"))
+          end++;
+        if (end >= input.length || input[end] === "\x1B" && end + 1 >= input.length) {
+          pending = input.slice(begin).slice(0, 8192);
+          break;
+        }
+        const payload = input.slice(begin + 2, end);
+        const event = payload.length <= 4096 ? interpret(payload) : void 0;
+        if (event) {
+          events.push(event);
+          controller.apply(event);
+        } else {
+          visible += input.slice(begin, end + (input[end] === "\x07" ? 1 : 2));
+        }
+        pos = end + (input[end] === "\x07" ? 1 : 2);
+      }
+      return {
+        data: visible,
+        events: events.map((event) => ({
+          type: event.type,
+          data: { ...event }
+        })),
+        omit: visible.length === 0
+      };
+    }
+  };
+}
+function createConsoleProcessStateAddon(options = {}) {
+  const isController = "apply" in options;
+  const controller = isController ? options : options.controller ?? createProcessStateController();
+  const indicator = isController ? false : options.indicator;
+  return {
+    id: CONSOLE_PROCESS_STATE_ADDON_ID,
+    controller,
+    activate(host) {
+      host.services.provide(consoleProcessStateService, controller);
+      host.extensions.register(
+        consoleExtensionPoints.processControlParser,
+        createProcessStateParser(controller),
+        {
+          id: CONSOLE_PROCESS_STATE_ADDON_ID + ":parser"
+        }
+      );
+      if (indicator) {
+        host.extensions.register(
+          consoleExtensionPoints.panelElement,
+          {
+            id: CONSOLE_PROCESS_STATE_ADDON_ID + ":indicator",
+            placement: "before-output",
+            render: () => createElement(ConsoleProgressIndicator, {
+              controller,
+              ...typeof indicator === "object" ? indicator : {}
+            })
+          },
+          { id: CONSOLE_PROCESS_STATE_ADDON_ID + ":indicator" }
+        );
+      }
+    }
+  };
+}
+export {
+  CONSOLE_PROCESS_STATE_ADDON_ID,
+  ConsoleProgressIndicator,
+  consoleProcessStateService,
+  createConsoleProcessStateAddon,
+  createProcessStateController,
+  createProcessStateParser,
+  resolveProcessStateMessages
+};

package/dist/locales/en.json

@@ -0,0 +1,7 @@
+{
+  "cleared": "Progress cleared",
+  "working": "Working",
+  "error": "Process error",
+  "paused": "Paused",
+  "progress": "In progress"
+}

package/dist/locales/es.json

@@ -0,0 +1,7 @@
+{
+  "cleared": "Progreso borrado",
+  "working": "Trabajando",
+  "error": "Error del proceso",
+  "paused": "En pausa",
+  "progress": "En curso"
+}

package/dist/locales/fr.json

@@ -0,0 +1,7 @@
+{
+  "cleared": "Progression effacée",
+  "working": "En cours",
+  "error": "Erreur du processus",
+  "paused": "En pause",
+  "progress": "En progression"
+}

package/dist/locales/pt.json

@@ -0,0 +1,7 @@
+{
+  "cleared": "Progresso limpo",
+  "working": "Trabalhando",
+  "error": "Erro do processo",
+  "paused": "Pausado",
+  "progress": "Em andamento"
+}

package/dist/localization.d.cts

@@ -0,0 +1,3 @@
+import en from "./locales/en.json";
+export type ProcessStateTranslations = Partial<typeof en>;
+export declare function resolveProcessStateMessages(locale?: string, overrides?: ProcessStateTranslations): typeof en;

package/dist/localization.d.ts

@@ -0,0 +1,3 @@
+import en from "./locales/en.json";
+export type ProcessStateTranslations = Partial<typeof en>;
+export declare function resolveProcessStateMessages(locale?: string, overrides?: ProcessStateTranslations): typeof en;

package/dist/styles.css

@@ -0,0 +1,67 @@
+/* src/ProgressIndicator.css */
+.console-progress-indicator {
+  --_progress-fg: var(
+    --console-progress-color,
+    var(--console-color-accent, currentColor)
+  );
+  --_progress-track: var(
+    --console-progress-track,
+    color-mix(in srgb, currentColor 12%, transparent)
+  );
+  --_progress-text: var(--console-progress-text, inherit);
+  /* This overlay has no layout height: updates cannot resize or scroll the terminal. */
+  position: sticky;
+  top: 0;
+  z-index: 2;
+  display: flex;
+  justify-content: flex-end;
+  align-items: center;
+  gap: var(--console-progress-gap, 0.75rem);
+  box-sizing: border-box;
+  height: 0;
+  min-height: 0;
+  padding: 0 var(--console-progress-inline-padding, 0.75rem);
+  pointer-events: none;
+  color: var(--_progress-text);
+  font: inherit;
+  transform: translateY(var(--console-progress-offset, 0.25rem));
+}
+.console-progress-indicator__label {
+  flex: none;
+  font-size: 0.8em;
+}
+.console-progress-indicator__track {
+  flex: 1;
+  height: 0.35rem;
+  border-radius: 999px;
+  background: var(--_progress-track);
+  overflow: hidden;
+}
+.console-progress-indicator__fill {
+  height: 100%;
+  background: var(--_progress-fg);
+  transition: width 120ms linear;
+}
+.console-progress-indicator[data-state="2"] .console-progress-indicator__fill {
+  background: var(--console-progress-error, #b42318);
+}
+.console-progress-indicator[data-state="4"] .console-progress-indicator__fill {
+  background: var(--console-progress-paused, #a46b00);
+}
+.console-progress-indicator[data-state="3"] .console-progress-indicator__fill {
+  animation: console-progress-motion 1.5s ease-in-out infinite alternate;
+}
+@keyframes console-progress-motion {
+  from {
+    transform: translateX(0);
+  }
+  to {
+    transform: translateX(230%);
+  }
+}
+@media (prefers-reduced-motion: reduce) {
+  .console-progress-indicator__fill {
+    transition: none;
+    animation: none !important;
+  }
+}

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@moyarich/console-addon-process-state",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Observable process state from OSC terminal control sequences",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com"
+  },
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json && node ../../../scripts/prepare-cjs-types.mjs && node ../../../scripts/prepare-addon-styles.mjs",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@moyarich/console-core": "^0.2.0",
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@moyarich/console-core": "0.2.0",
+    "typescript": "^5.9.2",
+    "vite": "^7.1.5",
+    "react": "^19.2.7",
+    "@types/react": "^19.1.12"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moyarich/console.git",
+    "directory": "packages/addons/process-state"
+  },
+  "bugs": {
+    "url": "https://github.com/moyarich/console/issues"
+  },
+  "homepage": "https://github.com/moyarich/console#readme",
+  "keywords": [
+    "console",
+    "addon",
+    "osc",
+    "terminal",
+    "process-state"
+  ],
+  "sideEffects": [
+    "./src/ProgressIndicator.css",
+    "./dist/index.js",
+    "./dist/index.cjs",
+    "./dist/styles.css"
+  ],
+  "publisher": "moyarich",
+  "author": "Moya Richards",
+  "engines": {
+    "node": ">=24"
+  },
+  "private": false
+}