@lostgradient/cinder 0.2.0 → 0.4.0

package/dist/components/event-stream-viewer/event-stream-viewer.types.d.ts

@@ -0,0 +1,202 @@
+import type { HTMLAttributes } from 'svelte/elements';
+/** Severity / tone of an event entry. */
+export type EventSeverity = 'debug' | 'info' | 'success' | 'warning' | 'error';
+/** Connection state for the event stream source. */
+export type EventStreamState = 'connected' | 'connecting' | 'disconnected' | 'error';
+/** Schema-facing event detail value. Kept permissive to match the runtime `unknown` prop. */
+export type EventStreamSchemaDetailValue = unknown;
+/**
+ * A single event entry in the stream.
+ *
+ * `id` must be stable and unique across the lifetime of the viewer — it drives
+ * React-style keyed reconciliation. Use a server-assigned ID or a deterministic
+ * hash, not `Math.random()`.
+ *
+ * @schemaObject
+ */
+export type StreamEvent = {
+    /** Stable unique identifier used as the keyed list identity. */
+    id: string;
+    /** Optional monotonically increasing integer stream sequence used to detect missed events. */
+    sequence?: number;
+    /** Machine-readable ISO 8601 datetime string rendered into `<time datetime>`. */
+    datetime: string;
+    /** Human-readable timestamp label (e.g. "12:04:32", "2m ago"). Falls back to `datetime`. */
+    timestamp?: string;
+    /** Severity tone that drives visual styling and the accessible label prefix. */
+    severity?: EventSeverity;
+    /** Origin label identifying which service, worker, or activity produced the event. */
+    source?: string;
+    /** One-line summary of the event. */
+    summary: string;
+    /** Optional structured JSON payload. Rendered in a collapsible JsonViewer. */
+    details?: unknown;
+};
+/** @schemaObject */
+export type EventStreamSchemaEvent = {
+    /** Stable unique identifier used as the keyed list identity. */
+    id: string;
+    /** Optional monotonically increasing integer stream sequence used to detect missed events. */
+    sequence?: number;
+    /** Machine-readable ISO 8601 datetime string rendered into `<time datetime>`. */
+    datetime: string;
+    /** Human-readable timestamp label (e.g. "12:04:32", "2m ago"). Falls back to `datetime`. */
+    timestamp?: string;
+    /** Severity tone that drives visual styling and the accessible label prefix. */
+    severity?: EventSeverity;
+    /** Origin label identifying which service, worker, or activity produced the event. */
+    source?: string;
+    /** One-line summary of the event. */
+    summary: string;
+    /**
+     * Optional structured JSON payload. Rendered in a collapsible JsonViewer.
+     *
+     * @schemaPermissive
+     */
+    details?: EventStreamSchemaDetailValue;
+};
+/**
+ * Boundary entry that marks a successful reconnect and how many retained events
+ * were replayed into the stream.
+ *
+ * @schemaObject
+ */
+export type StreamReconnectedBoundary = {
+    /** Stable unique identifier used as the keyed list identity. */
+    id: string;
+    /** Discriminator for reconnect boundary entries. */
+    kind: 'reconnected';
+    /** Optional machine-readable ISO 8601 datetime string for the reconnect moment. */
+    datetime?: string;
+    /** Optional human-readable timestamp label. Falls back to `datetime` when rendered. */
+    timestamp?: string;
+    /** Non-negative integer count of events replayed after the connection resumed. */
+    replayedCount: number;
+};
+/** A renderable stream item: either a normal event or a stream boundary marker. */
+export type EventStreamEntry = StreamEvent | StreamReconnectedBoundary;
+/**
+ * Schema-facing stream item shape for JSON Schema consumers.
+ */
+export type EventStreamSchemaEntry = EventStreamSchemaEvent | StreamReconnectedBoundary;
+/**
+ * Props for the EventStreamViewer component.
+ */
+export type EventStreamViewerProps = Omit<HTMLAttributes<HTMLDivElement>, 'class' | 'children'> & {
+    /** Events and additive boundary entries to render in chronological order, oldest first. */
+    events: EventStreamEntry[];
+    /**
+     * Current connection state. When provided, renders a StatusDot connection preset in
+     * the toolbar. Omit when the stream has no live transport.
+     */
+    connectionState?: EventStreamState;
+    /**
+     * When true, new events automatically scroll the list to the bottom.
+     * Set to false to pause follow-latest (e.g. while the user reads earlier events).
+     * Bindable so the parent can read the paused state the component sets internally.
+     */
+    followLatest?: boolean;
+    /**
+     * Whether to show the "events were truncated" notice. This is a boolean flag,
+     * not a count: the viewer never slices `events` itself. Set it to `true` when
+     * you have already trimmed the array (e.g. capped retention) and want users to
+     * know earlier events are not shown.
+     */
+    truncated?: boolean;
+    /**
+     * Show a loading skeleton instead of the event list. Use while the first
+     * batch of events is in flight.
+     */
+    loading?: boolean;
+    /**
+     * Accessible label for the event list region. Required for accessibility.
+     * Defaults to "Event stream".
+     */
+    label?: string;
+    /**
+     * Enables sequence-gap markers when `events` is the complete, unfiltered
+     * stream. Leave false for retained windows, severity-filtered subsets, search
+     * results, or any other caller-trimmed event array.
+     */
+    detectSequenceGaps?: boolean;
+    /**
+     * Callback fired when the user clicks the "Copy visible" toolbar action.
+     * Receives the text of all currently visible events. When omitted the copy
+     * action is hidden.
+     */
+    oncopyvisible?: (text: string) => void;
+    /**
+     * Callback fired when the user updates the filter query in the toolbar's
+     * search field. The consumer is responsible for filtering `events` in
+     * response. When omitted the filter input is hidden.
+     */
+    onfilter?: (query: string) => void;
+    /**
+     * Current filter query value, for controlled usage. Pairs with `onfilter`.
+     */
+    filterQuery?: string;
+    /** Additional CSS classes applied to the root element. */
+    class?: string;
+};
+/**
+ * Cinder-specific schema surface for EventStreamViewer.
+ *
+ * Callback props are documented but marked unsupported because functions cannot
+ * be represented as JSON Schema controls.
+ */
+export type EventStreamViewerSchemaProps = {
+    /** Events and additive boundary entries to render in chronological order, oldest first. */
+    events: EventStreamSchemaEntry[];
+    /**
+     * Current connection state. When provided, renders a StatusDot in the toolbar.
+     * Omit when the stream has no live transport.
+     */
+    connectionState?: EventStreamState;
+    /**
+     * When true, new events automatically scroll the list to the bottom.
+     * Set to false to pause follow-latest (e.g. while the user reads earlier events).
+     * Bindable so the parent can read the paused state the component sets internally.
+     */
+    followLatest?: boolean;
+    /**
+     * Whether to show the "events were truncated" notice. This is a boolean flag,
+     * not a count: the viewer never slices `events` itself. Set it to `true` when
+     * you have already trimmed the array (e.g. capped retention) and want users to
+     * know earlier events are not shown.
+     */
+    truncated?: boolean;
+    /**
+     * Show a loading skeleton instead of the event list. Use while the first
+     * batch of events is in flight.
+     */
+    loading?: boolean;
+    /**
+     * Accessible label for the event list region. Required for accessibility.
+     * Defaults to "Event stream".
+     */
+    label?: string;
+    /**
+     * Enables sequence-gap markers when `events` is the complete, unfiltered
+     * stream. Leave false for retained windows, severity-filtered subsets, search
+     * results, or any other caller-trimmed event array.
+     */
+    detectSequenceGaps?: boolean;
+    /**
+     * Callback fired when the user clicks the "Copy visible" toolbar action.
+     * Receives the text of all currently visible events. When omitted the copy
+     * action is hidden.
+     */
+    oncopyvisible?: (text: string) => void;
+    /**
+     * Callback fired when the user updates the filter query in the toolbar's
+     * search field. The consumer is responsible for filtering `events` in
+     * response. When omitted the filter input is hidden.
+     */
+    onfilter?: (query: string) => void;
+    /**
+     * Current filter query value, for controlled usage. Pairs with `onfilter`.
+     */
+    filterQuery?: string;
+    /** Additional CSS classes applied to the root element. */
+    class?: string;
+};

package/dist/components/event-stream-viewer/event-stream-viewer.variables.d.ts

@@ -0,0 +1,2 @@
+declare const variables: readonly string[];
+export default variables;

package/dist/components/event-stream-viewer/event-stream-viewer.variables.js

@@ -0,0 +1,31 @@
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined")
+    return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/components/event-stream-viewer/event-stream-viewer.variables.ts
+var variables = ["--cinder-event-stream-viewer-severity-color"];
+var event_stream_viewer_variables_default = variables;
+export {
+  event_stream_viewer_variables_default as default
+};
+
+//# debugId=604E4B20A326155464756E2164756E21

package/dist/components/event-stream-viewer/index.d.ts

@@ -0,0 +1,5 @@
+import './event-stream-viewer.css';
+import EventStreamViewer from './event-stream-viewer.svelte';
+export default EventStreamViewer;
+export type { EventSeverity, EventStreamEntry, EventStreamSchemaDetailValue, EventStreamSchemaEntry, EventStreamSchemaEvent, EventStreamState, EventStreamViewerProps, EventStreamViewerSchemaProps, StreamEvent, StreamReconnectedBoundary, } from './event-stream-viewer.types.ts';
+export { EventStreamViewer };