@mindmakr/reins 0.0.0-stage → 0.1.0

package/dist/react.d.ts

@@ -0,0 +1,281 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { type Action } from '@mindmakr/reins';
+/**
+ * Registers an action while the component is mounted.
+ * `run` always sees the latest props; re-registers only when `deps` change.
+ */
+export declare function useReinsAction<I = any, O = any>(def: Action<I, O>, deps?: unknown[]): void;
+/** Exposes a state snapshot while the component is mounted. The getter always sees the latest render. */
+export declare function useReinsState(name: string, get: () => unknown): void;
+export interface ReinsPanelProps extends HTMLAttributes<HTMLDivElement> {
+    id: string;
+    children?: ReactNode;
+}
+/** A `<div data-reins={id}>` the agent can measure, inspect and snap. Other props go to the div. */
+export declare function ReinsPanel({ id, children, ...rest }: ReinsPanelProps): import("react").DetailedReactHTMLElement<{
+    'data-reins': string;
+    defaultChecked?: boolean | undefined;
+    defaultValue?: string | number | readonly string[] | undefined;
+    suppressContentEditableWarning?: boolean | undefined;
+    suppressHydrationWarning?: boolean | undefined;
+    accessKey?: string | undefined;
+    autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {});
+    autoFocus?: boolean | undefined;
+    className?: string | undefined;
+    contentEditable?: (boolean | "true" | "false") | "inherit" | "plaintext-only" | undefined;
+    contextMenu?: string | undefined;
+    dir?: string | undefined;
+    draggable?: (boolean | "true" | "false") | undefined;
+    enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined;
+    hidden?: boolean | undefined;
+    lang?: string | undefined;
+    nonce?: string | undefined;
+    slot?: string | undefined;
+    spellCheck?: (boolean | "true" | "false") | undefined;
+    style?: import("react").CSSProperties | undefined;
+    tabIndex?: number | undefined;
+    title?: string | undefined;
+    translate?: "yes" | "no" | undefined;
+    radioGroup?: string | undefined;
+    role?: import("react").AriaRole | undefined;
+    about?: string | undefined;
+    content?: string | undefined;
+    datatype?: string | undefined;
+    inlist?: any;
+    prefix?: string | undefined;
+    property?: string | undefined;
+    rel?: string | undefined;
+    resource?: string | undefined;
+    rev?: string | undefined;
+    typeof?: string | undefined;
+    vocab?: string | undefined;
+    autoCorrect?: string | undefined;
+    autoSave?: string | undefined;
+    color?: string | undefined;
+    itemProp?: string | undefined;
+    itemScope?: boolean | undefined;
+    itemType?: string | undefined;
+    itemID?: string | undefined;
+    itemRef?: string | undefined;
+    results?: number | undefined;
+    security?: string | undefined;
+    unselectable?: "on" | "off" | undefined;
+    inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined;
+    is?: string | undefined;
+    exportparts?: string | undefined;
+    part?: string | undefined;
+    "aria-activedescendant"?: string | undefined;
+    "aria-atomic"?: (boolean | "true" | "false") | undefined;
+    "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined;
+    "aria-braillelabel"?: string | undefined;
+    "aria-brailleroledescription"?: string | undefined;
+    "aria-busy"?: (boolean | "true" | "false") | undefined;
+    "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined;
+    "aria-colcount"?: number | undefined;
+    "aria-colindex"?: number | undefined;
+    "aria-colindextext"?: string | undefined;
+    "aria-colspan"?: number | undefined;
+    "aria-controls"?: string | undefined;
+    "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined;
+    "aria-describedby"?: string | undefined;
+    "aria-description"?: string | undefined;
+    "aria-details"?: string | undefined;
+    "aria-disabled"?: (boolean | "true" | "false") | undefined;
+    "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined;
+    "aria-errormessage"?: string | undefined;
+    "aria-expanded"?: (boolean | "true" | "false") | undefined;
+    "aria-flowto"?: string | undefined;
+    "aria-grabbed"?: (boolean | "true" | "false") | undefined;
+    "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined;
+    "aria-hidden"?: (boolean | "true" | "false") | undefined;
+    "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined;
+    "aria-keyshortcuts"?: string | undefined;
+    "aria-label"?: string | undefined;
+    "aria-labelledby"?: string | undefined;
+    "aria-level"?: number | undefined;
+    "aria-live"?: "off" | "assertive" | "polite" | undefined;
+    "aria-modal"?: (boolean | "true" | "false") | undefined;
+    "aria-multiline"?: (boolean | "true" | "false") | undefined;
+    "aria-multiselectable"?: (boolean | "true" | "false") | undefined;
+    "aria-orientation"?: "horizontal" | "vertical" | undefined;
+    "aria-owns"?: string | undefined;
+    "aria-placeholder"?: string | undefined;
+    "aria-posinset"?: number | undefined;
+    "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined;
+    "aria-readonly"?: (boolean | "true" | "false") | undefined;
+    "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined;
+    "aria-required"?: (boolean | "true" | "false") | undefined;
+    "aria-roledescription"?: string | undefined;
+    "aria-rowcount"?: number | undefined;
+    "aria-rowindex"?: number | undefined;
+    "aria-rowindextext"?: string | undefined;
+    "aria-rowspan"?: number | undefined;
+    "aria-selected"?: (boolean | "true" | "false") | undefined;
+    "aria-setsize"?: number | undefined;
+    "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined;
+    "aria-valuemax"?: number | undefined;
+    "aria-valuemin"?: number | undefined;
+    "aria-valuenow"?: number | undefined;
+    "aria-valuetext"?: string | undefined;
+    dangerouslySetInnerHTML?: {
+        __html: string | TrustedHTML;
+    } | undefined;
+    onCopy?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
+    onCopyCapture?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
+    onCut?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
+    onCutCapture?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
+    onPaste?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
+    onPasteCapture?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
+    onCompositionEnd?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
+    onCompositionEndCapture?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
+    onCompositionStart?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
+    onCompositionStartCapture?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
+    onCompositionUpdate?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
+    onCompositionUpdateCapture?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
+    onFocus?: import("react").FocusEventHandler<HTMLDivElement> | undefined;
+    onFocusCapture?: import("react").FocusEventHandler<HTMLDivElement> | undefined;
+    onBlur?: import("react").FocusEventHandler<HTMLDivElement> | undefined;
+    onBlurCapture?: import("react").FocusEventHandler<HTMLDivElement> | undefined;
+    onChange?: import("react").FormEventHandler<HTMLDivElement> | undefined;
+    onChangeCapture?: import("react").FormEventHandler<HTMLDivElement> | undefined;
+    onBeforeInput?: import("react").InputEventHandler<HTMLDivElement> | undefined;
+    onBeforeInputCapture?: import("react").FormEventHandler<HTMLDivElement> | undefined;
+    onInput?: import("react").FormEventHandler<HTMLDivElement> | undefined;
+    onInputCapture?: import("react").FormEventHandler<HTMLDivElement> | undefined;
+    onReset?: import("react").FormEventHandler<HTMLDivElement> | undefined;
+    onResetCapture?: import("react").FormEventHandler<HTMLDivElement> | undefined;
+    onSubmit?: import("react").FormEventHandler<HTMLDivElement> | undefined;
+    onSubmitCapture?: import("react").FormEventHandler<HTMLDivElement> | undefined;
+    onInvalid?: import("react").FormEventHandler<HTMLDivElement> | undefined;
+    onInvalidCapture?: import("react").FormEventHandler<HTMLDivElement> | undefined;
+    onLoad?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onLoadCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onError?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onErrorCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onKeyDown?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
+    onKeyDownCapture?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
+    onKeyPress?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
+    onKeyPressCapture?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
+    onKeyUp?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
+    onKeyUpCapture?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
+    onAbort?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onAbortCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onCanPlay?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onCanPlayCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onCanPlayThrough?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onCanPlayThroughCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onDurationChange?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onDurationChangeCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onEmptied?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onEmptiedCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onEncrypted?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onEncryptedCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onEnded?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onEndedCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onLoadedData?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onLoadedDataCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onLoadedMetadata?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onLoadedMetadataCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onLoadStart?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onLoadStartCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onPause?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onPauseCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onPlay?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onPlayCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onPlaying?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onPlayingCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onProgress?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onProgressCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onRateChange?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onRateChangeCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onSeeked?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onSeekedCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onSeeking?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onSeekingCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onStalled?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onStalledCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onSuspend?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onSuspendCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onTimeUpdate?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onTimeUpdateCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onVolumeChange?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onVolumeChangeCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onWaiting?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onWaitingCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onAuxClick?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onAuxClickCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onClick?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onClickCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onContextMenu?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onContextMenuCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onDoubleClick?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onDoubleClickCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onDrag?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDragCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDragEnd?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDragEndCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDragEnter?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDragEnterCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDragExit?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDragExitCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDragLeave?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDragLeaveCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDragOver?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDragOverCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDragStart?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDragStartCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDrop?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onDropCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+    onMouseDown?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseDownCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseEnter?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseLeave?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseMove?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseMoveCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseOut?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseOutCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseOver?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseOverCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseUp?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseUpCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+    onSelect?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onSelectCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+    onTouchCancel?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+    onTouchCancelCapture?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+    onTouchEnd?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+    onTouchEndCapture?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+    onTouchMove?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+    onTouchMoveCapture?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+    onTouchStart?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+    onTouchStartCapture?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+    onPointerDown?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerDownCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerMove?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerMoveCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerUp?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerUpCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerCancel?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerCancelCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerEnter?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerLeave?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerOver?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerOverCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerOut?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerOutCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onGotPointerCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onGotPointerCaptureCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onLostPointerCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onLostPointerCaptureCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+    onScroll?: import("react").UIEventHandler<HTMLDivElement> | undefined;
+    onScrollCapture?: import("react").UIEventHandler<HTMLDivElement> | undefined;
+    onWheel?: import("react").WheelEventHandler<HTMLDivElement> | undefined;
+    onWheelCapture?: import("react").WheelEventHandler<HTMLDivElement> | undefined;
+    onAnimationStart?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
+    onAnimationStartCapture?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
+    onAnimationEnd?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
+    onAnimationEndCapture?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
+    onAnimationIteration?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
+    onAnimationIterationCapture?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
+    onTransitionEnd?: import("react").TransitionEventHandler<HTMLDivElement> | undefined;
+    onTransitionEndCapture?: import("react").TransitionEventHandler<HTMLDivElement> | undefined;
+}, HTMLElement>;

package/dist/react.js

@@ -0,0 +1,33 @@
+import { createElement, useEffect, useRef } from 'react';
+import { reins } from '@mindmakr/reins';
+/**
+ * Registers an action while the component is mounted.
+ * `run` always sees the latest props; re-registers only when `deps` change.
+ */
+export function useReinsAction(def, deps = []) {
+    const latest = useRef(def);
+    latest.current = def;
+    useEffect(() => reins.action({
+        name: def.name,
+        description: def.description,
+        input: def.input,
+        consequential: def.consequential,
+        readOnly: def.readOnly,
+        run: (input) => latest.current.run(input),
+    }), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [def.name, def.consequential, def.readOnly, ...deps]);
+}
+/** Exposes a state snapshot while the component is mounted. The getter always sees the latest render. */
+export function useReinsState(name, get) {
+    const latest = useRef(get);
+    latest.current = get;
+    useEffect(() => reins.state(name, () => latest.current()), [name]);
+}
+/** A `<div data-reins={id}>` the agent can measure, inspect and snap. Other props go to the div. */
+export function ReinsPanel({ id, children, ...rest }) {
+    useEffect(() => {
+        reins.markComponent(id);
+    });
+    return createElement('div', { ...rest, 'data-reins': id }, children);
+}

package/dist/record-stub.d.ts

@@ -0,0 +1,18 @@
+export interface RecordOptions {
+    allow?: Record<string, string[] | undefined>;
+    bufferSize?: number;
+    pill?: boolean;
+}
+export interface ExportOptions {
+    format?: 'md' | 'json' | 'both';
+    title?: string;
+}
+export declare const startRecording: (_o?: RecordOptions) => boolean;
+export declare const recordFromUrl: (_o?: RecordOptions) => boolean;
+export declare const stopRecording: () => void;
+export declare const isRecording: () => boolean;
+export declare const collectSession: (_title?: string) => null;
+export declare const exportSession: (_o?: ExportOptions) => {
+    session: null;
+    files: string[];
+};

package/dist/record-stub.js

@@ -0,0 +1,6 @@
+export const startRecording = (_o) => false;
+export const recordFromUrl = (_o) => false;
+export const stopRecording = () => { };
+export const isRecording = () => false;
+export const collectSession = (_title) => null;
+export const exportSession = (_o) => ({ session: null, files: [] });

package/dist/record.d.ts

@@ -0,0 +1,28 @@
+import { type Allow } from '@mindmakr/reins';
+import { type SessionData } from './report.js';
+export interface RecordOptions {
+    /** Keys shown as they are; everything sensitive is redacted, as in the core. */
+    allow?: Allow;
+    /** Size of the network and error buffers. Default 100. */
+    bufferSize?: number;
+    /** Show the "● Recording · Export" pill. Default true. */
+    pill?: boolean;
+}
+export interface ExportOptions {
+    format?: 'md' | 'json' | 'both';
+    title?: string;
+}
+/** Starts record mode. Returns false (and does nothing) when reins is not enabled in this build. */
+export declare function startRecording(o?: RecordOptions): boolean;
+/** Starts record mode only when the page URL has `?reins=record`. */
+export declare function recordFromUrl(o?: RecordOptions): boolean;
+/** Stops record mode and removes the pill. */
+export declare function stopRecording(): void;
+export declare const isRecording: () => boolean;
+/** Builds the session report from what record mode has collected so far. */
+export declare function collectSession(title?: string): SessionData;
+/** Downloads `reins-session-<time>.md` and/or `.json`. Returns the session and the file names. */
+export declare function exportSession(o?: ExportOptions): {
+    session: SessionData;
+    files: string[];
+};

package/dist/record.js

@@ -0,0 +1,104 @@
+// @mindmakr/reins/record: tester record mode. Browser only. Works without a bridge, but only in builds where reins
+// is enabled (dev, or a private staging build with REINS_ENABLE=1) and only after the tester opts in
+// (`?reins=record` in the URL via `recordFromUrl()`, or a button that calls `startRecording()`).
+// Production builds swap this file for `@mindmakr/reins/record-stub`; it carries the dev marker so `reins verify` catches it.
+import { devEnabled, reins, VERSION } from '@mindmakr/reins';
+import { inspect } from './dom.js';
+import { buildSession, renderMarkdown } from './report.js';
+const MARKER = '__REINS_DEV_ONLY__';
+let on = false;
+let pill = null;
+const doc = () => globalThis.document;
+function showPill() {
+    const d = doc();
+    if (!d?.body || pill)
+        return;
+    const el = d.createElement('div');
+    el.setAttribute('data-reins-record', MARKER);
+    el.setAttribute('role', 'status');
+    el.style.cssText =
+        'position:fixed;right:12px;bottom:12px;z-index:2147483647;display:flex;gap:8px;align-items:center;padding:6px 10px;border-radius:999px;background:#111;color:#fff;font:12px/1.2 system-ui,sans-serif;box-shadow:0 2px 8px rgba(0,0,0,.3)';
+    const btn = (label, title, fn) => {
+        const b = d.createElement('button');
+        b.type = 'button';
+        b.textContent = label;
+        b.title = title;
+        b.style.cssText = 'all:unset;cursor:pointer;padding:2px 6px;border-radius:6px;background:#333';
+        b.onclick = fn;
+        return b;
+    };
+    const dot = d.createElement('span');
+    dot.textContent = '● Recording';
+    dot.style.color = '#ff5c5c';
+    el.append(dot, btn('Export', 'Download this session as Markdown and JSON', () => exportSession()), btn('×', 'Stop recording', stopRecording));
+    d.body.appendChild(el);
+    pill = el;
+}
+/** Starts record mode. Returns false (and does nothing) when reins is not enabled in this build. */
+export function startRecording(o = {}) {
+    if (!devEnabled() || !reins.record({ allow: o.allow, bufferSize: o.bufferSize }))
+        return false;
+    on = true;
+    if (o.pill !== false)
+        showPill();
+    return true;
+}
+/** Starts record mode only when the page URL has `?reins=record`. */
+export function recordFromUrl(o = {}) {
+    const q = '' + (globalThis.location?.search || '');
+    return /[?&]reins=record(&|$)/.test(q) && startRecording(o);
+}
+/** Stops record mode and removes the pill. */
+export function stopRecording() {
+    on = false;
+    reins.record(false);
+    pill?.remove?.();
+    pill = null;
+}
+export const isRecording = () => on;
+/** Builds the session report from what record mode has collected so far. */
+export function collectSession(title = 'tester session') {
+    const dom = {};
+    for (const id of reins.panels())
+        dom[id] = inspect(globalThis, { panel: id, depth: 8, maxNodes: 400 });
+    let state = null;
+    try {
+        state = reins.snapshot();
+    }
+    catch { }
+    return buildSession({
+        title,
+        source: 'record',
+        reinsVersion: VERSION,
+        app: { url: state?.location, title: doc()?.title, platform: 'web' },
+        actions: reins.actions(),
+        state,
+        network: reins.network(),
+        errors: reins.errors(),
+        perf: reins.perf(),
+        dom,
+    });
+}
+function download(name, text, type) {
+    const d = doc();
+    const U = globalThis.URL;
+    const a = d.createElement('a');
+    a.href = U.createObjectURL(new Blob([text], { type }));
+    a.download = name;
+    d.body.appendChild(a);
+    a.click();
+    a.remove();
+    setTimeout(() => U.revokeObjectURL(a.href), 1000);
+}
+/** Downloads `reins-session-<time>.md` and/or `.json`. Returns the session and the file names. */
+export function exportSession(o = {}) {
+    const session = collectSession(o.title);
+    const base = 'reins-session-' + session.createdAt.replace(/[:.]/g, '-');
+    const fmt = o.format || 'both';
+    const files = [];
+    if (fmt !== 'json')
+        download(files[files.push(base + '.md') - 1], renderMarkdown(session), 'text/markdown');
+    if (fmt !== 'md')
+        download(files[files.push(base + '.json') - 1], JSON.stringify(session, null, 2), 'application/json');
+    return { session, files };
+}

package/dist/redact.d.ts

@@ -0,0 +1,7 @@
+export declare const REDACTED = "[redacted]";
+export declare const isSensitive: (k: string) => boolean;
+export declare const redactPairs: (pairs: Array<[string, string]>, allow?: string[]) => Record<string, string>;
+export declare const redactHeaders: (h: Record<string, string>, allow?: string[]) => Record<string, string>;
+export declare function redactBody(b?: string | null, keys?: string[]): unknown;
+export declare function redactDeep(value: unknown, allow?: string[], seen?: WeakSet<object>): unknown;
+export declare const redactUrl: (url: string, allow?: string[]) => string;

package/dist/redact.js

@@ -0,0 +1,30 @@
+export const REDACTED = '[redacted]';
+const SENSITIVE = /pass|secret|token|auth|cookie|session|api[-_]?key|credential|private|jwt|bearer|otp|signature|card|ssn/i;
+const mapPairs = (a, fn) => Object.fromEntries(a.map(([k, v]) => [k, fn(k, v)]));
+const mapObj = (o, fn) => mapPairs(Object.entries(o), fn);
+const has = (l, k) => l?.some((x) => x.toLowerCase() == k.toLowerCase());
+export const isSensitive = (k) => SENSITIVE.test(k);
+export const redactPairs = (pairs, allow) => mapPairs(pairs, (k, v) => (has(allow, k) ? v : REDACTED));
+export const redactHeaders = (h, allow = []) => redactPairs(Object.entries(h).map(([k, v]) => [k.toLowerCase(), v]), ['content-type', 'content-length', 'cache-control', 'etag', ...allow]);
+export function redactBody(b, keys) {
+    if (!b)
+        return;
+    try {
+        const p = (v) => (Array.isArray(v) ? v.map(p) : v && typeof v == 'object' ? mapObj(v, (k, x) => (has(keys, k) ? x : p(x))) : REDACTED);
+        return keys?.length ? p(JSON.parse(b)) : REDACTED;
+    }
+    catch {
+        return REDACTED;
+    }
+}
+export function redactDeep(value, allow, seen = new WeakSet()) {
+    const walk = (v) => typeof v == 'function'
+        ? '[function]'
+        : !v || typeof v != 'object'
+            ? v
+            : seen.has(v)
+                ? '[cycle]'
+                : (seen.add(v), Array.isArray(v) ? v.map(walk) : mapObj(v, (k, x) => (isSensitive(k) && !has(allow, k) ? REDACTED : walk(x))));
+    return walk(value);
+}
+export const redactUrl = (url, allow) => url.replace(/([?&])([^=&#]+)=[^&#]*/g, (m, sep, k) => (isSensitive(k) && !has(allow, k) ? `${sep}${k}=${REDACTED}` : m));

package/dist/report.d.ts

@@ -0,0 +1,121 @@
+import type { ActionInfo, DomIssue, DomNode, ErrEntry, NetEntry, PerfReport, RouteStat, ServerReport, ServerRequest } from './types.js';
+export declare const SCHEMA_VERSION = 1;
+/** Thresholds behind the Findings section. */
+export declare const LIMITS: {
+    apiMs: number;
+    renders: number;
+    fcpMs: number;
+    dupCalls: number;
+    dupWindowMs: number;
+    spanShare: number;
+    spanMinMs: number;
+    nPlusOne: number;
+};
+export interface DomIssueEntry {
+    panel: string;
+    tag: string;
+    id?: string;
+    text?: string;
+    issues: DomIssue[];
+}
+export interface PanelSummary {
+    id: string;
+    renders?: number;
+    mountedAtMs?: number;
+    lastRenderMs?: number;
+    nodes: number;
+    issues: number;
+}
+export interface AuditLine {
+    at?: string;
+    source?: string;
+    event?: string;
+    name?: string;
+    via?: string;
+    ok?: boolean;
+    error?: string;
+    ms?: number;
+}
+export interface SessionData {
+    schemaVersion: 1;
+    title: string;
+    createdAt: string;
+    reinsVersion: string;
+    source: 'bridge' | 'record';
+    app: {
+        url?: string;
+        title?: string;
+        platform?: string;
+        meta?: Record<string, string>;
+    };
+    actions: ActionInfo[];
+    state: Record<string, unknown> | null;
+    network: NetEntry[];
+    errors: ErrEntry[];
+    /** Always with `timeline`. */
+    perf: PerfReport | null;
+    panels: PanelSummary[];
+    domIssues: DomIssueEntry[];
+    server: ServerReport | null;
+    /** Project-relative paths of the snaps taken this session. */
+    snaps: string[];
+    audit: AuditLine[];
+}
+export interface Finding {
+    /** Stable id, used to tell new findings from resolved ones in a compare. */
+    key: string;
+    level: 'error' | 'warn';
+    text: string;
+}
+/** Per-route stats for server requests, slowest average first. */
+export declare function routeStats(requests: ServerRequest[]): RouteStat[];
+/** Merges the reports of several paired servers into one. */
+export declare function mergeServers(reports: ServerReport[]): ServerReport | null;
+/**
+ * Adds the unified timeline to a perf report: lifecycle marks, panel mounts, API calls and actions,
+ * plus the server half of each API call, joined by its `x-reins-trace` id. Calls are trimmed to timing fields.
+ */
+export declare function withTimeline(perf: PerfReport, server?: ServerRequest[] | null): PerfReport;
+/** Flattens a `reins_dom` tree: node count and the nodes that have layout issues. */
+export declare function summarizeDom(panel: string, root: DomNode | null): {
+    nodes: number;
+    issues: DomIssueEntry[];
+};
+export interface SessionParts {
+    title?: string;
+    source: 'bridge' | 'record';
+    reinsVersion: string;
+    createdAt?: string;
+    app?: SessionData['app'];
+    actions?: ActionInfo[];
+    state?: Record<string, unknown> | null;
+    network?: NetEntry[];
+    errors?: ErrEntry[];
+    perf?: PerfReport | null;
+    /** `reins_dom` tree per panel id. */
+    dom?: Record<string, DomNode | null>;
+    server?: ServerReport | null;
+    snaps?: string[];
+    audit?: AuditLine[];
+}
+/** Puts the gathered parts into one session record. */
+export declare function buildSession(p: SessionParts): SessionData;
+/** Plain-language flags computed by simple rules. See `LIMITS`. */
+export declare function findings(s: SessionData): Finding[];
+export interface RenderOptions {
+    /** Turns a project-relative snap path into a link. Default: as is. */
+    link?: (path: string) => string;
+    /** Rows kept in long tables. Default 60. */
+    maxRows?: number;
+}
+/** Renders a session as plain Markdown for models and people. */
+export declare function renderMarkdown(s: SessionData, o?: RenderOptions): string;
+/** A file-name-safe base: `2026-11-10T06-30-00-123Z-checkout-flow`. */
+export declare function sessionBase(createdAt: string, title: string): string;
+export interface CompareResult {
+    markdown: string;
+    newFindings: Finding[];
+    resolved: Finding[];
+}
+/** A Markdown diff of two sessions: metrics, API time per URL, panel renders, and findings. Lower is better for every metric. */
+export declare function compareSessions(before: SessionData, after: SessionData): CompareResult;