@oprt/cli 0.0.0-stage → 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,211 @@
+import { C as Command, a as Contract, R as Registry, b as RegistryEntry, A as AddOptions, I as InstallResult } from './read-8a9euzJx.cjs';
+export { c as CliError, d as ComponentDetail, D as DetailProp, e as IndexEntry, f as InstallFile, S as SearchResult, g as applyBlock, h as blockVersion, i as componentDetail, j as componentIndex, r as removeBlock, k as renderAgentBlock, l as renderComponent, s as search } from './read-8a9euzJx.cjs';
+
+/** The envelope every `--json` answer comes in. `type` says what `data` holds. */
+interface Envelope {
+    apiVersion: 1;
+    type: string;
+    data: unknown;
+}
+interface Answer {
+    /** What a person reads. */
+    text: string;
+    /** What `--json` prints. */
+    json: Envelope;
+    exitCode: number;
+}
+type AgentCommand = Extract<Command, {
+    command: "component" | "search" | "init" | "doctor" | "check";
+}>;
+/** Runs one of the commands an agent reads the contract with, and returns both forms of the answer. */
+declare function runAgentCommand(command: AgentCommand, context: {
+    cwd: string;
+    contract: Contract;
+    registry: Registry;
+}): Answer;
+
+/**
+ * The `typescript` module as the project has it. It is opaque in the installer's own types, so
+ * that using those types does not require TypeScript to be installed.
+ */
+type TypeScript = object;
+interface Finding {
+    /** Stable, and only ever added to. Branch on this, not on the message. */
+    code: "INVALID_PROP_VALUE" | "UNKNOWN_EXPORT" | "DOT_NOTATION" | "INVALID_NESTING" | "INVALID_CHILD" | "MISSING_REQUIRED_PROP" | "UNKNOWN_PROP" | "RAW_COLOR" | "ARBITRARY_SIZE" | "ROUNDED_CORNER" | "NATIVE_CONTROL";
+    /** An error breaks the contract. A warning breaks a house rule, or may be a native attribute. */
+    severity: "error" | "warning";
+    file: string;
+    line: number;
+    column: number;
+    component?: string;
+    prop?: string;
+    message: string;
+    valid_values?: string[];
+    suggestions?: string[];
+}
+interface CheckReport {
+    /** How many files were read. */
+    files: number;
+    findings: Finding[];
+    summary: {
+        errors: number;
+        warnings: number;
+    };
+}
+/** Check one file's source. `file` is only the name the findings carry. */
+declare function checkSource(typescript: TypeScript, contract: Contract, file: string, text: string): Finding[];
+/**
+ * Check every .tsx and .jsx file under the given paths. `typescript` is found in the project when
+ * it is not passed; null stands for "there is none".
+ */
+declare function checkPaths(paths: string[], context: {
+    cwd: string;
+    contract: Contract;
+    typescript?: TypeScript | null;
+}): CheckReport;
+
+interface DoctorCheck {
+    id: string;
+    status: "ok" | "warn" | "fail";
+    message: string;
+    fix?: string;
+}
+interface DoctorReport {
+    checks: DoctorCheck[];
+    summary: {
+        ok: number;
+        warn: number;
+        fail: number;
+    };
+}
+declare function doctor({ cwd, contract }: {
+    cwd: string;
+    contract: Contract;
+}): DoctorReport;
+
+interface McpContext {
+    contract: Contract;
+    registry: Registry;
+    /** For check_code. Found beside the project or the installer when it is not passed. */
+    typescript?: TypeScript | null;
+    cwd?: string;
+}
+declare const TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            name?: never;
+            dense?: never;
+            code?: never;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            dense: {
+                type: string;
+                description: string;
+            };
+            query?: never;
+            limit?: never;
+            code?: never;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query?: never;
+            limit?: never;
+            name?: never;
+            dense?: never;
+            code?: never;
+        };
+        required?: never;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            code: {
+                type: string;
+                description: string;
+            };
+            query?: never;
+            limit?: never;
+            name?: never;
+            dense?: never;
+        };
+        required: string[];
+    };
+})[];
+/**
+ * Answer one message. Returns the response to write, or null for a notification, which gets none.
+ * `raw` is a parsed message, or the line itself when it could not be parsed.
+ */
+declare function handleMessage(raw: unknown, context: McpContext): object | null;
+/** Serve until the input ends: one JSON message a line in, one a line out. */
+declare function serve(input: NodeJS.ReadableStream, output: NodeJS.WritableStream, context: McpContext): Promise<void>;
+
+interface InitOptions {
+    agent?: string;
+    /** One file to write instead, relative to the project. */
+    path?: string;
+    /** Take the block out again. */
+    remove?: boolean;
+    dryRun?: boolean;
+}
+interface InitFile {
+    path: string;
+    action: "create" | "append" | "update" | "unchanged" | "remove" | "delete" | "absent";
+}
+interface InitResult {
+    version: string;
+    dryRun: boolean;
+    files: InitFile[];
+}
+declare function init(options: InitOptions, context: {
+    cwd: string;
+    contract: Contract;
+}): InitResult;
+
+declare const DEFAULT_OUT = "src/components/operator";
+declare function parseArgs(args: string[]): Command;
+
+declare function resolveEntries(names: string[], registry: Registry): RegistryEntry[];
+
+declare const VERSION: string;
+declare const registry: Registry;
+/** The contract this installer carries, read from beside it the first time it is asked for. */
+declare const contract: () => Contract;
+
+/** Copy a fully preflighted source bundle; no package manager or network calls. */
+declare function install(options: AddOptions, context?: {
+    cwd?: string;
+    registry?: Registry;
+}): InstallResult;
+
+export { AddOptions, type Answer, type CheckReport, Command, Contract, DEFAULT_OUT, type DoctorCheck, type DoctorReport, type Envelope, type Finding, type InitFile, type InitOptions, type InitResult, InstallResult, type McpContext, Registry, RegistryEntry, TOOLS, type TypeScript, VERSION, checkPaths, checkSource, contract, doctor, handleMessage, init, install, parseArgs, registry, resolveEntries, runAgentCommand, serve };

package/dist/index.d.ts

@@ -0,0 +1,211 @@
+import { C as Command, a as Contract, R as Registry, b as RegistryEntry, A as AddOptions, I as InstallResult } from './read-8a9euzJx.js';
+export { c as CliError, d as ComponentDetail, D as DetailProp, e as IndexEntry, f as InstallFile, S as SearchResult, g as applyBlock, h as blockVersion, i as componentDetail, j as componentIndex, r as removeBlock, k as renderAgentBlock, l as renderComponent, s as search } from './read-8a9euzJx.js';
+
+/** The envelope every `--json` answer comes in. `type` says what `data` holds. */
+interface Envelope {
+    apiVersion: 1;
+    type: string;
+    data: unknown;
+}
+interface Answer {
+    /** What a person reads. */
+    text: string;
+    /** What `--json` prints. */
+    json: Envelope;
+    exitCode: number;
+}
+type AgentCommand = Extract<Command, {
+    command: "component" | "search" | "init" | "doctor" | "check";
+}>;
+/** Runs one of the commands an agent reads the contract with, and returns both forms of the answer. */
+declare function runAgentCommand(command: AgentCommand, context: {
+    cwd: string;
+    contract: Contract;
+    registry: Registry;
+}): Answer;
+
+/**
+ * The `typescript` module as the project has it. It is opaque in the installer's own types, so
+ * that using those types does not require TypeScript to be installed.
+ */
+type TypeScript = object;
+interface Finding {
+    /** Stable, and only ever added to. Branch on this, not on the message. */
+    code: "INVALID_PROP_VALUE" | "UNKNOWN_EXPORT" | "DOT_NOTATION" | "INVALID_NESTING" | "INVALID_CHILD" | "MISSING_REQUIRED_PROP" | "UNKNOWN_PROP" | "RAW_COLOR" | "ARBITRARY_SIZE" | "ROUNDED_CORNER" | "NATIVE_CONTROL";
+    /** An error breaks the contract. A warning breaks a house rule, or may be a native attribute. */
+    severity: "error" | "warning";
+    file: string;
+    line: number;
+    column: number;
+    component?: string;
+    prop?: string;
+    message: string;
+    valid_values?: string[];
+    suggestions?: string[];
+}
+interface CheckReport {
+    /** How many files were read. */
+    files: number;
+    findings: Finding[];
+    summary: {
+        errors: number;
+        warnings: number;
+    };
+}
+/** Check one file's source. `file` is only the name the findings carry. */
+declare function checkSource(typescript: TypeScript, contract: Contract, file: string, text: string): Finding[];
+/**
+ * Check every .tsx and .jsx file under the given paths. `typescript` is found in the project when
+ * it is not passed; null stands for "there is none".
+ */
+declare function checkPaths(paths: string[], context: {
+    cwd: string;
+    contract: Contract;
+    typescript?: TypeScript | null;
+}): CheckReport;
+
+interface DoctorCheck {
+    id: string;
+    status: "ok" | "warn" | "fail";
+    message: string;
+    fix?: string;
+}
+interface DoctorReport {
+    checks: DoctorCheck[];
+    summary: {
+        ok: number;
+        warn: number;
+        fail: number;
+    };
+}
+declare function doctor({ cwd, contract }: {
+    cwd: string;
+    contract: Contract;
+}): DoctorReport;
+
+interface McpContext {
+    contract: Contract;
+    registry: Registry;
+    /** For check_code. Found beside the project or the installer when it is not passed. */
+    typescript?: TypeScript | null;
+    cwd?: string;
+}
+declare const TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            name?: never;
+            dense?: never;
+            code?: never;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            dense: {
+                type: string;
+                description: string;
+            };
+            query?: never;
+            limit?: never;
+            code?: never;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query?: never;
+            limit?: never;
+            name?: never;
+            dense?: never;
+            code?: never;
+        };
+        required?: never;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            code: {
+                type: string;
+                description: string;
+            };
+            query?: never;
+            limit?: never;
+            name?: never;
+            dense?: never;
+        };
+        required: string[];
+    };
+})[];
+/**
+ * Answer one message. Returns the response to write, or null for a notification, which gets none.
+ * `raw` is a parsed message, or the line itself when it could not be parsed.
+ */
+declare function handleMessage(raw: unknown, context: McpContext): object | null;
+/** Serve until the input ends: one JSON message a line in, one a line out. */
+declare function serve(input: NodeJS.ReadableStream, output: NodeJS.WritableStream, context: McpContext): Promise<void>;
+
+interface InitOptions {
+    agent?: string;
+    /** One file to write instead, relative to the project. */
+    path?: string;
+    /** Take the block out again. */
+    remove?: boolean;
+    dryRun?: boolean;
+}
+interface InitFile {
+    path: string;
+    action: "create" | "append" | "update" | "unchanged" | "remove" | "delete" | "absent";
+}
+interface InitResult {
+    version: string;
+    dryRun: boolean;
+    files: InitFile[];
+}
+declare function init(options: InitOptions, context: {
+    cwd: string;
+    contract: Contract;
+}): InitResult;
+
+declare const DEFAULT_OUT = "src/components/operator";
+declare function parseArgs(args: string[]): Command;
+
+declare function resolveEntries(names: string[], registry: Registry): RegistryEntry[];
+
+declare const VERSION: string;
+declare const registry: Registry;
+/** The contract this installer carries, read from beside it the first time it is asked for. */
+declare const contract: () => Contract;
+
+/** Copy a fully preflighted source bundle; no package manager or network calls. */
+declare function install(options: AddOptions, context?: {
+    cwd?: string;
+    registry?: Registry;
+}): InstallResult;
+
+export { AddOptions, type Answer, type CheckReport, Command, Contract, DEFAULT_OUT, type DoctorCheck, type DoctorReport, type Envelope, type Finding, type InitFile, type InitOptions, type InitResult, InstallResult, type McpContext, Registry, RegistryEntry, TOOLS, type TypeScript, VERSION, checkPaths, checkSource, contract, doctor, handleMessage, init, install, parseArgs, registry, resolveEntries, runAgentCommand, serve };