@tangle-network/sandbox-ui 0.113.7 → 0.115.0

package/dist/index-CXX5IpH2.d.ts

@@ -0,0 +1,2 @@
+import { CSV_PREVIEW_ROW_LIMIT, FileArtifactPane as FileArtifactPane$1, FileArtifactPaneProps, FileFormat, FileNode as FileNode$1, FilePreview, FilePreviewKind, FilePreviewProps, FileTabData as FileTabData$1, FileTabs, FileTabsProps, FileTree as FileTree$1, FileTreeProps, FileTreeVisibilityOptions as FileTreeVisibilityOptions$1, RichFileTree, RichFileTreeGitEntry, RichFileTreeGitStatus, RichFileTreeProps, RichFileTreeThemeVars, detectFileFormat, fileExtension, filterFileTree as filterFileTree$1, getCodeLanguage, getFormatLabel, getSyntaxLanguage, parseCsv, resolveFilePreviewKind } from "@tangle-network/ui/files";
+export { getCodeLanguage as C, resolveFilePreviewKind as D, parseCsv as E, filterFileTree$1 as S, getSyntaxLanguage as T, RichFileTreeGitStatus as _, FileNode$1 as a, detectFileFormat as b, FilePreviewProps as c, FileTabsProps as d, FileTree$1 as f, RichFileTreeGitEntry as g, RichFileTree as h, FileFormat as i, FileTabData$1 as l, FileTreeVisibilityOptions$1 as m, FileArtifactPane$1 as n, FilePreview as o, FileTreeProps as p, FileArtifactPaneProps as r, FilePreviewKind as s, CSV_PREVIEW_ROW_LIMIT as t, FileTabs as u, RichFileTreeProps as v, getFormatLabel as w, fileExtension as x, RichFileTreeThemeVars as y };

package/dist/index-CesPlOyx.d.ts

@@ -0,0 +1,367 @@
+import { v as ExposedPort } from "./index-DPePq7c8.js";
+import { _ as RichFileTreeGitStatus, g as RichFileTreeGitEntry } from "./index-CXX5IpH2.js";
+import * as React$1 from "react";
+import { CSSProperties } from "react";
+//#region src/workbench/types.d.ts
+/** Which surface the artifact pane is currently showing. */
+type ArtifactView = "code" | "diff" | "preview" | "ports" | "terminal";
+/**
+ * A single artifact rendered by the pane. `content` is the working copy;
+ * when `baselineContent` differs from it, the Diff view becomes available
+ * and renders a word-level unified diff of baseline → content.
+ */
+interface SandboxArtifact {
+  id: string;
+  /** Canonical path inside the sandbox, e.g. `src/lib/retry.ts`. */
+  path: string;
+  /** Display name for the active file (usually the last path segment). */
+  filename: string;
+  /** Working-copy contents of the file. */
+  content: string;
+  /** Prior contents the working copy is diffed against. */
+  baselineContent?: string;
+  /** Explicit syntax language id (overrides extension inference). */
+  language?: string;
+  mimeType?: string;
+}
+/**
+ * Live PTY terminal binding. Maps straight onto `TerminalView` — both
+ * `apiUrl` and `token` are required to open a session against the sidecar.
+ */
+interface SandboxArtifactTerminal {
+  apiUrl: string;
+  token: string;
+  /** Stable id so the same PTY is restored across remounts. */
+  connectionId?: string;
+  title?: string;
+  subtitle?: string;
+}
+interface SandboxArtifactPaneProps {
+  /** The active artifact shown in the Code / Diff surfaces. */
+  artifact: SandboxArtifact;
+  /**
+   * Flat list of canonical paths for the file-tree rail in the Code view.
+   * Defaults to `[artifact.path]` when omitted (single-file tree).
+   */
+  paths?: ReadonlyArray<string>;
+  /** Per-path git-status decorations for the file tree. */
+  gitStatus?: ReadonlyArray<RichFileTreeGitEntry>;
+  /** Show the Code view's file-tree rail. Off for single-file embeds where the host owns navigation/tabs. */
+  showTree?: boolean;
+  /** Exposed ports; presence enables the Ports tab. */
+  ports?: ExposedPort[];
+  /** Live preview origin; presence enables the Preview tab. */
+  previewUrl?: string;
+  /** Live terminal binding; presence enables the Terminal tab. */
+  terminal?: SandboxArtifactTerminal;
+  /** Controlled active view. Pair with `onViewChange`. */
+  activeView?: ArtifactView;
+  /** Initial view when uncontrolled. Defaults to the first available view. */
+  defaultView?: ArtifactView;
+  onViewChange?: (view: ArtifactView) => void;
+  /** Fired when a different file is chosen in the tree (host swaps artifact). */
+  onFileSelect?: (path: string) => void;
+  /** Forwarded to the Ports view. */
+  onExposePort?: (port: number) => void;
+  onRemovePort?: (port: number) => void;
+  className?: string;
+  style?: CSSProperties;
+}
+/**
+ * One entry of the sandbox's git working tree, as the Changes pane lists it.
+ * `additions` / `deletions` are the numstat counts the sidecar's
+ * `GET /git/diff` reports per file.
+ *
+ * `baseline` / `current` are the file contents the diff is drawn from and are
+ * absent until the consumer resolves them for the selected file. Which of the
+ * two counts as "resolved" follows the status: an added or untracked file has
+ * no baseline and diffs against the empty string once `current` is present; a
+ * deleted file has no working copy and diffs against the empty string once
+ * `baseline` is present; every other status waits for both.
+ */
+interface ChangedFile {
+  path: string;
+  status: RichFileTreeGitStatus;
+  additions: number;
+  deletions: number;
+  /** Present once the consumer has resolved contents for the selected file. */
+  baseline?: string;
+  current?: string;
+  /**
+   * Why the sides could not be resolved. Shown under the file's header in
+   * place of the loading line, so a failed read never looks like a slow one.
+   */
+  loadError?: string;
+}
+interface ChangesPaneProps {
+  /** Current branch; `null` when the tree has no commits yet or is not a repository. */
+  branch: string | null;
+  ahead?: number;
+  behind?: number;
+  files: ChangedFile[];
+  selectedPath?: string;
+  onSelectFile?: (path: string) => void;
+  loading?: boolean;
+  error?: string | null;
+  onRefresh?: () => void;
+  /** Stage everything and commit. Resolve on success; reject with an Error the pane shows inline. */
+  onCommit?: (message: string) => Promise<void>;
+  onPush?: () => Promise<void>;
+  /** Which action is in flight; the pane disables the other and shows a spinner on this one. */
+  busy?: "commit" | "push" | null;
+  /** Open the file as a workbench artifact (the product wires this to its artifact opener). */
+  onOpenFile?: (path: string) => void;
+  className?: string;
+}
+//#endregion
+//#region src/workbench/sandbox-artifact-pane.d.ts
+/**
+ * Blueprint-grade artifact workbench. Composes the sandbox-ui substrate
+ * (`RichFileTree`, `PortsList`, `TerminalView`, `@pierre/diffs`) behind a
+ * single pill-tab view switcher: Code · Diff · Preview · Ports · Terminal.
+ * Tabs appear only when their data is present (Diff requires a differing
+ * baseline; Preview a url; Ports a port list; Terminal a live binding), so the
+ * chrome never shows a dead surface.
+ */
+declare function SandboxArtifactPane({ artifact, paths, gitStatus, showTree, ports, previewUrl, terminal, activeView, defaultView, onViewChange, onFileSelect, onExposePort, onRemovePort, className, style }: SandboxArtifactPaneProps): React$1.JSX.Element;
+//#endregion
+//#region src/workbench/changes-pane.d.ts
+/**
+ * The sandbox's git working tree as a review surface: every changed file with
+ * its line counts, the selected file's word-level diff beneath, and a commit
+ * box in the footer. Data in, callbacks out — the pane never fetches; the
+ * consumer feeds it the sidecar's `/git/status` + `/git/diff` and resolves
+ * `baseline` / `current` for the file it is told was selected.
+ *
+ * The list is capped at 40% of the pane and scrolls, so the diff keeps its
+ * room however many files changed. The row's own chrome is compact: the
+ * workspace shell already gives its right pane the 56px `WorkspacePaneHeader`,
+ * so this header nests beneath it at `PanelHeader` rhythm rather than adding a
+ * second tall bar.
+ */
+declare function ChangesPane({ branch, ahead, behind, files, selectedPath, onSelectFile, loading, error, onRefresh, onCommit, onPush, busy, onOpenFile, className }: ChangesPaneProps): React$1.JSX.Element;
+//#endregion
+//#region src/workbench/pill-tabs.d.ts
+interface PillTabItem<T extends string> {
+  value: T;
+  label: string;
+  icon?: React$1.ReactNode;
+}
+interface PillTabsProps<T extends string> {
+  items: ReadonlyArray<PillTabItem<T>>;
+  value: T;
+  onChange: (value: T) => void;
+  className?: string;
+  "aria-label"?: string;
+  /** Stable IDs supplied by the parent when it renders the associated panel. */
+  idPrefix?: string;
+  panelId?: string;
+}
+/**
+ * Sliding-pill segmented control. Reimplemented from blueprint-agent's
+ * framer-motion `PillTabs` with a measured CSS transform instead — no motion
+ * dependency. A `ResizeObserver` re-measures on container resize and font
+ * load so the indicator tracks the active tab exactly. Token-swapped onto the
+ * sandbox-ui surface ladder.
+ */
+declare function PillTabs<T extends string>({ items, value, onChange, className, "aria-label": ariaLabel, idPrefix, panelId }: PillTabsProps<T>): React$1.JSX.Element;
+//#endregion
+//#region src/workbench/diff-utils.d.ts
+interface DiffStats {
+  added: number;
+  removed: number;
+}
+/**
+ * Count added / removed lines between two file revisions.
+ *
+ * Ported from blueprint-agent's `computeDiffStats`: normalize CRLF, short-
+ * circuit on equality, then `diffLines` with `ignoreWhitespace` so pure
+ * reindentation does not inflate the counts. `newlineIsToken:false` keeps a
+ * line (not its trailing newline) as the unit, matching the +/- a reader
+ * counts by eye.
+ */
+declare function computeDiffStats(original: string, current: string): DiffStats;
+/**
+ * Build a single-file unified patch (baseline → current) for `@pierre/diffs`'
+ * `PatchDiff`. `context: Infinity` would print the whole file; the default
+ * 4-line context keeps hunks compact while preserving locality. Equal inputs
+ * yield an empty string so callers can treat "" as "no diff".
+ */
+declare function buildUnifiedPatch(filename: string, baseline: string, current: string): string;
+//#endregion
+//#region src/workbench/panel-header.d.ts
+declare function GitStatusBadge({ status }: {
+  status: RichFileTreeGitStatus;
+}): React$1.JSX.Element;
+/** `+added −removed` line counts in mono; the same pair the Changes list prints per file. */
+declare function DiffStatsBadge({ stats, className }: {
+  stats: DiffStats;
+  className?: string;
+}): React$1.JSX.Element;
+interface PanelHeaderProps {
+  filename: string;
+  gitStatus?: RichFileTreeGitStatus;
+  /** Added/removed line counts; rendered only when provided (Diff view). */
+  stats?: DiffStats;
+  /** Enables the copy-to-clipboard action when set. */
+  copyText?: string;
+  /** Extra content rendered at the right edge, before the copy button. */
+  children?: React$1.ReactNode;
+  className?: string;
+}
+/**
+ * Thin bordered chrome bar above the artifact body — filename, git-status
+ * badge, optional diff counts, and a copy action. Ported in spirit from
+ * blueprint-agent's `PanelHeader` (min-h, hairline bottom border, dense
+ * horizontal rhythm), retoned to the sandbox-ui surface ladder.
+ */
+declare function PanelHeader({ filename, gitStatus, stats, copyText, children, className }: PanelHeaderProps): React$1.JSX.Element;
+//#endregion
+//#region src/workbench/file-breadcrumb.d.ts
+interface FileBreadcrumbProps {
+  /** Canonical path, e.g. `src/lib/retry.ts`. */
+  path: string;
+  className?: string;
+}
+/**
+ * Slim path breadcrumb for the code panel. Reimplemented (not ported) from
+ * blueprint-agent's `FileBreadcrumb` — that one nests a `FileTree` dropdown per
+ * segment and couples to the workbench store + framer-motion. Here the rail
+ * already owns navigation, so this is a read-only trail: caret-separated parent
+ * segments with a file-icon leaf.
+ */
+declare function FileBreadcrumb({ path, className }: FileBreadcrumbProps): React$1.JSX.Element;
+//#endregion
+//#region src/workbench/code-view.d.ts
+interface CodeViewProps {
+  path: string;
+  filename: string;
+  content: string;
+  language?: string;
+  /** Flat list of paths for the rail; defaults to `[path]`. */
+  paths?: ReadonlyArray<string>;
+  gitStatus?: ReadonlyArray<RichFileTreeGitEntry>;
+  onFileSelect?: (path: string) => void;
+  /** Show the file-tree rail. Off for single-file embeds where the host owns navigation. */
+  showTree?: boolean;
+  className?: string;
+}
+/**
+ * Code surface: a fixed-width `RichFileTree` rail (with git-status
+ * decorations) beside a breadcrumb-topped, syntax-highlighted read-only file
+ * view. The rail owns navigation; selecting a path fans out to `onFileSelect`
+ * so the host can swap the active artifact.
+ */
+declare function CodeView({ path, filename, content, language, paths, gitStatus, onFileSelect, showTree, className }: CodeViewProps): React$1.JSX.Element;
+//#endregion
+//#region src/workbench/diff-view.d.ts
+interface DiffViewProps {
+  filename: string;
+  baseline: string;
+  current: string;
+  /** Hide when the surrounding PanelHeader already identifies the file. */
+  showFileHeader?: boolean;
+  /** Start wrapped so narrow review panes never conceal the end of a line. */
+  defaultWrap?: boolean;
+  className?: string;
+}
+/**
+ * Keep the maintained renderer for hunking, word diffs and highlighting. A new
+ * custom element per effect survives StrictMode remounts without hydrating stale
+ * shadow content. Wrapping is a renderer option, not a CSS patch into its shadow
+ * root; the plain patch disclosure is the accessible, engine-independent view.
+ */
+declare function DiffView({ filename, baseline, current, showFileHeader, defaultWrap, className }: DiffViewProps): React$1.JSX.Element;
+//#endregion
+//#region src/workbench/preview-policy.d.ts
+type PreviewReadiness = {
+  state: "unknown";
+} | {
+  state: "checking";
+} | {
+  state: "ready";
+  checkedAt: string;
+  statusCode: number;
+} | {
+  state: "failed";
+  checkedAt: string;
+  message: string;
+};
+type PreviewAccess = {
+  state: "unknown";
+} | {
+  state: "public" | "authenticated";
+  source: "enforced-policy";
+  expiresAt?: string;
+};
+//#endregion
+//#region src/workbench/preview-view.d.ts
+interface PreviewViewProps {
+  /** A product-authorized preview URL. Relative navigation stays on its origin. */
+  url: string;
+  allowedOrigins?: readonly string[];
+  /** Supply only metadata obtained from the enforcing service, never a UI guess. */
+  access?: PreviewAccess;
+  readiness?: PreviewReadiness;
+  onCheckReadiness?: () => void;
+  onNavigate?: (url: string) => void;
+  /** Compact app chrome omits the editable address and verification row. */
+  variant?: "browser" | "embedded";
+  /** Accessible frame title and compact app label. */
+  title?: string;
+  /** Product actions beside the compact app label. */
+  toolbarActions?: React$1.ReactNode;
+  className?: string;
+}
+declare function PreviewView({ url, allowedOrigins, access, readiness, onCheckReadiness, onNavigate, variant, title, toolbarActions, className }: PreviewViewProps): React$1.JSX.Element;
+//#endregion
+//#region src/workbench/embedded-app-view.d.ts
+interface EmbeddedApp {
+  /** Stable app identity. The host uses it to preserve selection across updates. */
+  id: string;
+  name: string;
+  /** Resolved, credential-free sandbox preview URL. */
+  previewUrl?: string;
+  /** The host supplies this state from its application or preview service. */
+  status: "starting" | "ready" | "unavailable";
+  statusMessage?: string;
+}
+interface EmbeddedAppViewProps {
+  app: EmbeddedApp;
+  /** Product-approved origins, obtained independently of the app URL. */
+  allowedOrigins?: readonly string[];
+  /** Service-observed HTTP result. Never derive it from iframe load. */
+  readiness?: PreviewReadiness;
+  /** Enforced access policy, supplied by the host service. */
+  access?: PreviewAccess;
+  /** Product actions beside the app name in the ready preview header. */
+  toolbarActions?: React$1.ReactNode;
+  /** Recheck or restart the preview through the host's own service. */
+  onRetry?: () => void;
+  className?: string;
+}
+/**
+ * An app-sized preview surface for a product workspace.
+ * The host owns app discovery, persistence, access policy, and readiness checks.
+ */
+declare function EmbeddedAppView({ app, allowedOrigins, readiness, access, toolbarActions, onRetry, className }: EmbeddedAppViewProps): React$1.JSX.Element;
+//#endregion
+//#region src/workbench/syntax.d.ts
+/** Resolve a Prism language id from an explicit hint or the filename. */
+declare function resolveLanguage(filename: string, explicit?: string): string;
+declare const BRAND_PRISM_THEME: Record<string, CSSProperties>;
+interface CodeSurfaceProps {
+  code: string;
+  filename: string;
+  language?: string;
+  showLineNumbers?: boolean;
+  className?: string;
+}
+/**
+ * Read-only, brand-themed code renderer. Wrapped in a scroll container so the
+ * highlighter itself never grows the layout; line numbers sit in a muted,
+ * tabular column.
+ */
+declare function CodeSurface({ code, filename, language, showLineNumbers, className }: CodeSurfaceProps): React$1.JSX.Element;
+//#endregion
+export { ArtifactView as A, buildUnifiedPatch as C, PillTabsProps as D, PillTabs as E, SandboxArtifactTerminal as F, ChangesPaneProps as M, SandboxArtifact as N, ChangesPane as O, SandboxArtifactPaneProps as P, DiffStats as S, PillTabItem as T, FileBreadcrumbProps as _, EmbeddedApp as a, PanelHeader as b, PreviewView as c, PreviewReadiness as d, DiffView as f, FileBreadcrumb as g, CodeViewProps as h, resolveLanguage as i, ChangedFile as j, SandboxArtifactPane as k, PreviewViewProps as l, CodeView as m, CodeSurface as n, EmbeddedAppView as o, DiffViewProps as p, CodeSurfaceProps as r, EmbeddedAppViewProps as s, BRAND_PRISM_THEME as t, PreviewAccess as u, DiffStatsBadge as v, computeDiffStats as w, PanelHeaderProps as x, GitStatusBadge as y };