@wrtnlabs/evidence 0.0.0 → 0.1.0

package/lib/adapters/prisma/IPrismaBlockHead.d.ts

@@ -1,21 +0,0 @@
-/** One recognized Prisma top-level block declaration.
- *
- * The position scanner records only the head needed to associate parser-owned
- * semantic models with their original source spans.
- */
-export interface IPrismaBlockHead {
-    /**
-     * Prisma block kind, such as `model` or `view`.
-     *
-     * The position scanner combines this keyword with `name` to recognize only
-     * block forms that can be paired with parser-established semantic models.
-     */
-    keyword: string;
-    /**
-     * Declared block name following the recognized keyword.
-     *
-     * This authored spelling supplies the physical lookup key; semantic validity
-     * still belongs to the whole-schema parser rather than this lexical scan.
-     */
-    name: string;
-}

package/lib/adapters/prisma/IPrismaCacheEntry.d.ts

@@ -1,22 +0,0 @@
-import type { IPrismaModel } from "./IPrismaModel";
-/** Remembered Prisma parse outcome for one parser and schema digest.
- *
- * Parser version and complete schema content form the external cache key so
- * stale parser behavior cannot be reused for a changed schema set.
- */
-export interface IPrismaCacheEntry {
-    /**
-     * Parser-normalized models after a successful parse.
-     *
-     * A cache entry stores this branch for a parser-version and schema-set digest,
-     * allowing callers to receive a cloned semantic model without reparsing.
-     */
-    models?: IPrismaModel[];
-    /**
-     * Stable parser failure for the cached input when parsing failed.
-     *
-     * `PrismaModelLoader` rethrows this remembered diagnostic for the same cache
-     * key so repeated scans do not hide or reformat a deterministic parse error.
-     */
-    problem?: string;
-}

package/lib/adapters/prisma/IPrismaCommentRun.d.ts

@@ -1,51 +0,0 @@
-import type { IEvidenceSourceRange } from "../../structures/IEvidenceSourceRange";
-import type { PrismaCommentForm } from "./PrismaCommentForm";
-/** Represents consecutive Prisma comments considered as one documentation run.
- *
- * The position scanner groups fragments before semantic parsing so downstream
- * attachment can retain both the mapped text and the exact source comments.
- */
-export interface IPrismaCommentRun {
-    /** Identifies the syntax form shared by comments in this run.
-     *
-     * The form determines whether the run can document a declaration or is kept
-     * as an unsupported or detached annotation carrier.
-     */
-    form: PrismaCommentForm;
-    /** Names the declaration location to which this run is attached.
-     *
-     * An empty key means no declaration received the run.
-     */
-    key: string;
-    /** Marks a documentation run attached to the schema file itself.
-     *
-     * This is true only for top-level `///` runs with no declaration key.
-     */
-    fileLevel: boolean;
-    /** Stores normalized run text in source-line order.
-     *
-     * Inserted newlines retain coordinate entries in `offsets` and `ends`.
-     */
-    text: string;
-    /** Maps each text character to its original UTF-16 start offset.
-     *
-     * The final sentinel maps the end of the run for mapped documentation.
-     */
-    offsets: number[];
-    /** Maps each text character to its original UTF-16 end offset.
-     *
-     * Its positions correspond to `offsets` and preserve source discontinuities.
-     */
-    ends: number[];
-    /** Covers the complete comment run in original source coordinates.
-     *
-     * This includes delimiters and line gaps between retained fragments.
-     */
-    range: IEvidenceSourceRange;
-    /** Lists the physical range of each original comment fragment.
-     *
-     * Consumers use these ranges when a grouped run must report individual
-     * source carriers.
-     */
-    commentRanges: IEvidenceSourceRange[];
-}

package/lib/adapters/prisma/IPrismaDatamodel.d.ts

@@ -1,15 +0,0 @@
-import type { IPrismaDatamodelModel } from "./IPrismaDatamodelModel";
-/** Prisma parser payload needed by the Evidence adapter.
- *
- * Evidence deliberately consumes the parser's semantic model rather than
- * inferring model structure from source text.
- */
-export interface IPrismaDatamodel {
-    /**
-     * Parsed models and views in parser-provided order.
-     *
-     * `PrismaModelLoader` converts these semantic roots into detached Evidence
-     * models before later source scanning associates them with physical sites.
-     */
-    models: IPrismaDatamodelModel[];
-}

package/lib/adapters/prisma/IPrismaDatamodelField.d.ts

@@ -1,26 +0,0 @@
-/** One resolved model member returned by Prisma's schema parser.
- *
- * This reduced parser payload contains only information that affects Evidence
- * unit selection, documentation, and fingerprints.
- */
-export interface IPrismaDatamodelField {
-    /**
-     * Parser-resolved field name within its owning model.
-     *
-     * The loader retains this parser-approved spelling for the model member's
-     * identity instead of attempting to classify source tokens independently.
-     */
-    name: string;
-    /**
-     * Parser classification used to select supported database members.
-     *
-     * `PrismaModelLoader` maps object fields to relations and every other retained
-     * field to columns when it creates the adapter's normalized field contract.
-     */
-    kind: string;
-    /** Parser-attached documentation, when source supplied it.
-     *
-     * `null` and omission both mean no parser documentation is available.
-     */
-    documentation?: string | null;
-}

package/lib/adapters/prisma/IPrismaDatamodelModel.d.ts

@@ -1,29 +0,0 @@
-import type { IPrismaDatamodelField } from "./IPrismaDatamodelField";
-/** One model or view returned by Prisma's schema parser.
- *
- * The loader later pairs this semantic result with a physical source location
- * instead of treating parser output as an independently owned artifact.
- */
-export interface IPrismaDatamodelModel {
-    /**
-     * Parser-resolved model or view name.
-     *
-     * This name joins a semantic model from the WASM parser to its separately
-     * scanned source declaration and to its materialized Evidence identity.
-     */
-    name: string;
-    /**
-     * Parser-attached block documentation when present.
-     *
-     * Omission or `null` means the parser found no block documentation;
-     * `PrismaModelLoader` normalizes both states to its detached empty text value.
-     */
-    documentation?: string | null;
-    /**
-     * Members belonging to this parser-established model.
-     *
-     * Their parser classifications are converted into Evidence columns or
-     * relations only after the containing model has been materialized.
-     */
-    fields: IPrismaDatamodelField[];
-}

package/lib/adapters/prisma/IPrismaField.d.ts

@@ -1,36 +0,0 @@
-import type { EvidenceDatabaseSymbol } from "../../typings/EvidenceDatabaseSymbol";
-/** One parser-classified Prisma model member.
- *
- * These detached records make the cross-file materializer independent of the
- * WASM parser lifetime while preserving the member fingerprint boundary.
- */
-export interface IPrismaField {
-    /**
-     * Name relative to the owning model identity.
-     *
-     * The materializer joins it with its containing model name to create the
-     * public address and semantic identity for this member.
-     */
-    name: string;
-    /**
-     * Evidence unit symbol selected from the parser field kind.
-     *
-     * Prisma scalar fields become columns and object fields become relations, so
-     * this normalized symbol controls selector matching without retaining WASM data.
-     */
-    symbol: Exclude<EvidenceDatabaseSymbol, "model">;
-    /**
-     * Documentation text used to recover directive and withdrawal state.
-     *
-     * The adapter parses this detached text after it establishes the field's host,
-     * keeping comment metadata separate from the semantic fingerprint payload.
-     */
-    documentation: string;
-    /**
-     * Semantic field digest excluding documentation metadata.
-     *
-     * Review fingerprints use this value to detect changes to the field itself
-     * without treating explanatory or Evidence annotation edits as semantic drift.
-     */
-    digest: string;
-}

package/lib/adapters/prisma/IPrismaFileAnalysis.d.ts

@@ -1,31 +0,0 @@
-import type { IEvidenceSourceFile } from "../../structures/IEvidenceSourceFile";
-import type { IPrismaCommentRun } from "./IPrismaCommentRun";
-import type { IPrismaLocation } from "./IPrismaLocation";
-/** Position-only scan of one Prisma schema source.
- *
- * This pass owns original ranges and comments; semantic declarations remain
- * owned by the whole-schema parser result.
- */
-export interface IPrismaFileAnalysis {
-    /**
-     * Immutable source snapshot whose coordinates the scan records.
-     *
-     * Every location and comment run in this analysis is valid only for this exact
-     * content and supplies its physical identity to later materialization.
-     */
-    source: IEvidenceSourceFile;
-    /**
-     * Parser-matchable declaration spans in this physical file.
-     *
-     * These locations join parser-established model and field identities to their
-     * source sites without giving the position scanner semantic ownership.
-     */
-    locations: IPrismaLocation[];
-    /**
-     * Consecutive comment runs available for documentation attachment.
-     *
-     * Attachment logic uses these physical comment ranges to find eligible carriers
-     * after the parser result has identified the declaration they can document.
-     */
-    comments: IPrismaCommentRun[];
-}

package/lib/adapters/prisma/IPrismaLineParts.d.ts

@@ -1,26 +0,0 @@
-import type { IPrismaPendingComment } from "./IPrismaPendingComment";
-/** Splits one Prisma source line into structural code and comment state.
- *
- * `PrismaFileScanner` carries the block-comment state to the next line while
- * using `code` alone to locate declarations and braces.
- */
-export interface IPrismaLineParts {
-    /** Contains source characters that remain structural code on this line.
-     *
-     * Comment delimiters and comment content are excluded so quoted or commented
-     * braces cannot change the scanner's nesting depth.
-     */
-    code: string;
-    /** Retains the comment fragment found on this line.
-     *
-     * Omission means the line contains no comment content, including continued
-     * block-comment state with no retained text.
-     */
-    comment?: IPrismaPendingComment;
-    /** States whether a block comment remains open after this line.
-     *
-     * The next call uses this state to avoid treating comment text as Prisma
-     * syntax.
-     */
-    commented: boolean;
-}

package/lib/adapters/prisma/IPrismaLoadResult.d.ts

@@ -1,22 +0,0 @@
-import type { IPrismaModel } from "./IPrismaModel";
-/** Parsed schema units beside the whole-set cache identity.
- *
- * Prisma resolves relations across schema files, so the cache and parser result
- * belong to the selected file set rather than an individual source file.
- */
-export interface IPrismaLoadResult {
-    /**
-     * Semantic models materialized from the entire selected schema set.
-     *
-     * Prisma resolves relations across files, so this collection belongs to the
-     * complete parser input rather than to one selected physical source file.
-     */
-    models: IPrismaModel[];
-    /**
-     * Digest identifying the parser version and complete selected source set.
-     *
-     * The loader returns this cache identity with its models so callers can retain
-     * a result only while every selected schema source and parser version agree.
-     */
-    digest: string;
-}

package/lib/adapters/prisma/IPrismaLocatedDeclaration.d.ts

@@ -1,20 +0,0 @@
-import type { IPrismaFileAnalysis } from "./IPrismaFileAnalysis";
-import type { IPrismaLocation } from "./IPrismaLocation";
-/** Couples a Prisma semantic declaration location with its source analysis.
- *
- * Consumers resolve parser-established identities through this pair without
- * asking the position scanner to decide which Prisma declarations are valid.
- */
-export interface IPrismaLocatedDeclaration {
-    /** Supplies source-wide locations and comment runs for the declaration.
-     *
-     * The analysis owns coordinate maps and remains the authority for its
-     * physical source snapshot.
-     */
-    analysis: IPrismaFileAnalysis;
-    /** Identifies the parser-matched physical span within that analysis.
-     *
-     * Its key connects the semantic parser result to a concrete declaration site.
-     */
-    location: IPrismaLocation;
-}

package/lib/adapters/prisma/IPrismaLocation.d.ts

@@ -1,22 +0,0 @@
-import type { IEvidenceSourceRange } from "../../structures/IEvidenceSourceRange";
-/** Source position found for one parser-established Prisma identity.
- *
- * Keys connect semantic parser output to physical content without making source
- * scanning guess which declarations the Prisma parser accepts.
- */
-export interface IPrismaLocation {
-    /**
-     * Adapter identity key for the model or model member at this location.
-     *
-     * Materialization uses this key to join a lexical declaration span with the
-     * semantic parser result without reinterpreting Prisma schema syntax.
-     */
-    key: string;
-    /**
-     * Exact physical source range used for the materialized site.
-     *
-     * The resulting Evidence site owns this range for diagnostics, fingerprints,
-     * and documentation attachment in the immutable source snapshot.
-     */
-    range: IEvidenceSourceRange;
-}

package/lib/adapters/prisma/IPrismaModel.d.ts

@@ -1,36 +0,0 @@
-import type { IPrismaField } from "./IPrismaField";
-/** One parser-normalized Prisma model or view.
- *
- * The model is the ownership root for materialized members and exposes only
- * detached semantic data that can safely outlive the parser call.
- */
-export interface IPrismaModel {
-    /**
-     * Public Prisma model or view name.
-     *
-     * This parser-normalized name forms the root of each model and member identity
-     * that the adapter later exposes through its Evidence inventory.
-     */
-    name: string;
-    /**
-     * Block documentation used for model-level review metadata.
-     *
-     * The empty string means the parser supplied no documentation; later attachment
-     * still uses the physical scanner to decide whether a carrier is eligible.
-     */
-    documentation: string;
-    /**
-     * Semantic block digest excluding documentation directives.
-     *
-     * This content contribution lets reviews detect a changed model declaration
-     * while annotations and prose do not alter the semantic fingerprint.
-     */
-    digest: string;
-    /**
-     * Parser-classified members owned by this model.
-     *
-     * The model owns their identity hierarchy, while each field retains a separate
-     * normalized symbol, documentation text, and semantic digest.
-     */
-    fields: IPrismaField[];
-}

package/lib/adapters/prisma/IPrismaOwnedUnit.d.ts

@@ -1,37 +0,0 @@
-import type { IEvidenceUnit } from "../../structures/IEvidenceUnit";
-import type { IEvidenceUnitSite } from "../../structures/IEvidenceUnitSite";
-/** Prisma unit beside the parser documentation used to recover withdrawal state.
- *
- * Ownership is kept explicitly because unit materialization needs both semantic
- * output and the comment text that established its review state.
- */
-export interface IPrismaOwnedUnit {
-    /**
-     * Identity joining the unit to position and documentation records.
-     *
-     * This key connects parser-owned semantic output with the physical scan that
-     * establishes the site and comment carrier for the materialized unit.
-     */
-    key: string;
-    /**
-     * Parser documentation associated with this semantic unit.
-     *
-     * Withdrawal and review handling reads this value after it establishes a host,
-     * preserving the parser's documentation independently of source coordinates.
-     */
-    documentation: string;
-    /**
-     * Materialized public or internal Evidence unit.
-     *
-     * This unit carries the semantic identity and selection state that graph
-     * evaluation consumes after the Prisma adapter completes materialization.
-     */
-    unit: IEvidenceUnit;
-    /**
-     * Physical declaration site that owns the unit fingerprint.
-     *
-     * The site preserves position and content ranges from the scanner, which are
-     * required to compare review fingerprints against authored source changes.
-     */
-    site: IEvidenceUnitSite;
-}

package/lib/adapters/prisma/IPrismaParser.d.ts

@@ -1,28 +0,0 @@
-/** Resolved Prisma WASM parser and its diagnostic identity.
- *
- * The adapter records the parser implementation identity in cache keys because
- * parser upgrades can change semantic output for unchanged schema text.
- */
-export interface IPrismaParser {
-    /**
-     * Parses the complete schema parameter payload into serialized JSON.
-     *
-     * `PrismaModelLoader` supplies every selected file in the parser's expected
-     * payload shape, then validates the returned JSON as `IPrismaDatamodel`.
-     */
-    getDatamodel(parameters: string): string;
-    /**
-     * Parser version contributing to the whole-schema cache identity.
-     *
-     * A version change invalidates cached semantic output even when selected source
-     * content has not changed, because parser behavior can alter the datamodel.
-     */
-    version: string;
-    /**
-     * Human-readable implementation origin for diagnostics.
-     *
-     * The loader reports whether resolution selected the consumer project or the
-     * Evidence package copy when parser loading or parsing fails.
-     */
-    origin: string;
-}

package/lib/adapters/prisma/IPrismaPendingComment.d.ts

@@ -1,52 +0,0 @@
-import type { IEvidenceSourceRange } from "../../structures/IEvidenceSourceRange";
-import type { PrismaCommentForm } from "./PrismaCommentForm";
-/** Retains one Prisma comment fragment before it is grouped into a run.
- *
- * The line scanner records text and coordinate maps separately so grouping can
- * insert line breaks without losing the original source positions.
- */
-export interface IPrismaPendingComment {
-    /** Identifies the source syntax used for this comment fragment.
-     *
-     * Documentation runs distinguish `///` comments from ordinary lines and
-     * block comments using this form.
-     */
-    form: PrismaCommentForm;
-    /** Gives the zero-based source line that contains this fragment.
-     *
-     * Runs use it to preserve blank lines between comments.
-     */
-    line: number;
-    /** Stores the trimmed comment content without delimiters.
-     *
-     * Its characters correspond positionally to `offsets` and `ends`.
-     */
-    text: string;
-    /** Maps content characters to original UTF-16 start offsets.
-     *
-     * Whitespace trimming removes matching entries from this map.
-     */
-    offsets: number[];
-    /** Maps content characters to original UTF-16 end offsets.
-     *
-     * Entries preserve the source boundaries of the retained text.
-     */
-    ends: number[];
-    /** Covers the original comment syntax, including its delimiters.
-     *
-     * This range remains available even when trimming leaves no content.
-     */
-    range: IEvidenceSourceRange;
-    /** Marks a comment that follows structural code on the same line.
-     *
-     * Trailing comments never attach as leading documentation for the next
-     * declaration.
-     */
-    trailing: boolean;
-    /** Marks a comment discovered while scanner depth is zero.
-     *
-     * This distinguishes eligible file-level documentation from a detached run
-     * nested inside a schema block.
-     */
-    topLevel: boolean;
-}

package/lib/adapters/prisma/IPrismaSchemaFile.d.ts

@@ -1,22 +0,0 @@
-import type { IEvidenceSourceFile } from "../../structures/IEvidenceSourceFile";
-/** One deduplicated physical schema file and its parser-facing name.
- *
- * Parser-facing names provide stable schema-set references while the source
- * snapshot remains the owner of content, digest, and physical coordinates.
- */
-export interface IPrismaSchemaFile {
-    /**
-     * Unique normalized name supplied to the multi-file parser.
-     *
-     * The parser uses this stable schema-set key for cross-file resolution; it is
-     * derived independently of the source snapshot's physical filesystem path.
-     */
-    name: string;
-    /**
-     * Selected source snapshot represented by that parser-facing name.
-     *
-     * Its content enters the parser payload, while its digest and physical identity
-     * remain available for cache keys and later location materialization.
-     */
-    source: IEvidenceSourceFile;
-}

package/lib/adapters/prisma/ITrimmedMapping.d.ts

@@ -1,23 +0,0 @@
-/** Couples trimmed text with the coordinates of its retained characters.
- *
- * Prisma comment normalization uses this temporary value to remove surrounding
- * whitespace without severing the documentation text from its source offsets.
- */
-export interface ITrimmedMapping {
-    /** Contains the retained text after leading and trailing whitespace removal.
-     *
-     * An empty value has empty coordinate arrays.
-     */
-    text: string;
-    /** Maps each retained character to its original UTF-16 start offset.
-     *
-     * Entries align one-for-one with `text`.
-     */
-    offsets: number[];
-    /** Maps each retained character to its original UTF-16 end offset.
-     *
-     * Entries align with `offsets` and preserve the source span of every
-     * character.
-     */
-    ends: number[];
-}

package/lib/adapters/prisma/PrismaCommentForm.d.ts

@@ -1,7 +0,0 @@
-/**
- * Prisma comment syntax relevant to documentation attachment.
- *
- * The position scanner classifies comment runs with these forms before adapter
- * attachment determines whether they are eligible carriers for Evidence tags.
- */
-export type PrismaCommentForm = "doc" | "line" | "block";

package/lib/adapters/prisma/PrismaFileScanner.d.ts

@@ -1,70 +0,0 @@
-import type { IEvidenceSourceFile } from "../../structures/IEvidenceSourceFile";
-import type { IPrismaFileAnalysis } from "./IPrismaFileAnalysis";
-/** Locates physical Prisma declarations and documentation without parsing semantics.
- *
- * The whole-schema parser remains responsible for deciding which declarations
- * exist. This scanner supplies its source spans and comment-coordinate maps so
- * those semantic declarations can own accurate sites and documentation.
- */
-export declare class PrismaFileScanner {
-    private readonly source;
-    /** Holds raw source lines in scan order, preserving a final empty line.
-     *
-     * Parallel coordinate arrays translate each line's local positions back to
-     * the immutable source snapshot.
-     */
-    private readonly lines;
-    /** Stores the UTF-16 offset at which each source line begins.
-     *
-     * Missing defensive entries fall back to the source boundary when malformed
-     * line state is encountered.
-     */
-    private readonly lineStarts;
-    /** Stores the UTF-16 offset immediately after each line's content.
-     *
-     * Carriage returns are excluded because declaration ranges use content-only
-     * line boundaries.
-     */
-    private readonly lineEnds;
-    /** Stores the offset of each line's newline character or line terminus.
-     *
-     * Comment-run maps use these positions for newlines introduced between
-     * fragments on different source lines.
-     */
-    private readonly newlineOffsets;
-    /** Translates scanner offsets into Evidence source ranges.
-     *
-     * All locations and comment carriers use this one coordinate authority.
-     */
-    private readonly text;
-    /** Initializes line and coordinate indexes for one immutable source snapshot.
-     *
-     * The scanner borrows no parser session because it deliberately recognizes
-     * only structural Prisma positions and comments.
-     */
-    constructor(source: IEvidenceSourceFile);
-    /** Scans declaration positions and contiguous comment runs for the source.
-     *
-     * It flushes pending comments whenever syntax breaks adjacency, preserving
-     * detached carriers instead of attaching them to a later declaration.
-     */
-    scan(): IPrismaFileAnalysis;
-    /** Separates code from a line comment while carrying block-comment state.
-     *
-     * Quotes suppress comment delimiters so URL-like and escaped string content
-     * cannot alter declaration scanning or comment attachment.
-     */
-    private parts;
-    /** Converts pending fragments into attached and detached documentation runs.
-     *
-     * Ordinary or trailing line comments remain separate carriers, while
-     * non-trailing documentation forms are grouped for one eligible key.
-     */
-    private runs;
-    /** Builds one mapped run from source-order comment fragments.
-     *
-     * Explicit newline entries preserve a continuous documentation string even
-     * when adjacent source comments occur on different lines.
-     */
-    private run;
-}