@astryxdesign/lab 0.7.1-canary.fb02ee9 → 0.7.1-canary.fc89798

package/dist/DiffViewer/diffTypes.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @file diffTypes.ts
+ * @input None (type-only module)
+ * @output Exports the structured diff model DiffViewer renders: DiffViewerFile,
+ *   DiffViewerHunk, DiffViewerLine, DiffViewerLineKind, DiffViewerFileStatus,
+ *   DiffViewerSide, DiffViewerLineRef
+ * @position Lab data model; produced by parseUnifiedDiff (or built by hand) and
+ *   consumed by DiffViewer
+ *
+ * SYNC: When modified, update:
+ * - /packages/lab/src/DiffViewer/index.ts (type exports)
+ */
+/** What one line of a hunk does: adds, removes, or keeps a line. */
+export type DiffViewerLineKind = 'added' | 'removed' | 'context';
+/** How the file changed as a whole. */
+export type DiffViewerFileStatus = 'added' | 'deleted' | 'modified' | 'renamed';
+/**
+ * Which version of the file a line number belongs to: `old` is the original
+ * (left in split view), `new` the changed version (right in split view).
+ */
+export type DiffViewerSide = 'old' | 'new';
+/** One line of a hunk, without its leading `+`/`-`/space glyph. */
+export interface DiffViewerLine {
+    kind: DiffViewerLineKind;
+    /** The line's text with the diff glyph removed. */
+    content: string;
+    /** 1-based line number in the old file; `null` for an added line. */
+    oldLineNumber: number | null;
+    /** 1-based line number in the new file; `null` for a removed line. */
+    newLineNumber: number | null;
+}
+/** One `@@` hunk: a run of changed lines with their surrounding context. */
+export interface DiffViewerHunk {
+    /** The hunk header as written, e.g. `@@ -12,7 +12,9 @@ function save()`. */
+    header: string;
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    lines: DiffViewerLine[];
+}
+/** One file's changes. */
+export interface DiffViewerFile {
+    /** Path before the change; `null` when the file was added. */
+    oldPath: string | null;
+    /** Path after the change; `null` when the file was deleted. */
+    newPath: string | null;
+    status: DiffViewerFileStatus;
+    /** True when the patch reports a binary change with no line hunks. */
+    isBinary: boolean;
+    hunks: DiffViewerHunk[];
+}
+/**
+ * Identifies one line of a rendered diff for annotations and line-number
+ * clicks. Every line has exactly one ref, the same in unified and split view,
+ * so `side` + `lineNumber` is a stable anchor (e.g. for a review comment): an
+ * added line is `new`, a removed line is `old`, and a context line is `new`.
+ */
+export interface DiffViewerLineRef {
+    side: DiffViewerSide;
+    lineNumber: number;
+    line: DiffViewerLine;
+    hunkIndex: number;
+}
+//# sourceMappingURL=diffTypes.d.ts.map

package/dist/DiffViewer/diffTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffTypes.d.ts","sourceRoot":"","sources":["../../src/DiffViewer/diffTypes.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,oEAAoE;AACpE,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjE,uCAAuC;AACvC,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,CAAC;AAE3C,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,sEAAsE;IACtE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,0BAA0B;AAC1B,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/DiffViewer/diffTypes.js

@@ -0,0 +1 @@
+export {};

package/dist/DiffViewer/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @file index.ts
+ * @input Imports from parseUnifiedDiff.ts and diffTypes.ts
+ * @output Exports the structured diff model and the unified-diff parser
+ * @position Entry point for the DiffViewer folder; re-exported by
+ *   /packages/lab/src/index.ts
+ */
+export { parseUnifiedDiff } from './parseUnifiedDiff';
+export type { DiffViewerFile, DiffViewerFileStatus, DiffViewerHunk, DiffViewerLine, DiffViewerLineKind, DiffViewerLineRef, DiffViewerSide, } from './diffTypes';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/DiffViewer/index.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AACpD,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/DiffViewer/index.js

@@ -0,0 +1,11 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file index.ts
+ * @input Imports from parseUnifiedDiff.ts and diffTypes.ts
+ * @output Exports the structured diff model and the unified-diff parser
+ * @position Entry point for the DiffViewer folder; re-exported by
+ *   /packages/lab/src/index.ts
+ */
+
+export { parseUnifiedDiff } from "./parseUnifiedDiff.js";

package/dist/DiffViewer/parseUnifiedDiff.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @file parseUnifiedDiff.ts
+ * @input A unified diff / patch string (`git diff`, `diff -u`, or a bare hunk)
+ * @output Exports parseUnifiedDiff(patch) → DiffViewerFile[]
+ * @position Lab utility; turns patch text into the structured model DiffViewer
+ *   renders
+ *
+ * Tolerant by design: unknown header lines are skipped, a hunk whose counts
+ * run short ends where its lines end, and input with no recognizable file or
+ * hunk returns an empty array. It never throws.
+ *
+ * SYNC: When modified, update:
+ * - /packages/lab/src/DiffViewer/parseUnifiedDiff.test.ts
+ */
+import type { DiffViewerFile } from './diffTypes';
+/**
+ * Parse a unified diff into one {@link DiffViewerFile} per file.
+ *
+ * Accepts `git diff` output (with `diff --git`, mode, rename, copy, and
+ * binary lines), classic `diff -u` output (`---`/`+++` pairs), several files in one
+ * patch, and a bare `@@` hunk with no file header (returned as one file with
+ * null paths). Input it cannot read yields `[]`; it never throws.
+ *
+ * @example
+ * ```
+ * const files = parseUnifiedDiff(patch);
+ * files.map((file) => <DiffViewer key={file.newPath ?? file.oldPath} file={file} />);
+ * ```
+ */
+export declare function parseUnifiedDiff(patch: string): DiffViewerFile[];
+//# sourceMappingURL=parseUnifiedDiff.d.ts.map

package/dist/DiffViewer/parseUnifiedDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseUnifiedDiff.d.ts","sourceRoot":"","sources":["../../src/DiffViewer/parseUnifiedDiff.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,aAAa,CAAC;AAkOrB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,CA8KhE"}

package/dist/DiffViewer/parseUnifiedDiff.js

@@ -0,0 +1,379 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file parseUnifiedDiff.ts
+ * @input A unified diff / patch string (`git diff`, `diff -u`, or a bare hunk)
+ * @output Exports parseUnifiedDiff(patch) → DiffViewerFile[]
+ * @position Lab utility; turns patch text into the structured model DiffViewer
+ *   renders
+ *
+ * Tolerant by design: unknown header lines are skipped, a hunk whose counts
+ * run short ends where its lines end, and input with no recognizable file or
+ * hunk returns an empty array. It never throws.
+ *
+ * SYNC: When modified, update:
+ * - /packages/lab/src/DiffViewer/parseUnifiedDiff.test.ts
+ */
+
+const HUNK_HEADER = /^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/;
+const GIT_HEADER_PREFIX = 'diff --git ';
+const BINARY_PREFIX = 'Binary files ';
+const BINARY_SUFFIX = ' differ';
+const BINARY_SEPARATOR = ' and ';
+
+/**
+ * The two paths of a `Binary files X and Y differ` line, or null when the
+ * line is not one. Plain string matching, not a regex, so any line (however
+ * long, whatever characters it holds) is read in one pass. Like the greedy
+ * pattern it replaces, the separator is the last ` and `.
+ */
+function parseBinaryLine(line) {
+  if (!line.startsWith(BINARY_PREFIX) || !line.endsWith(BINARY_SUFFIX)) {
+    return null;
+  }
+  const middle = line.slice(BINARY_PREFIX.length, line.length - BINARY_SUFFIX.length);
+  const split = middle.lastIndexOf(BINARY_SEPARATOR);
+  if (split <= 0 || split + BINARY_SEPARATOR.length >= middle.length) {
+    return null;
+  }
+  return {
+    oldPath: middle.slice(0, split),
+    newPath: middle.slice(split + BINARY_SEPARATOR.length)
+  };
+}
+const C_ESCAPES = {
+  a: 0x07,
+  b: 0x08,
+  t: 0x09,
+  n: 0x0a,
+  v: 0x0b,
+  f: 0x0c,
+  r: 0x0d,
+  '"': 0x22,
+  '\\': 0x5c
+};
+const utf8 = new TextDecoder();
+const utf8Encoder = new TextEncoder();
+
+/**
+ * Read a git C-style quoted path starting at `start` (the opening quote).
+ * Git quotes a path that holds non-ASCII bytes or special characters and
+ * writes those bytes as octal escapes (`"caf\303\251.md"`), so the escapes
+ * are collected as bytes and decoded as UTF-8. Returns the path and the index
+ * just past the closing quote, or null when the quote never closes.
+ */
+function readQuoted(text, start) {
+  const bytes = [];
+  let i = start + 1;
+  while (i < text.length) {
+    const ch = text[i];
+    if (ch === '"') {
+      return {
+        value: utf8.decode(new Uint8Array(bytes)),
+        end: i + 1
+      };
+    }
+    if (ch === '\\' && i + 1 < text.length) {
+      const next = text[i + 1];
+      const octal = /^[0-7]{3}/.exec(text.slice(i + 1, i + 4));
+      if (octal != null) {
+        bytes.push(parseInt(octal[0], 8));
+        i += 4;
+        continue;
+      }
+      if (next in C_ESCAPES) {
+        bytes.push(C_ESCAPES[next]);
+        i += 2;
+        continue;
+      }
+    }
+    // Any other character stands for itself (as UTF-8 bytes).
+    const codePoint = text.codePointAt(i) ?? 0;
+    const char = String.fromCodePoint(codePoint);
+    bytes.push(...utf8Encoder.encode(char));
+    i += char.length;
+  }
+  return null;
+}
+
+/** The path written in `raw`, unquoted and decoded when git quoted it. */
+function unquotePath(raw) {
+  if (raw.startsWith('"')) {
+    const quoted = readQuoted(raw, 0);
+    if (quoted != null) {
+      return quoted.value;
+    }
+  }
+  return raw;
+}
+function stripPrefix(path, prefix) {
+  return path.startsWith(prefix) ? path.slice(prefix.length) : path;
+}
+
+/**
+ * The two paths of a `diff --git` line. Git quotes a path that holds special
+ * or non-ASCII characters; quoted paths are read whole and decoded. An
+ * unquoted path may hold spaces, so a space can look like the separator: when
+ * both sides name the same path (every change except a rename) the separator
+ * is the middle space. A rename writes `rename from` / `rename to` lines,
+ * which replace these paths, so the first-space split is only a fallback.
+ */
+function parseGitHeader(line) {
+  if (!line.startsWith(GIT_HEADER_PREFIX)) {
+    return null;
+  }
+  const rest = line.slice(GIT_HEADER_PREFIX.length);
+  const paths = (left, right) => ({
+    oldPath: stripPrefix(left, 'a/'),
+    newPath: stripPrefix(right, 'b/')
+  });
+  if (rest.startsWith('"')) {
+    const left = readQuoted(rest, 0);
+    if (left != null && rest[left.end] === ' ') {
+      return paths(left.value, unquotePath(rest.slice(left.end + 1)));
+    }
+  }
+  if (rest.endsWith('"')) {
+    // Only the new side is quoted: it starts at the last ` "` that reads to
+    // the end of the line as one quoted path.
+    for (let split = rest.lastIndexOf(' "'); split > 0; split = rest.lastIndexOf(' "', split - 1)) {
+      const right = readQuoted(rest, split + 1);
+      if (right != null && right.end === rest.length) {
+        return paths(rest.slice(0, split), right.value);
+      }
+    }
+  }
+  if (rest.length % 2 === 1) {
+    const middle = (rest.length - 1) / 2;
+    const left = rest.slice(0, middle);
+    const right = rest.slice(middle + 1);
+    if (rest[middle] === ' ' && stripPrefix(left, 'a/') === stripPrefix(right, 'b/')) {
+      return paths(left, right);
+    }
+  }
+  const space = rest.indexOf(' ');
+  return space <= 0 ? null : paths(rest.slice(0, space), rest.slice(space + 1));
+}
+function emptyFile() {
+  return {
+    oldPath: null,
+    newPath: null,
+    status: null,
+    isBinary: false,
+    hunks: []
+  };
+}
+
+/**
+ * `a/src/x.ts` → `src/x.ts`; `/dev/null` → null; drops a trailing
+ * tab+timestamp and decodes a quoted path.
+ */
+function cleanPath(raw, prefix) {
+  let path = unquotePath(raw.split('\t')[0].trim());
+  if (path === '/dev/null') {
+    return null;
+  }
+  if (path.startsWith(prefix)) {
+    path = path.slice(prefix.length);
+  }
+  return path;
+}
+function finalize(file) {
+  let status = file.status;
+  if (status == null) {
+    if (file.oldPath == null && file.newPath != null) {
+      status = 'added';
+    } else if (file.newPath == null && file.oldPath != null) {
+      status = 'deleted';
+    } else {
+      // Only git's rename lines say a file moved. Two different paths
+      // without them (`diff -u a.orig a`, `diff -ruN old new`, a copy) are an
+      // edit between two files, so both paths are kept.
+      status = 'modified';
+    }
+  }
+  return {
+    oldPath: status === 'added' ? null : file.oldPath,
+    newPath: status === 'deleted' ? null : file.newPath,
+    status,
+    isBinary: file.isBinary,
+    hunks: file.hunks
+  };
+}
+function hasContent(file) {
+  return file.hunks.length > 0 || file.isBinary || file.oldPath != null || file.newPath != null || file.status != null;
+}
+
+/**
+ * Parse a unified diff into one {@link DiffViewerFile} per file.
+ *
+ * Accepts `git diff` output (with `diff --git`, mode, rename, copy, and
+ * binary lines), classic `diff -u` output (`---`/`+++` pairs), several files in one
+ * patch, and a bare `@@` hunk with no file header (returned as one file with
+ * null paths). Input it cannot read yields `[]`; it never throws.
+ *
+ * @example
+ * ```
+ * const files = parseUnifiedDiff(patch);
+ * files.map((file) => <DiffViewer key={file.newPath ?? file.oldPath} file={file} />);
+ * ```
+ */
+export function parseUnifiedDiff(patch) {
+  const lines = patch.split('\n').map(line => line.replace(/\r$/, ''));
+  const files = [];
+  let file = null;
+  let hunk = null;
+  let oldRemaining = 0;
+  let newRemaining = 0;
+  let oldLine = 0;
+  let newLine = 0;
+  const flush = () => {
+    if (file != null && hasContent(file)) {
+      files.push(finalize(file));
+    }
+    file = null;
+    hunk = null;
+  };
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+
+    // Inside a hunk: consume body lines until both counts are spent.
+    if (hunk != null && (oldRemaining > 0 || newRemaining > 0)) {
+      const glyph = line[0];
+      if (glyph === '\\') {
+        // "" — annotates the previous line.
+        continue;
+      }
+      if (glyph === '+') {
+        hunk.lines.push({
+          kind: 'added',
+          content: line.slice(1),
+          oldLineNumber: null,
+          newLineNumber: newLine++
+        });
+        newRemaining--;
+        continue;
+      }
+      if (glyph === '-') {
+        hunk.lines.push({
+          kind: 'removed',
+          content: line.slice(1),
+          oldLineNumber: oldLine++,
+          newLineNumber: null
+        });
+        oldRemaining--;
+        continue;
+      }
+      if (glyph === ' ' || line === '') {
+        // Some tools strip the trailing space of an empty context line.
+        if (line === '' && i === lines.length - 1) {
+          continue;
+        }
+        hunk.lines.push({
+          kind: 'context',
+          content: line.slice(1),
+          oldLineNumber: oldLine++,
+          newLineNumber: newLine++
+        });
+        oldRemaining--;
+        newRemaining--;
+        continue;
+      }
+      // Anything else ends a short hunk; fall through and read it as a header.
+      hunk = null;
+    }
+    if (hunk != null && line.startsWith('\\')) {
+      continue;
+    }
+    const gitPaths = parseGitHeader(line);
+    if (gitPaths != null) {
+      flush();
+      file = emptyFile();
+      file.oldPath = gitPaths.oldPath;
+      file.newPath = gitPaths.newPath;
+      continue;
+    }
+    if (line.startsWith('--- ') && (lines[i + 1]?.startsWith('+++ ') ?? false)) {
+      // A `---`/`+++` pair opens a new file unless it belongs to a
+      // `diff --git` header whose hunks have not started yet. A binary entry
+      // never takes a pair: in `diff -r` output it was a file of its own.
+      if (file == null || file.hunks.length > 0 || file.isBinary) {
+        flush();
+        file = emptyFile();
+      }
+      const current = file;
+      current.oldPath = cleanPath(line.slice(4), 'a/');
+      current.newPath = cleanPath(lines[i + 1].slice(4), 'b/');
+      if (current.oldPath == null && current.status == null) {
+        current.status = 'added';
+      } else if (current.newPath == null && current.status == null) {
+        current.status = 'deleted';
+      }
+      i++;
+      continue;
+    }
+    const header = HUNK_HEADER.exec(line);
+    if (header) {
+      file ??= emptyFile();
+      const oldStart = Number(header[1]);
+      const oldLines = header[2] == null ? 1 : Number(header[2]);
+      const newStart = Number(header[3]);
+      const newLines = header[4] == null ? 1 : Number(header[4]);
+      const next = {
+        header: line,
+        oldStart,
+        oldLines,
+        newStart,
+        newLines,
+        lines: []
+      };
+      file.hunks.push(next);
+      hunk = next;
+      oldRemaining = oldLines;
+      newRemaining = newLines;
+      // A zero-length side's start names the line *before* the hunk.
+      oldLine = oldLines === 0 ? oldStart + 1 : oldStart;
+      newLine = newLines === 0 ? newStart + 1 : newStart;
+      continue;
+    }
+
+    // GNU `diff -r` reports a binary file with this one line and no header,
+    // so unless it belongs to a `diff --git` header still being read (no
+    // hunks yet, not already binary), it is a file of its own.
+    const binary = parseBinaryLine(line);
+    if (binary != null && (file == null || file.hunks.length > 0 || file.isBinary)) {
+      flush();
+      const own = emptyFile();
+      own.oldPath = cleanPath(binary.oldPath, 'a/');
+      own.newPath = cleanPath(binary.newPath, 'b/');
+      own.isBinary = true;
+      file = own;
+      continue;
+    }
+    if (file == null) {
+      continue;
+    }
+    const current = file;
+    if (line.startsWith('new file mode')) {
+      current.status = 'added';
+    } else if (line.startsWith('deleted file mode')) {
+      current.status = 'deleted';
+    } else if (line.startsWith('rename from ')) {
+      current.oldPath = unquotePath(line.slice('rename from '.length));
+      current.status = 'renamed';
+    } else if (line.startsWith('rename to ')) {
+      current.newPath = unquotePath(line.slice('rename to '.length));
+      current.status = 'renamed';
+    } else if (line.startsWith('copy from ')) {
+      // A copy keeps its source, so it reads as an edit from the source path
+      // to the new one; these lines also fix paths the header split wrongly.
+      current.oldPath = unquotePath(line.slice('copy from '.length));
+    } else if (line.startsWith('copy to ')) {
+      current.newPath = unquotePath(line.slice('copy to '.length));
+    } else if (line.startsWith('Binary files ') || line === 'GIT binary patch') {
+      current.isBinary = true;
+    }
+  }
+  flush();
+  return files;
+}

package/dist/index.d.ts

@@ -28,5 +28,6 @@ export { SankeyChart, type SankeyChartProps, SankeyLink, type SankeyLinkProps, S
 export * from './CircularProgress';
 export * from './ListInput';
 export { LogStream, type LogStreamProps, type LogEntry, type LogStreamLevel, } from './LogStream';
+export { parseUnifiedDiff, type DiffViewerFile, type DiffViewerFileStatus, type DiffViewerHunk, type DiffViewerLine, type DiffViewerLineKind, type DiffViewerLineRef, type DiffViewerSide, } from './DiffViewer';
 export { MobileTokenizer, type MobileTokenizerProps, type MobileTokenizerChange, } from './MobileTokenizer';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH,OAAO,EAAC,UAAU,EAAE,KAAK,eAAe,EAAC,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,QAAQ,EACR,aAAa,EACb,uBAAuB,EACvB,KAAK,WAAW,GACjB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAC,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAC,MAAM,WAAW,CAAC;AAGvE,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kCAAkC,EACvC,KAAK,yBAAyB,GAC/B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,GACxB,MAAM,+BAA+B,CAAC;AACvC,cAAc,QAAQ,CAAC;AAGvB,OAAO,EACL,MAAM,EACN,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,IAAI,EACJ,KAAK,SAAS,EACd,QAAQ,EACR,KAAK,aAAa,EAClB,OAAO,EACP,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACL,IAAI,EACJ,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,QAAQ,GACd,MAAM,QAAQ,CAAC;AAGhB,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,QAAQ,EACR,UAAU,EACV,WAAW,EACX,KAAK,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,OAAO,EACP,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,YAAY,GACb,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,KAAK,EACL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,SAAS,EACT,KAAK,cAAc,EACnB,SAAS,EACT,KAAK,cAAc,EACnB,QAAQ,EACR,KAAK,aAAa,EAClB,SAAS,EACT,KAAK,cAAc,EACnB,SAAS,EACT,KAAK,cAAc,EACnB,aAAa,EACb,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,QAAQ,EACR,KAAK,aAAa,EAClB,UAAU,EACV,KAAK,eAAe,EACpB,qBAAqB,EACrB,KAAK,0BAA0B,EAC/B,cAAc,EACd,KAAK,mBAAmB,EACxB,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,QAAQ,EACR,KAAK,OAAO,EACZ,cAAc,EACd,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,cAAc,EACd,0BAA0B,EAC1B,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,aAAa,EACb,QAAQ,EACR,OAAO,EACP,SAAS,EACT,SAAS,GACV,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,UAAU,EACV,KAAK,eAAe,EACpB,UAAU,EACV,KAAK,eAAe,EACpB,UAAU,EACV,KAAK,eAAe,EACpB,WAAW,EACX,KAAK,gBAAgB,EACrB,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,aAAa,EACb,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,SAAS,EACT,KAAK,cAAc,EACnB,UAAU,EACV,KAAK,eAAe,EACpB,UAAU,EACV,KAAK,eAAe,EACpB,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,EACL,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,OAAO,EACZ,KAAK,cAAc,GACpB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,SAAS,EACT,KAAK,cAAc,EACnB,WAAW,EACX,KAAK,gBAAgB,EACrB,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,UAAU,EACV,KAAK,eAAe,EACpB,UAAU,EACV,KAAK,eAAe,EACpB,WAAW,EACX,KAAK,gBAAgB,EACrB,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,UAAU,CAAC;AAIlB,cAAc,oBAAoB,CAAC;AAGnC,cAAc,aAAa,CAAC;AAG5B,OAAO,EACL,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AAKrB,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -66,12 +66,14 @@ export * from "./ListInput/index.js";
 // LogStream — experimental streaming log viewer
 export { LogStream } from "./LogStream/index.js";
 
+// DiffViewer — the structured diff model and the unified-diff parser
+export { parseUnifiedDiff } from "./DiffViewer/index.js";
+
 // MobileTokenizer — Lab prototype (stack layer 1) of the touch Tokenizer
 // flow: summary trigger + stacked manage/add BottomSheets. Graduates to
 // Core Tokenizer presentation="bottom-sheet" (stack layer 2).
 export { MobileTokenizer } from "./MobileTokenizer/index.js";
 
-// RichTextEditor (RFC facebook/astryx#3899) has graduated out of @astryxdesign/lab
-// into its own canary-only package, @astryxdesign/richtext, so it can be canaried
-// independently by an adopting application. Import it from there:
+// RichTextEditor (RFC facebook/astryx#3899) moved out of @astryxdesign/lab into
+// its own package, @astryxdesign/richtext. Import it from there:
 //   import {RichTextEditor, RichTextView} from '@astryxdesign/richtext';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astryxdesign/lab",
-  "version": "0.7.1-canary.fb02ee9",
+  "version": "0.7.1-canary.fc89798",
   "description": "Experimental Astryx components — published to npm only under the @canary dist-tag for early testing; never released as a stable (latest) version.",
   "author": "Meta Open Source",
   "license": "MIT",
@@ -47,7 +47,7 @@
   },
   "peerDependencies": {
     "@stylexjs/stylex": ">=0.10.0",
-    "@astryxdesign/core": "0.7.1-canary.fb02ee9",
+    "@astryxdesign/core": "0.7.1-canary.fc89798",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0"
   },
@@ -57,8 +57,8 @@
     "d3-shape": "^3.2.0"
   },
   "devDependencies": {
-    "@astryxdesign/a11y-spec": "0.7.1-canary.fb02ee9",
-    "@astryxdesign/cli": "0.7.1-canary.fb02ee9",
+    "@astryxdesign/a11y-spec": "0.7.1-canary.fc89798",
+    "@astryxdesign/cli": "0.7.1-canary.fc89798",
     "@babel/cli": "^7.29.7",
     "@babel/core": "^7.29.7",
     "@babel/preset-react": "^7.29.7",

package/src/DiffViewer/diffTypes.ts

@@ -0,0 +1,73 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file diffTypes.ts
+ * @input None (type-only module)
+ * @output Exports the structured diff model DiffViewer renders: DiffViewerFile,
+ *   DiffViewerHunk, DiffViewerLine, DiffViewerLineKind, DiffViewerFileStatus,
+ *   DiffViewerSide, DiffViewerLineRef
+ * @position Lab data model; produced by parseUnifiedDiff (or built by hand) and
+ *   consumed by DiffViewer
+ *
+ * SYNC: When modified, update:
+ * - /packages/lab/src/DiffViewer/index.ts (type exports)
+ */
+
+/** What one line of a hunk does: adds, removes, or keeps a line. */
+export type DiffViewerLineKind = 'added' | 'removed' | 'context';
+
+/** How the file changed as a whole. */
+export type DiffViewerFileStatus = 'added' | 'deleted' | 'modified' | 'renamed';
+
+/**
+ * Which version of the file a line number belongs to: `old` is the original
+ * (left in split view), `new` the changed version (right in split view).
+ */
+export type DiffViewerSide = 'old' | 'new';
+
+/** One line of a hunk, without its leading `+`/`-`/space glyph. */
+export interface DiffViewerLine {
+  kind: DiffViewerLineKind;
+  /** The line's text with the diff glyph removed. */
+  content: string;
+  /** 1-based line number in the old file; `null` for an added line. */
+  oldLineNumber: number | null;
+  /** 1-based line number in the new file; `null` for a removed line. */
+  newLineNumber: number | null;
+}
+
+/** One `@@` hunk: a run of changed lines with their surrounding context. */
+export interface DiffViewerHunk {
+  /** The hunk header as written, e.g. `@@ -12,7 +12,9 @@ function save()`. */
+  header: string;
+  oldStart: number;
+  oldLines: number;
+  newStart: number;
+  newLines: number;
+  lines: DiffViewerLine[];
+}
+
+/** One file's changes. */
+export interface DiffViewerFile {
+  /** Path before the change; `null` when the file was added. */
+  oldPath: string | null;
+  /** Path after the change; `null` when the file was deleted. */
+  newPath: string | null;
+  status: DiffViewerFileStatus;
+  /** True when the patch reports a binary change with no line hunks. */
+  isBinary: boolean;
+  hunks: DiffViewerHunk[];
+}
+
+/**
+ * Identifies one line of a rendered diff for annotations and line-number
+ * clicks. Every line has exactly one ref, the same in unified and split view,
+ * so `side` + `lineNumber` is a stable anchor (e.g. for a review comment): an
+ * added line is `new`, a removed line is `old`, and a context line is `new`.
+ */
+export interface DiffViewerLineRef {
+  side: DiffViewerSide;
+  lineNumber: number;
+  line: DiffViewerLine;
+  hunkIndex: number;
+}