@visulima/vis 1.0.0-alpha.7 → 1.0.0-alpha.9

package/dist/commands/sbom.d.ts

@@ -1,10 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-/**
- * `vis sbom` — CycloneDX 1.6 Software Bill of Materials generator.
- *
- * Mirrors `vis docker scaffold` in shape: accepts an optional `--focus`
- * list, walks the workspace graph, and writes the result to disk
- * (or stdout).
- */
-declare const sbom: Command;
-export default sbom;

package/dist/commands/secrets.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const secrets: Command;
-export default secrets;

package/dist/commands/sort-package-json.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const sortPackageJson: Command;
-export default sortPackageJson;

package/dist/commands/staged.d.ts

@@ -1,10 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-import type { RunOptions, StagedConfig } from "../index.d.ts";
-/**
- * Translates the cerebro-parsed CLI options (kebab-case keys, string/boolean values)
- * into a strongly-typed `RunOptions` object. Only the flags the user passed are
- * forwarded — the rest fall through to `runStaged`'s own defaults.
- */
-export declare const buildRunOptions: (raw: Record<string, unknown>, stagedConfig: StagedConfig | undefined) => RunOptions;
-declare const staged: Command;
-export default staged;

package/dist/commands/status.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const status: Command;
-export default status;

package/dist/commands/sync.d.ts

@@ -1,16 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-/**
- * `vis sync <kind>` performs workspace-wide synchronisations that
- * cannot be derived from a task graph alone.
- *
- * Currently supported kinds:
- *
- *  - `codeowners`: aggregates `owners` entries from every project's
- *    project.json into a single CODEOWNERS file at the repo root
- *    (or `.github/CODEOWNERS` when the target flag is set).
- *
- * Additional kinds will land alongside their features (for example:
- * `tsconfig-references`, `package-json` sort, `hooks`).
- */
-declare const sync: Command;
-export default sync;

package/dist/commands/task-why.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const taskWhy: Command;
-export default taskWhy;

package/dist/commands/unlink.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const unlink: Command;
-export default unlink;

package/dist/commands/update.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const update: Command;
-export default update;

package/dist/commands/upgrade.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const upgrade: Command;
-export default upgrade;

package/dist/commands/why.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const why: Command;
-export default why;

package/dist/docker.d.ts

@@ -1,73 +0,0 @@
-import type { ProjectGraph, WorkspaceConfiguration } from "@visulima/task-runner";
-/**
- * Minimal Docker scaffold: copies the set of files Docker's layer
- * cache benefits from keeping stable (manifests + lockfiles) so an
- * image build can `COPY` them first and install dependencies before
- * source code arrives.
- *
- * Computes the set of projects a focus project depends on and copies
- * only their `package.json` + `project.json` + root manifests, not
- * the whole source tree. Compare with moon's `moon docker scaffold`.
- */
-/** Name of the manifest file written by scaffold and read by prune. */
-export declare const DOCKER_MANIFEST_FILENAME = "vis-docker-manifest.json";
-export interface ScaffoldOptions {
-    /** Project names to focus on — transitive deps are pulled in automatically. */
-    focus: string[];
-    /**
-     * Include the full source tree for the focus project(s). Used for the
-     * `sources` stage so the build can actually compile code after deps
-     * are installed.
-     */
-    includeSources?: boolean;
-    /** Output directory, typically `.vis/docker/workspace`. */
-    outDir: string;
-    /** Project graph used to compute the transitive dependency closure. */
-    projectGraph: ProjectGraph;
-    /** Workspace configuration with resolved project roots. */
-    workspace: WorkspaceConfiguration;
-    /** Workspace root on disk. */
-    workspaceRoot: string;
-}
-/**
- * Computes the full set of projects that must exist in the Docker context
- * to build a given focus set: the focus projects themselves plus every
- * project reachable from them in the workspace dependency graph.
- * @param focus Project names to focus on.
- * @param projectGraph The workspace project graph.
- * @returns A set containing every project in the transitive closure.
- */
-export declare const resolveFocusProjects: (focus: string[], projectGraph: ProjectGraph) => Set<string>;
-/**
- * Build a minimal Docker context at {@link ScaffoldOptions.outDir}.
- *
- * Creates two directories:
- * - `&lt;outDir>/workspace/` — root manifests + per-project manifests for the
- *   focus closure. `COPY` this BEFORE `pnpm install` for layer caching.
- * - `&lt;outDir>/sources/` — full source trees for the focus projects (only
- *   when {@link ScaffoldOptions.includeSources} is true).
- * @param options Scaffold configuration.
- * @returns The list of project names included in the scaffold.
- */
-export declare const scaffoldDockerContext: (options: ScaffoldOptions) => {
-    projects: string[];
-};
-export interface PruneOptions {
-    /** Root of the scaffolded context (containing `vis-docker-manifest.json`). */
-    contextRoot: string;
-    workspace: WorkspaceConfiguration;
-    workspaceRoot: string;
-}
-/**
- * Removes every workspace project that is not in the focus closure.
- *
- * Intended to run inside a Docker build stage after installing
- * dependencies, so unfocused workspace symlinks are stripped from
- * the final image.
- * @param options Prune configuration.
- * @returns The list of project root paths that were removed.
- * @throws If no `vis-docker-manifest.json` exists at the context root.
- */
-export declare const pruneDockerContext: (options: PruneOptions) => {
-    removed: string[];
-};

package/dist/flakiness.d.ts

@@ -1,40 +0,0 @@
-import type { LoadedRunSummary } from "./run-report.d.ts";
-/**
- * Per-task flakiness statistics aggregated across multiple run summaries.
- */
-export interface TaskFlakiness {
-    /** Number of runs where this task failed (exitCode !== 0). */
-    failures: number;
-    /** Flakiness rate: failures / totalRuns. */
-    flakinessRate: number;
-    /** Most recent failure time (ISO 8601), if any. */
-    lastFailure?: string;
-    project: string;
-    /** Number of runs where this task succeeded. */
-    successes: number;
-    target: string;
-    taskId: string;
-    /** Total number of times this task appeared in runs. */
-    totalRuns: number;
-}
-/**
- * Reads all run summary files from `.task-runner/runs/` and computes
- * per-task flakiness statistics.
- *
- * Pass `summaries` (from {@link loadRunSummaries}) when the caller
- * already loaded the history — avoids re-reading every JSON off disk
- * just to get the same data.
- * @param workspaceRoot Absolute path to the workspace root.
- * @param options Filtering options.
- * @returns Flakiness stats sorted by rate (most flaky first).
- */
-export declare const analyzeFlakiness: (workspaceRoot: string, options?: {
-    minRuns?: number;
-    since?: string;
-}, summaries?: LoadedRunSummary[]) => TaskFlakiness[];
-/**
- * Formats flakiness stats as an ASCII table.
- * @param stats Flakiness statistics to format.
- * @returns Lines of formatted output (including header).
- */
-export declare const formatFlakinessTable: (stats: TaskFlakiness[]) => string[];

package/dist/generate/discover.d.ts

@@ -1,29 +0,0 @@
-/**
- * Template discovery for `vis generate`.
- *
- * Discovery sources, in priority order:
- *   1. Native templates in `<workspace>/.vis/templates/<name>.{ts,js,mjs}`.
- *   2. Moon-format directories in `<workspace>/.vis/templates/<name>/`
- *      (any directory with a `template.yml`).
- *   3. Moon-format directories in `<workspace>/.moon/templates/<name>/`
- *      (zero-config import for users mid-migration from moon).
- *   4. Extra directories listed in `vis.config.ts` `generator.templates`.
- *
- * Native templates win over moon templates with the same name; a
- * warning is printed at discovery time so the conflict is visible.
- */
-import type { DiscoveredTemplate } from "./types.d.ts";
-interface DiscoverOptions {
-    /** Extra template directories from `vis.config.ts` `generator.templates`. */
-    extraDirectories?: string[];
-    /** Logger callback for conflict warnings. */
-    onWarning?: (message: string) => void;
-    /** Workspace root — `.vis/templates/` and `.moon/templates/` are resolved against this. */
-    workspaceRoot: string;
-}
-/**
- * Discover templates across the workspace. Returns a deduplicated list
- * with native sources winning over moon when names collide.
- */
-export declare const discoverTemplates: (options: DiscoverOptions) => DiscoveredTemplate[];
-export {};

package/dist/generate/loader.d.ts

@@ -1,15 +0,0 @@
-/**
- * Native template loader.
- *
- * Native templates live as `.ts`/`.js`/`.mjs` modules under
- * `<workspace>/.vis/templates/<name>.<ext>` and export a `Template` as
- * their default export. We use jiti so TypeScript and ESM/CJS
- * interop both work without a separate build step.
- */
-import type { Template } from "./types.d.ts";
-/**
- * Load a native template module from disk and return its default export.
- * The directory containing the file is used as jiti's working dir so
- * relative imports inside the template resolve as the author expects.
- */
-export declare const loadNativeTemplate: (path: string) => Promise<Template>;

package/dist/generate/moon-adapter/filename-interp.d.ts

@@ -1,42 +0,0 @@
-/**
- * Filename interpolation for moon-format templates.
- *
- * Bracket syntax inside any path segment:
- *   `[var]`            → value of `var` from the variable map
- *   `[var | filter]`   → filter applied to the value
- *   `[var | filter(arg)]` → filter with a string argument
- *
- * Suffixes `.tera` and `.twig` are stripped from the final segment
- * (they exist only for editor syntax highlighting).
- */
-/**
- * Interpolate a single path segment or an entire path. Variables are
- * looked up in `vars`; missing keys raise an error so typos surface
- * during render rather than producing surprising filenames.
- *
- * `.tera` / `.twig` extensions are stripped from the result.
- */
-export declare const interpolateFilename: (filename: string, vars: Record<string, unknown>) => string;
-/**
- * Strip the trailing `.tera` / `.twig` marker from **every** path
- * segment. moon strips them per segment (not just the final one) so a
- * template at `src/.tera/file.ts.tera` renders to `src/file.ts`, not
- * `src/.tera/file.ts`.
- */
-export declare const stripTeraSuffix: (filename: string) => string;
-/**
- * Strip the trailing `.raw` extension. moon adopters ship binary or
- * Tera-conflicting files with `.raw` suffix; renderers must skip them
- * but the suffix itself is removed on write.
- */
-export declare const stripRawSuffix: (filename: string) => string;
-/**
- * True when the file is a partial — matched by *either* a basename
- * starting with `_` (moon's primary convention) or a path segment
- * equal to `partials` (moon's "folder of partials" convention).
- *
- * The earlier substring match on `"partial"` swallowed any file whose
- * name contained those letters (e.g. `PartialResult.ts`,
- * `partially-applied.ts`), silently dropping them from the output.
- */
-export declare const isPartialPath: (path: string) => boolean;

package/dist/generate/moon-adapter/filters.d.ts

@@ -1,22 +0,0 @@
-/**
- * Built-in filter functions used by the Tera-subset renderer and
- * the filename interpolator. Names match moon's filter set.
- *
- * Case helpers come from `@visulima/string/case` (better Unicode and
- * acronym handling than the bare `change-case` package; same package
- * powers the rest of the visulima toolchain). Path filters use
- * `@visulima/path` so behaviour matches the rest of vis.
- */
-export type FilterFn = (value: unknown, ...args: unknown[]) => unknown;
-/**
- * Map of filter name → function. Unknown filter names raise an error
- * at render time so typos in templates don't silently no-op.
- */
-export declare const FILTERS: Record<string, FilterFn>;
-export declare const isKnownFilter: (name: string) => boolean;
-/**
- * Apply a filter by name with optional arguments. Throws when the
- * filter name is unknown — callers should phrase the error with a
- * file:line reference.
- */
-export declare const applyFilter: (name: string, value: unknown, args?: unknown[]) => unknown;

package/dist/generate/moon-adapter/frontmatter.d.ts

@@ -1,39 +0,0 @@
-/**
- * Per-file YAML frontmatter splitter for moon-format templates.
- *
- * Frontmatter is a YAML block delimited by `---` on its own line at
- * the very top of a file. Recognised keys (moon parity):
- *   - `to`: override the destination path (interpolation supported)
- *   - `force`: overwrite without prompting (default false)
- *   - `if`: include the file only when the condition is truthy
- *   - `skip`: skip rendering entirely when truthy
- *
- * Frontmatter is parsed via `@visulima/fs` `readYaml`-compatible YAML
- * dialect. The parser is exposed as a callback to keep this module
- * dependency-free for unit tests.
- */
-export interface Frontmatter {
-    /** Allow extra keys without losing them on round-trip. */
-    [key: string]: unknown;
-    /** Overwrite an existing file at the destination without prompting. */
-    force?: boolean;
-    /** Truthy expression / value gate — file is emitted only when truthy. */
-    if?: unknown;
-    /** Truthy expression / value gate — file is skipped when truthy. */
-    skip?: unknown;
-    /** Override destination path; supports `{{ var }}` interpolation. */
-    to?: string;
-}
-export interface SplitResult {
-    /** File body with the frontmatter block removed. */
-    body: string;
-    /** Parsed frontmatter, or `undefined` when the file has no `---` block. */
-    frontmatter?: Frontmatter;
-}
-/**
- * Split the frontmatter block from the file body.
- * @param source The file contents.
- * @param parseYaml YAML parser callback; pass `(s) => parseYaml(s)` from
- * `@visulima/fs/yaml` at the call site to avoid a runtime dep here.
- */
-export declare const splitFrontmatter: (source: string, parseYaml: (yaml: string) => unknown) => SplitResult;

package/dist/generate/moon-adapter/index.d.ts

@@ -1,19 +0,0 @@
-/**
- * Moon-format template adapter.
- *
- * Loads a directory matching moon's template layout
- * (`template.yml` + a tree of files / partials / assets) and synthesises
- * a `Template` (the same shape native vis templates export).
- *
- * The adapter pre-reads every template file at load time and parses
- * the AST once. Per-run the renderer evaluates the AST against the
- * resolved options scope — no further disk I/O.
- */
-import type { Template } from "../types.d.ts";
-/**
- * Load a moon-format template directory into a `Template`.
- * @param templateDir Absolute path to the directory containing `template.yml`.
- * @param name Stable name used by `vis generate <name>` (used as a fallback
- * when `template.yml` omits `title`).
- */
-export declare const loadMoonTemplate: (templateDir: string, name: string) => Template;

package/dist/generate/moon-adapter/tera-subset.d.ts

@@ -1,85 +0,0 @@
-/**
- * Tera-subset renderer for moon-format template content.
- *
- * Supported constructs (intersection of moon's most-used features):
- *   - `{{ var }}` and `{{ var | filter }}` and `{{ var | filter(arg) }}`
- *     with chained filters: `{{ var | snake_case | upper_case }}`
- *   - `{% if expr %} ... {% else %} ... {% endif %}`
- *     where `expr` is `var`, `not var`, `var == "lit"`, `var != "lit"`
- *   - `{% for x in collection %} ... {% endfor %}`
- *     where `collection` is a variable holding an array
- *   - `{% include "name" %}` — pulls the rendered output of a partial
- *
- * Explicitly UNSUPPORTED, with a clear `file:line` error message:
- *   - `{% set x = ... %}`
- *   - `{% extends "..." %}`
- *   - `{% block ... %}` / `{% endblock %}`
- *   - `{% macro ... %}` / `{% endmacro %}`
- *   - Custom whitespace control (`{%- -%}`)
- *
- * The parser is a single-pass tokenizer feeding a tree-walking
- * evaluator. Errors carry the original 1-based line number for the
- * source file, threaded through from the moon adapter via `filename`.
- */
-type Node = {
-    type: "text";
-    value: string;
-} | {
-    expression: string;
-    line: number;
-    type: "expr";
-} | {
-    alternate?: Node[];
-    condition: string;
-    consequent: Node[];
-    line: number;
-    type: "if";
-} | {
-    binding: string;
-    body: Node[];
-    collection: string;
-    line: number;
-    type: "for";
-} | {
-    line: number;
-    name: string;
-    type: "include";
-};
-/**
- * Recursive-descent condition evaluator with precedence:
- *   `or` (lowest) → `and` → `not` → comparison (`==` / `!=`) → primary.
- * Parentheses override precedence.
- *
- * Exported so the moon adapter can reuse the same grammar on
- * frontmatter `if:` / `skip:` strings.
- */
-export declare const evaluateConditionExpression: (condition: string, scope: Record<string, unknown>, filename: string, line: number) => boolean;
-interface RenderOptions {
-    /** Source filename — used in error messages. */
-    filename: string;
-    /**
-     * Internal: set of partial names currently on the include stack.
-     * Used to detect cycles — if an include re-enters a partial that's
-     * already resolving, we throw instead of stack-overflowing.
-     */
-    includeStack?: Set<string>;
-    /** Map of partial name → already-resolved AST. */
-    partials?: Map<string, Node[]>;
-    /** Variable scope (built-in vars merged with user options). */
-    scope: Record<string, unknown>;
-}
-/**
- * Parse a template source into an AST. Used by the moon adapter to
- * pre-parse partials once and reuse them across files.
- */
-export declare const parseTemplate: (source: string, filename: string) => Node[];
-/**
- * Render a parsed AST with the given scope.
- */
-export declare const renderAst: (nodes: Node[], options: RenderOptions) => string;
-/**
- * Convenience: parse + render in one call. Prefer `parseTemplate` +
- * `renderAst` when a template is rendered repeatedly (e.g. in loops).
- */
-export declare const renderTemplate: (source: string, options: RenderOptions) => string;
-export type { Node };

package/dist/generate/moon-adapter/util.d.ts

@@ -1,14 +0,0 @@
-/**
- * Split on `,` at the top level — outside quotes and parentheses.
- *
- * Used by both `parseFilterCall` in `filename-interp.ts` and
- * `tera-subset.ts` so `path_join("a,b", "c")` and
- * `[var | path_join("a,b", "c")]` produce the same two args.
- */
-export declare const splitCommaOutsideQuotes: (input: string) => string[];
-/**
- * Strip matching single- or double-quote wrappers. Returns `undefined`
- * when the input isn't a quoted literal so callers can fall through to
- * variable lookup or number parsing.
- */
-export declare const stripQuotes: (input: string) => string | undefined;

package/dist/generate/prompts.d.ts

@@ -1,25 +0,0 @@
-/**
- * Variable-schema → interactive prompts.
- *
- * Builds on the same `node:readline` helpers `vis create` uses (see
- * src/commands/create/prompts.ts). The implementation is minimal — no
- * fancy multi-line UI, no spinner, no terminal control codes — to
- * stay consistent with the rest of the vis CLI surface.
- */
-import type { Options, VariableMap } from "./types.d.ts";
-interface CollectOptions {
-    /** When true, skip prompts and use defaults / overrides only. */
-    defaults: boolean;
-    /** When false, never prompt — error on missing required values. */
-    interactive: boolean;
-    /** CLI overrides — variable name → unparsed string from `--name=value`. */
-    overrides: Record<string, string>;
-    /** Variable schema. */
-    variables: VariableMap;
-}
-/**
- * Collect option values from prompts + CLI overrides + defaults, then
- * validate them.
- */
-export declare const collectOptions: (collectOptionsArguments: CollectOptions) => Promise<Options>;
-export {};

package/dist/generate/remote.d.ts

@@ -1,43 +0,0 @@
-/**
- * Remote template fetching for `vis generate`.
- *
- * Reuses giget (already a vis dep, used by `vis create`) to fetch
- * `git://`, `npm://`, and `https://` archive sources into a cache
- * directory before discover/load runs against them.
- *
- * Sources are normalized via the same patterns vis create uses; see
- * `src/commands/create/templates/remote.ts` for the underlying
- * downloadTemplate call.
- */
-/**
- * True when the input looks like a remote source giget can resolve.
- */
-export declare const isRemoteSource: (input: string) => boolean;
-interface FetchOptions {
-    /** Auth token forwarded to giget for private repos. */
-    auth?: string;
-    /** Prefer cached templates over re-download. */
-    preferOffline?: boolean;
-    /** Override the cache/work directory (defaults to a fresh tmp). */
-    targetDirectory?: string;
-}
-export interface FetchResult {
-    /**
-     * Release the tmp directory once the caller has finished loading
-     * the template into memory. No-op when the directory was supplied
-     * externally via `targetDirectory`.
-     */
-    cleanup: () => void;
-    /** Absolute directory containing the downloaded template. */
-    directory: string;
-}
-/**
- * Download a remote template and return the directory it lives in.
- * @example
- * ```typescript
- * const { directory } = await fetchRemoteTemplate("git://github.com/org/template#main");
- * const template = await loadMoonTemplate(directory, "from-git");
- * ```
- */
-export declare const fetchRemoteTemplate: (source: string, options?: FetchOptions) => Promise<FetchResult>;
-export {};

package/dist/generate/runner.d.ts

@@ -1,37 +0,0 @@
-/**
- * Template runner — applies a `Creation` to disk.
- *
- * Walks the recursive `files` tree, prompts for overwrites unless
- * `--force` was passed, runs scripts in phase order, and prints
- * suggestions at the end. `--dry-run` prints the planned writes
- * without touching the filesystem.
- *
- * Every write target is checked against the destination directory to
- * reject `..`-escapes and absolute paths coming from rendered
- * frontmatter `to:` fields or filename interpolation — template
- * authors (or remote templates) must not be able to scribble
- * outside the caller's chosen destination.
- */
-import type { Template } from "./types.d.ts";
-interface RunnerOptions {
-    /** Caller's CWD for `working_dir`. */
-    cwd: string;
-    /** Destination directory (absolute). */
-    destination: string;
-    /** When true, print but don't write. */
-    dryRun?: boolean;
-    /** When true, overwrite existing files without prompting. */
-    force?: boolean;
-    /** Resolved option values from `collectOptions`. */
-    options: Record<string, unknown>;
-    /** When true, don't run scripts. */
-    skipScripts?: boolean;
-    /** Workspace root for `dest_rel_dir`. */
-    workspaceRoot: string;
-}
-/**
- * Run a template end-to-end: invoke `produce`, write files, run scripts,
- * print suggestions.
- */
-export declare const runTemplate: (template: Template, options: RunnerOptions) => Promise<void>;
-export {};