@orz/ui-ansi 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright 2026 the orzui team
+Copyright 2026 the todou team
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -1,3 +1,233 @@
-# Temporary Holding Version
+# @orz/ui-ansi
 
-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.
+Text with ANSI escape sequences, such as CI logs, `ls --color` or `git diff --color`, drawn in the
+active `@orz/ui` terminal colours, and plain logs, with each line coloured and filterable by its log
+level. The package contributes two renderers to `@orz/ui-content`'s registry, so an
+```` ```ansi ```` or ```` ```log ```` fence in `@orz/ui-markdown` and an `.ansi` or `.log` file in a
+viewer are drawn without importing this package from either. Its parser and level detector have no
+React and no DOM, and are usable on their own.
+
+A log is the same view with levels turned on, not a second component: a `.log` file full of escapes
+needs no routing decision, and plain text takes the parser's fast path at no extra cost.
+
+## Install
+
+```bash
+pnpm add @orz/ui-ansi @orz/ui-content @orz/ui react lucide-react
+```
+
+There are no runtime dependencies. `@orz/ui-content` is a peer dependency so that the app and every
+content package share one registry.
+
+## CSS
+
+```css
+@import "tailwindcss";
+@import "@orz/ui/styles.css";
+@import "@orz/ui-ansi/styles.css";
+```
+
+Import it after `@orz/ui/styles.css`. It holds the selection colour (`--terminal-selection`), the level and
+search-match colours, and
+like `@orz/ui`'s stylesheet it registers `@source "./dist"` on its own.
+
+## `ansiContent`
+
+```tsx
+import { ansiContent, logContent } from "@orz/ui-ansi";
+import { codeContent } from "@orz/ui-code";
+import { ContentRenderers } from "@orz/ui-content";
+
+const RENDERERS = [ansiContent, logContent, codeContent];
+
+<ContentRenderers renderers={RENDERERS}>{app}</ContentRenderers>;
+```
+
+It accepts inline sources whose `lang` is `ansi` (any case), which is what a markdown fence becomes,
+and files named `*.ansi` or typed `text/x-ansi`. `.log` files and `log` fences are `logContent`'s
+(see [Logs](#logs)). Register it before any renderer that takes every inline source, such as a code renderer, since
+the first renderer that accepts wins.
+
+- A fence draws the terminal pane, 32rem tall at most in a document.
+- A file draws the file chrome, 32rem at most in a document and the attachment pane's height in a
+  viewer. Its final newline is dropped, so it does not end on an empty numbered line. While it loads
+  the registry's fallback link shows; a file that fails to load shows the message and a Retry button.
+- A file declared or loaded over `ANSI_PREVIEW_MAX_BYTES` (64 MiB) is not drawn: it shows the
+  download link and "Too large to preview — download to view."
+
+## `AnsiView`
+
+For a surface that draws ANSI text outside the registry:
+
+```tsx
+import { AnsiView } from "@orz/ui-ansi";
+
+<AnsiView chrome="pane" text={output} />
+<AnsiView chrome="file" text={log} filename="build.log" downloadUrl={url} maxHeight="40rem" levels />
+```
+
+| Prop | |
+|---|---|
+| `text` | The text, escapes included. |
+| `chrome` | `"pane"`: the terminal pane, with Copy and Wrap on hover and on focus. `"file"`: a header with the filename, the line count, Wrap, Copy and Download, a toolbar with the level chips and the search box, and a line-number gutter. |
+| `filename` | Shown in the file header, and the region's accessible name. |
+| `downloadUrl` | The header's Download link. |
+| `boldIsBright` | Bold text in palette colours 0–7 is drawn in 8–15. Default `false`. |
+| `wrap` | The initial wrap state; the Wrap button toggles it. Default `false`. |
+| `maxHeight` | How tall the view may grow before it scrolls. Default: it grows to fit. |
+| `levels` | `true` colours each line by its detected level and, in file chrome, adds the level filter; a function replaces the detector (see [Logs](#logs)). Default `false`. |
+| `className` | On the root. |
+
+Copy writes the whole text with its escapes stripped, not only the rows on screen; while a filter
+hides lines, it writes only the shown ones. A selection copied from the view is rebuilt from the
+parsed lines, so a wrapped line copies as one line and a hidden line is never pasted.
+
+## Logs
+
+`logContent` accepts inline sources whose `lang` is `log` (any case), and files named `*.log` or
+typed `text/x-log`. A file whose name and type disagree, such as `build.log` typed `text/x-ansi`,
+goes to whichever of `logContent` and `ansiContent` is registered first. Both go before
+`codeContent`: it claims the same sources, draws them with a syntax grammar, and stops at 1 MiB.
+Files get everything `ansiContent`'s files get, including the 64 MiB cap. A fence draws the pane,
+coloured by level but with no toolbar: fences are short, mount every row, and keep the browser's
+find.
+
+With `levels`, each line's level is read from its text, escapes stripped. A function in its place
+replaces the detector for logs of a shape the rules below miss. Keep its identity across renders,
+since a new function classifies the whole text again; a detector that throws is read as "no level"
+for that line, and the first error is logged once.
+
+```tsx
+import type { LevelDetector } from "@orz/ui-ansi";
+
+// At module level, so it keeps its identity.
+const detect: LevelDetector = (text) => (text.startsWith("!!") ? { level: "error" } : null);
+
+<AnsiView chrome="file" text={log} levels={detect} />;
+```
+
+`detectLevel` tries these rules over the first 256 characters, and the first that matches wins:
+
+1. A JSON line with a `level`, `lvl`, `severity` or `loglevel` key, as a word or as a pino/bunyan
+   number (≥60 fatal, ≥50 error, ≥40 warn, ≥30 info, ≥20 debug, below that trace).
+2. logfmt: `level=`, `lvl=` or `severity=`.
+3. A syslog priority, `<n>` at the start.
+4. glog/klog: `E1023 09:14:11…`.
+5. Android logcat, in the `brief` and `threadtime` forms.
+6. `Traceback (most recent call last):`, as error.
+7. A level word, whichever form comes first: UPPERCASE anywhere, any case inside `[…]`, `<…>` or
+   `(…)`, any case before `:`, or any case as the line's first or second word.
+
+| Words (any case) | Level |
+|---|---|
+| `fatal`, `critical`, `crit`, `emerg`, `emergency`, `alert`, `panic` | fatal |
+| `error`, `err`, `severe` | error |
+| `warning`, `warn` | warn |
+| `info`, `information`, `notice` | info |
+| `debug`, `dbg`, `fine` | debug |
+| `trace`, `verbose`, `finer`, `finest` | trace |
+
+A lowercase word in the middle of a message does not count, so "disk I/O error" and "no errors
+expected" stay unlevelled, and the word must stand whole: `ERROR_CODE` and `errorCount` do not match.
+The rules are a heuristic; the fixtures in `test/parse/levels.test.ts` are their specification.
+
+A line with no level of its own takes the level of the line above when it looks like the rest of
+that entry: it is indented, starts with `Caused by:`, `Suppressed:` or `... N more`, or is an
+exception head such as `java.lang.IllegalStateException: …` or `ValueError: …`. A stack trace
+therefore stays with its error under the filter, while an unindented `Done in 3.2s.` after a warning
+does not. Any other line, a blank one included, is "Other" and ends the chain. This applies to a
+custom detector too.
+
+How a level shows, in the theme's terminal palette:
+
+- Fatal, error and warn rows get a stripe on the left and a faint tint, so they stand out while
+  scrolling; an inherited line's stripe is fainter.
+- The level word takes the level's colour: bright red (inverted for fatal), red, yellow, green for
+  info, blue for debug and grey for trace.
+- Debug and trace text is dimmed.
+- A line with ANSI colours of its own keeps them: no word colour and no dimming, but still the
+  stripe, the tint and the filter.
+
+In file chrome, a chip per level that occurs shows its line count. A click hides or shows that
+level; shift+click shows only that level, and again shows all. Hidden lines leave the view: line
+numbers keep their values, a dashed rule marks each gap, and the header reads "N of M lines".
+
+## Search
+
+The file chrome has a search box that finds text in every line, including the rows a virtualised
+view has not mounted. Ctrl+F (⌘F) while focus is inside the view goes to it instead of the browser's
+find; outside the view the browser's find is untouched. Enter and Shift+Enter, or the arrows, step
+through the matches and wrap at the ends; Escape returns to the log and keeps the highlights.
+
+- **Aa** matches case, **.\*** reads the query as a regular expression, and **≡** shows only the
+  lines with a match.
+- Search sees only the shown lines: a level the filter hides cannot be reached from the box.
+- A match never spans two lines, and it is found in the text with escapes stripped.
+- The scan runs in time slices, so typing stays responsive in a large log; the counter reads
+  "3 / 41…" until it finishes. It stops storing at 100,000 matches and reads "100,000+".
+- The slices bound the total time, not one `exec`: a pathological regular expression on one long line
+  still blocks while it runs.
+
+## `@orz/ui-ansi/parse`
+
+```ts
+import { createAnsiParser, parseAnsi, stripAnsi } from "@orz/ui-ansi/parse";
+
+const { lines, styles, maxCells } = parseAnsi(text);
+stripAnsi("\x1b[31merror\x1b[0m"); // "error"
+
+const parser = createAnsiParser();
+parser.push(chunk); // any split point: an escape cut in half is carried over
+parser.end();
+```
+
+```ts
+import { createLevelTracker, detectLevel } from "@orz/ui-ansi/parse";
+
+detectLevel("2026-10-23 09:14:03 WARN pool exhausted"); // { level: "warn", from: 20, to: 24 }
+
+const tracker = createLevelTracker(); // or createLevelTracker(detect)
+tracker.push(lines, 0, lines.length); // then push(lines, tracker.count, lines.length) as lines arrive
+tracker.levels; // one code per line, continuation lines included
+tracker.counts; // { fatal, error, warn, info, debug, trace, other }
+```
+
+Each line holds its text, its display width in cells, and its runs as `[offset, styleId]` pairs over
+one `Uint32Array`; styles are interned, so a million lines share a few dozen style objects.
+
+What is drawn:
+
+- SGR: bold, dim, italic, the underline styles (`4:1`–`4:5`, `21`), blink (kept, not animated),
+  inverse, hidden, strike and overline; foreground, background and underline colour (`58`) as the 16
+  palette colours, the 256-colour palette or 24-bit RGB, in both the `;` and `:` forms.
+- `\r`, `\b`, `\t` (stops every 8 cells), `CSI C`/`D`/`G` and `CSI 0K`/`1K`/`2K` within the line, so
+  a progress bar ends in its final state.
+- OSC 8 links whose URI is `http:`, `https:` or `mailto:` and at most 2,048 characters.
+- Wide characters take two cells and combining marks none, from `@orz/ui/lib/cell-width`.
+
+What is dropped: every other CSI (cursor up and down, scroll regions, screen erase), every other OSC,
+DCS, APC, PM and SOS up to its terminator, other C0 controls, and C1 controls. An unterminated OSC is
+dropped once it passes 4 KiB, and the text after it is parsed normally.
+
+## Theming
+
+Palette colours 0–15 are `var(--ansi-*)`, and the default foreground and background are
+`var(--terminal-foreground)` and `var(--terminal-background)`, which `@orz/themes` writes for every
+theme, including the terminal slot. A theme change needs no re-render. The 256-colour palette and
+24-bit colours are absolute, as in every terminal.
+
+## Large text
+
+Up to 1 MiB is parsed in one go; above that, the text is parsed in slices that yield to the browser,
+and the header reads "Parsing… N lines" while it runs; level counts grow with it. Up to 5,000
+visual rows of the shown lines, every row is in the DOM. Above that only the rows on screen are
+mounted, so the browser's find sees only those; in file chrome, the view's own search covers the
+rest. A virtualised view needs a bounded height: without `maxHeight` it takes 32rem.
+
+## Entry points
+
+| Import | Contents |
+|---|---|
+| `@orz/ui-ansi` | `ansiContent`, `logContent`, `ANSI_PREVIEW_MAX_BYTES`, `AnsiView`, `AnsiViewProps`, `LogLevel`, `LevelMatch`, `LevelDetector` |
+| `@orz/ui-ansi/parse` | `parseAnsi`, `stripAnsi`, `createAnsiParser`, `detectLevel`, `createLevelTracker`, `LEVELS`, `LEVEL_INHERITED`, `levelCode`, `levelOfCode`, `xterm256`, `PALETTE_NAMES`, and the types |
+| `@orz/ui-ansi/styles.css` | the selection, level and match colours |

package/dist/content.d.ts

@@ -0,0 +1,20 @@
+import { type ContentRenderer } from "@orz/ui-content";
+/**
+ * The largest file `ansiContent` or `logContent` previews. The view is virtualised, so the cap is
+ * set by the memory a parsed log takes rather than by layout, and sits far above
+ * `TEXT_PREVIEW_MAX_BYTES`.
+ */
+export declare const ANSI_PREVIEW_MAX_BYTES: number;
+/**
+ * The registry entry for terminal output: a source tagged `ansi` (a fenced block) and a `.ansi` or
+ * `text/x-ansi` file, in either placement. Register it before any renderer that takes every inline
+ * source, such as `codeContent`. A file over `ANSI_PREVIEW_MAX_BYTES` gets the download link.
+ */
+export declare const ansiContent: ContentRenderer;
+/**
+ * The registry entry for logs: a source tagged `log` and a `.log` or `text/x-log` file, drawn with
+ * level chips, the level filter and search. Register it before `codeContent`, which claims the same
+ * sources and stops at a far smaller size. Files share `ansiContent`'s cap.
+ */
+export declare const logContent: ContentRenderer;
+//# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.tsx"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,eAAe,EAGrB,MAAM,iBAAiB,CAAC;AAGzB;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAmB,CAAC;AAyIvD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,eAKzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,eAKxB,CAAC"}

package/dist/content.js

@@ -0,0 +1,90 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button } from "@orz/ui/components/button";
+import { cn } from "@orz/ui/lib/utils";
+import { ContentFallback, useSourceText, } from "@orz/ui-content";
+import { AnsiView } from "./view/ansi-view.js";
+/**
+ * The largest file `ansiContent` or `logContent` previews. The view is virtualised, so the cap is
+ * set by the memory a parsed log takes rather than by layout, and sits far above
+ * `TEXT_PREVIEW_MAX_BYTES`.
+ */
+export const ANSI_PREVIEW_MAX_BYTES = 64 * 1024 * 1024;
+const DOCUMENT_MAX_HEIGHT = "32rem";
+function isAnsi(source) {
+    if (source.kind === "inline")
+        return source.lang?.toLowerCase() === "ansi";
+    if (/\.ansi$/i.test(source.name))
+        return true;
+    const mime = source.mime?.split(";")[0]?.trim().toLowerCase();
+    return mime === "text/x-ansi";
+}
+function isLog(source) {
+    if (source.kind === "inline")
+        return source.lang?.toLowerCase() === "log";
+    if (/\.log$/i.test(source.name))
+        return true;
+    const mime = source.mime?.split(";")[0]?.trim().toLowerCase();
+    return mime === "text/x-log";
+}
+function TooLargeFile({ source, placement, className, }) {
+    return (_jsxs("div", { className: className, children: [_jsx(ContentFallback, { source: source, placement: placement }), " ", _jsx("span", { children: "Too large to preview \u2014 download to view." })] }));
+}
+function LoadedFile({ source, placement, className, levels }) {
+    const text = useSourceText(source);
+    if (text.status === "loading") {
+        return (_jsx(ContentFallback, { source: source, placement: placement, className: className }));
+    }
+    if (text.status === "error") {
+        return (_jsxs("div", { className: className, children: [_jsx(ContentFallback, { source: source, placement: placement }), " ", _jsx("span", { children: text.error.message }), " ", _jsx(Button, { size: "xs", variant: "outline", onClick: text.retry, children: "Retry" })] }));
+    }
+    // Counted in UTF-16 units, not bytes: the cap is generous, and encoding a
+    // 64 MiB string only to measure it would cost more than the check saves.
+    if (text.text.length > ANSI_PREVIEW_MAX_BYTES) {
+        return (_jsx(TooLargeFile, { source: source, placement: placement, className: className }));
+    }
+    return (_jsx(AnsiView, { chrome: "file", levels: levels, filename: source.name, downloadUrl: source.url, 
+        // The final newline would otherwise end the file on an empty numbered line.
+        text: text.text.replace(/\r?\n$/, ""), maxHeight: placement === "document" ? DOCUMENT_MAX_HEIGHT : undefined, className: cn(placement === "viewer" && "h-(--attachment-pane-height)", className) }));
+}
+function AnsiFile(props) {
+    const { source, placement, className } = props;
+    if (source.size !== undefined && source.size > ANSI_PREVIEW_MAX_BYTES) {
+        return (_jsx(TooLargeFile, { source: source, placement: placement, className: className }));
+    }
+    return _jsx(LoadedFile, { ...props });
+}
+function Source({ source, placement, className, levels, }) {
+    if (source.kind === "file") {
+        return (_jsx(AnsiFile, { source: source, placement: placement, className: className, levels: levels }));
+    }
+    return (_jsx(AnsiView, { chrome: "pane", levels: levels, text: source.text, className: className, maxHeight: placement === "document" ? DOCUMENT_MAX_HEIGHT : undefined }));
+}
+function Ansi(props) {
+    return _jsx(Source, { ...props, levels: false });
+}
+function Log(props) {
+    return _jsx(Source, { ...props, levels: true });
+}
+/**
+ * The registry entry for terminal output: a source tagged `ansi` (a fenced block) and a `.ansi` or
+ * `text/x-ansi` file, in either placement. Register it before any renderer that takes every inline
+ * source, such as `codeContent`. A file over `ANSI_PREVIEW_MAX_BYTES` gets the download link.
+ */
+export const ansiContent = {
+    name: "ansi",
+    accepts: isAnsi,
+    display: "block",
+    Component: Ansi,
+};
+/**
+ * The registry entry for logs: a source tagged `log` and a `.log` or `text/x-log` file, drawn with
+ * level chips, the level filter and search. Register it before `codeContent`, which claims the same
+ * sources and stops at a far smaller size. Files share `ansiContent`'s cap.
+ */
+export const logContent = {
+    name: "log",
+    accepts: isLog,
+    display: "block",
+    Component: Log,
+};
+//# sourceMappingURL=content.js.map

package/dist/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../src/content.tsx"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { ANSI_PREVIEW_MAX_BYTES, ansiContent, logContent, } from "./content.tsx";
+export type { LevelDetector, LevelMatch, LogLevel } from "./parse/levels.ts";
+export type { AnsiViewProps } from "./view/ansi-view.tsx";
+export { AnsiView } from "./view/ansi-view.tsx";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7E,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { ANSI_PREVIEW_MAX_BYTES, ansiContent, logContent, } from "./content.js";
+export { AnsiView } from "./view/ansi-view.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,UAAU,GACX,MAAM,cAAe,CAAC;AAGvB,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAsB,CAAC"}

package/dist/parse/index.d.ts

@@ -0,0 +1,6 @@
+export { createLevelTracker, type LevelCounts, type LevelTracker, } from "./level-tracker.ts";
+export { detectLevel, LEVEL_INHERITED, LEVELS, type LevelDetector, type LevelMatch, type LogLevel, levelCode, levelOfCode, } from "./levels.ts";
+export { PALETTE_NAMES, xterm256 } from "./palette.ts";
+export { createAnsiParser, parseAnsi, stripAnsi } from "./parser.ts";
+export type { AnsiColor, AnsiLine, AnsiParse, AnsiParser, AnsiStyle, UnderlineStyle, } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/parse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parse/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,eAAe,EACf,MAAM,EACN,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,SAAS,EACT,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACrE,YAAY,EACV,SAAS,EACT,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,EACT,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/parse/index.js

@@ -0,0 +1,5 @@
+export { createLevelTracker, } from "./level-tracker.js";
+export { detectLevel, LEVEL_INHERITED, LEVELS, levelCode, levelOfCode, } from "./levels.js";
+export { PALETTE_NAMES, xterm256 } from "./palette.js";
+export { createAnsiParser, parseAnsi, stripAnsi } from "./parser.js";
+//# sourceMappingURL=index.js.map

package/dist/parse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parse/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,eAAe,EACf,MAAM,EAIN,SAAS,EACT,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/parse/level-tracker.d.ts

@@ -0,0 +1,14 @@
+import { type LevelDetector, type LogLevel } from "./levels.ts";
+import type { AnsiLine } from "./types.ts";
+export type LevelCounts = Readonly<Record<LogLevel | "other", number>>;
+export interface LevelTracker {
+    /** Classifies `lines[from…to)`; `from` must be where the last call stopped. */
+    push(lines: readonly Pick<AnsiLine, "text">[], from: number, to: number): void;
+    /** One code per line: 0 none, 1–6 `LEVELS`, `| LEVEL_INHERITED` inherited. */
+    readonly levels: Uint8Array;
+    readonly count: number;
+    /** An inherited line counts under its level. */
+    readonly counts: LevelCounts;
+}
+export declare function createLevelTracker(detect?: LevelDetector): LevelTracker;
+//# sourceMappingURL=level-tracker.d.ts.map

package/dist/parse/level-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-tracker.d.ts","sourceRoot":"","sources":["../../src/parse/level-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EAElB,KAAK,QAAQ,EAEd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,IAAI,CACF,KAAK,EAAE,SAAS,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EACxC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,IAAI,CAAC;IACR,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAmGD,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,aAA2B,GAClC,YAAY,CAEd"}

package/dist/parse/level-tracker.js

@@ -0,0 +1,87 @@
+import { detectLevel, LEVEL_INHERITED, levelCode, } from "./levels.js";
+const CONTINUATION = /^(?:[ \t]+\S|Caused by:|Suppressed:|\.\.\. \d+ more|[\w$]+(?:\.[\w$]+)*(?:Exception|Error|Throwable)(?::|\s|$))/;
+const COUNT_KEYS = [
+    "other",
+    "fatal",
+    "error",
+    "warn",
+    "info",
+    "debug",
+    "trace",
+];
+class Tracker {
+    buffer = new Uint8Array(1024);
+    view = this.buffer.subarray(0, 0);
+    tally = new Uint32Array(COUNT_KEYS.length);
+    snapshot = countsOf(this.tally);
+    reported = false;
+    detect;
+    constructor(detect) {
+        this.detect = detect;
+    }
+    get levels() {
+        return this.view;
+    }
+    get count() {
+        return this.view.length;
+    }
+    get counts() {
+        return this.snapshot;
+    }
+    push(lines, from, to) {
+        const count = this.view.length;
+        if (from !== count) {
+            throw new RangeError(`LevelTracker: push from ${from}, but ${count} lines are classified`);
+        }
+        if (to <= from)
+            return;
+        if (to > this.buffer.length) {
+            let size = this.buffer.length * 2;
+            while (size < to)
+                size *= 2;
+            const grown = new Uint8Array(size);
+            grown.set(this.view);
+            this.buffer = grown;
+        }
+        const buffer = this.buffer;
+        let prev = count > 0 ? buffer[count - 1] : 0;
+        for (let i = from; i < to; i++) {
+            const text = lines[i].text;
+            const match = this.classify(text);
+            // levelCode gives 0 for a level a custom detector made up.
+            let code = match ? levelCode(match.level) : 0;
+            if (code === 0 && prev !== 0 && CONTINUATION.test(text)) {
+                code = prev | LEVEL_INHERITED;
+            }
+            buffer[i] = code;
+            this.tally[code & ~LEVEL_INHERITED]++;
+            prev = code;
+        }
+        this.view = buffer.subarray(0, to);
+        // A new object per push, so that a store publishing it sees a change.
+        this.snapshot = countsOf(this.tally);
+    }
+    classify(text) {
+        try {
+            return this.detect(text);
+        }
+        catch (error) {
+            if (!this.reported) {
+                this.reported = true;
+                console.error("LevelTracker: the level detector threw", error);
+            }
+            return null;
+        }
+    }
+}
+function countsOf(tally) {
+    const counts = {};
+    COUNT_KEYS.forEach((key, code) => {
+        counts[key] = tally[code];
+    });
+    return counts;
+}
+export function createLevelTracker(detect = detectLevel) {
+    return new Tracker(detect);
+}
+//# sourceMappingURL=level-tracker.js.map

package/dist/parse/level-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-tracker.js","sourceRoot":"","sources":["../../src/parse/level-tracker.ts"],"names":[],"mappings":"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"}

package/dist/parse/levels.d.ts

@@ -0,0 +1,19 @@
+export type LogLevel = "fatal" | "error" | "warn" | "info" | "debug" | "trace";
+/** `from`/`to`: UTF-16 offsets of the level word in the line's text, when there is one to colour. */
+export interface LevelMatch {
+    level: LogLevel;
+    from?: number;
+    to?: number;
+}
+export type LevelDetector = (text: string) => LevelMatch | null;
+/** In code order: a level's code is its index + 1, and 0 is no level. */
+export declare const LEVELS: readonly LogLevel[];
+/** Set on a level code that a continuation line took from the line above. */
+export declare const LEVEL_INHERITED = 128;
+export declare function levelCode(level: LogLevel): number;
+export declare function levelOfCode(code: number): LogLevel | null;
+/** How much of a line the detector reads. */
+export declare const LEVEL_WINDOW = 256;
+/** The default detector. Pure; reads at most the first 256 UTF-16 units. */
+export declare function detectLevel(text: string): LevelMatch | null;
+//# sourceMappingURL=levels.d.ts.map

package/dist/parse/levels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"levels.d.ts","sourceRoot":"","sources":["../../src/parse/levels.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/E,qGAAqG;AACrG,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,CAAC;AAEhE,yEAAyE;AACzE,eAAO,MAAM,MAAM,EAAE,SAAS,QAAQ,EAOrC,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,eAAe,MAAO,CAAC;AAEpC,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAEjD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAEzD;AAED,6CAA6C;AAC7C,eAAO,MAAM,YAAY,MAAM,CAAC;AAyHhC,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAgD3D"}