@wrtnlabs/evidence 0.0.0

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

@@ -0,0 +1,21 @@
+/** 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/IPrismaBlockHead.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,22 @@
+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/IPrismaCacheEntry.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,51 @@
+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/IPrismaCommentRun.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,15 @@
+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/IPrismaDatamodel.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,26 @@
+/** 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/IPrismaDatamodelField.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,29 @@
+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/IPrismaDatamodelModel.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,36 @@
+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/IPrismaField.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,31 @@
+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/IPrismaFileAnalysis.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,26 @@
+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/IPrismaLineParts.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,22 @@
+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/IPrismaLoadResult.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,20 @@
+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/IPrismaLocatedDeclaration.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,22 @@
+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/IPrismaLocation.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,36 @@
+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/IPrismaModel.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,37 @@
+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/IPrismaOwnedUnit.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,28 @@
+/** 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/IPrismaParser.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,52 @@
+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/IPrismaPendingComment.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,22 @@
+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/IPrismaSchemaFile.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,23 @@
+/** 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/ITrimmedMapping.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,7 @@
+/**
+ * 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/PrismaCommentForm.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });