@nklisch/pi-enhanced 0.2.3 → 0.2.4

package/node_modules/@nklisch/pi-plugins/dist/formats/marketplace-reader-support.d.ts

@@ -1,131 +0,0 @@
-import { z } from "zod";
-import { BoundaryError, type Diagnostic } from "../domain/errors.js";
-import { type Claimed, type NativeHost, type Provenance } from "../domain/provenance.js";
-import { type SourceLocation } from "../domain/provenance-location.js";
-import { type MarketplaceInstallationPolicy } from "../domain/marketplace.js";
-import type { MarketplaceEntryDeclaration } from "../domain/marketplace.js";
-import { type JsonValue } from "../domain/schema.js";
-import { type RetainedMetadata } from "../domain/components.js";
-import { type PluginKey } from "../domain/identity.js";
-export type MarketplaceReaderOptions = Readonly<{
-    path?: string;
-}>;
-export declare const MarketplaceEntryDeclarationRegistry: {
-    readonly skills: {
-        readonly category: "component";
-    };
-    readonly commands: {
-        readonly category: "component";
-    };
-    readonly agents: {
-        readonly category: "component";
-    };
-    readonly hooks: {
-        readonly category: "component";
-    };
-    readonly mcpServers: {
-        readonly category: "component";
-    };
-    readonly lspServers: {
-        readonly category: "component";
-    };
-    readonly settings: {
-        readonly category: "runtime-metadata";
-    };
-    readonly outputStyles: {
-        readonly category: "runtime-metadata";
-    };
-    readonly dependencies: {
-        readonly category: "dependency";
-    };
-    readonly plugins: {
-        readonly category: "dependency";
-    };
-};
-export type MarketplaceEntryDeclarationField = keyof typeof MarketplaceEntryDeclarationRegistry;
-/**
- * Encode an RFC 6901 JSON Pointer. The empty pointer is the document root;
- * `/` is a pointer to a property whose name is the empty string.
- */
-export declare function jsonPointer(...segments: readonly (string | number)[]): string;
-/**
- * Validate only the lexical form of a marketplace-relative path. Containment,
- * realpath, and symlink checks intentionally belong to source materialization.
- */
-export declare function validateCatalogRelativePath(path: unknown, pointer: string): string;
-/**
- * Git subdirectory declarations are relative to a remote repository rather
- * than the marketplace checkout. The documented forms use both `plugin` and
- * `./plugin`, so both are accepted while traversal syntax is rejected.
- */
-export declare function validateRelativeSubdirectoryPath(path: unknown, pointer: string): string;
-export declare function joinCatalogRelativePath(root: string | undefined, path: string, pointer: string): string;
-export declare function documentPath(options: MarketplaceReaderOptions | undefined, fallback: string): string;
-export declare function isJsonRecord(value: JsonValue): value is {
-    readonly [key: string]: JsonValue;
-};
-export declare function own(value: {
-    readonly [key: string]: JsonValue;
-}, key: string): boolean;
-export declare function readJsonDocument(json: string, operation: string, nativeHost: NativeHost, path: string): unknown;
-export declare function readRootRecord(input: unknown, operation: string, nativeHost: NativeHost, path: string): {
-    readonly [key: string]: JsonValue;
-};
-export declare function sourceLocation(nativeHost: NativeHost, path: string, pointer: string): SourceLocation;
-export declare function provenanceAt(nativeHost: NativeHost, path: string, pointer: string, declaration?: JsonValue): Provenance;
-export declare function claimedFrom<T>(value: T, provenance: readonly [Provenance, ...Provenance[]]): Claimed<T>;
-export declare function claimAt<T>(value: T, nativeHost: NativeHost, path: string, pointer: string, declaration?: JsonValue): Claimed<T>;
-export declare function rootInvalid(operation: string, nativeHost: NativeHost, path: string, message: string, details?: JsonValue, cause?: unknown, pointer?: string): BoundaryError;
-export type MarketplaceEntryErrorCode = "ENTRY_INVALID" | "IDENTITY_INVALID" | "SOURCE_INVALID";
-export declare class MarketplaceEntryError extends Error {
-    readonly code: MarketplaceEntryErrorCode;
-    readonly pointer: string;
-    readonly plugin?: PluginKey;
-    readonly details?: JsonValue;
-    constructor(input: Readonly<{
-        code: MarketplaceEntryErrorCode;
-        pointer: string;
-        message: string;
-        plugin?: PluginKey;
-        details?: JsonValue;
-    }>);
-}
-export declare function entryError(code: MarketplaceEntryErrorCode, pointer: string, message: string, plugin?: PluginKey, details?: JsonValue): MarketplaceEntryError;
-export declare function entryDiagnostic(error: MarketplaceEntryError, operation: string, nativeHost: NativeHost, path: string): Diagnostic;
-export declare function zodDetails(error: z.ZodError): JsonValue;
-export declare function requireString(value: JsonValue | undefined, field: string, pointer: string, options?: Readonly<{
-    nonEmpty?: boolean;
-}>): string;
-export declare function requireRecord(value: JsonValue | undefined, field: string, pointer: string): {
-    readonly [key: string]: JsonValue;
-};
-export declare function readPluginRoot(root: {
-    readonly [key: string]: JsonValue;
-}, nativeHost: NativeHost, path: string, operation: string): {
-    readonly root: string | undefined;
-    readonly pluginRootProvenance: Provenance | undefined;
-    readonly metadata: RetainedMetadata[];
-};
-export declare function collectRootMetadata(root: {
-    readonly [key: string]: JsonValue;
-}, nativeHost: NativeHost, path: string): RetainedMetadata[];
-export declare function collectEntryMetadata(entry: {
-    readonly [key: string]: JsonValue;
-}, nativeHost: NativeHost, path: string, entryPointer: string, excluded: ReadonlySet<string>): RetainedMetadata[];
-export declare function readInstallationPolicy(raw: JsonValue, nativeHost: NativeHost, path: string, pointer: string): MarketplaceInstallationPolicy;
-/**
- * Validate known declarations at the format boundary. The host-specific shape
- * registries deliberately recognize documented fields while allowing extra
- * fields on an otherwise anchored record, so forward-compatible foreign data
- * is retained without allowing empty or unknown-only runtime records through.
- */
-export declare function validateKnownDeclaration(nativeHost: NativeHost, field: MarketplaceEntryDeclarationField, value: JsonValue, pointer: string): void;
-export declare function collectEntryDeclarations(entry: {
-    readonly [key: string]: JsonValue;
-}, nativeHost: NativeHost, path: string, entryPointer: string): Array<{
-    readonly nativeHost: NativeHost;
-    readonly category: MarketplaceEntryDeclaration["category"];
-    readonly field: MarketplaceEntryDeclarationField;
-    readonly declaration: Claimed<JsonValue>;
-}>;
-export declare function entryPointerPath(entryPointer: string, field: string): string;