@formspec/analysis 0.1.0-alpha.20

package/dist/comment-syntax.d.ts

@@ -0,0 +1,43 @@
+import type { PathTarget } from "@formspec/core";
+import { type ExtensionTagSource } from "./tag-registry.js";
+export interface CommentSourceSpan {
+    readonly start: number;
+    readonly end: number;
+}
+export type CommentSpan = CommentSourceSpan;
+export interface ParsedCommentTargetSpecifier {
+    readonly rawText: string;
+    readonly valid: boolean;
+    readonly kind: "path" | "member" | "variant" | "ambiguous";
+    readonly fullSpan: CommentSourceSpan;
+    readonly colonSpan: CommentSourceSpan;
+    readonly span: CommentSourceSpan;
+    readonly path: PathTarget | null;
+}
+export interface ParsedCommentTag {
+    readonly rawTagName: string;
+    readonly normalizedTagName: string;
+    readonly recognized: boolean;
+    readonly fullSpan: CommentSourceSpan;
+    readonly tagNameSpan: CommentSourceSpan;
+    readonly payloadSpan: CommentSourceSpan | null;
+    readonly colonSpan: CommentSourceSpan | null;
+    readonly target: ParsedCommentTargetSpecifier | null;
+    readonly argumentSpan: CommentSourceSpan | null;
+    readonly argumentText: string;
+}
+export interface ParsedCommentBlock {
+    readonly commentText: string;
+    readonly offset: number;
+    readonly tags: readonly ParsedCommentTag[];
+}
+export interface ParseCommentSyntaxOptions {
+    readonly offset?: number;
+    readonly extensions?: readonly ExtensionTagSource[];
+}
+export declare function parseCommentBlock(commentText: string, options?: ParseCommentSyntaxOptions): ParsedCommentBlock;
+export declare function parseTagSyntax(rawTagName: string, payloadText: string, options?: Omit<ParseCommentSyntaxOptions, "offset">): ParsedCommentTag;
+export declare function sliceCommentSpan(commentText: string, span: CommentSpan, options?: {
+    readonly offset?: number;
+}): string;
+//# sourceMappingURL=comment-syntax.d.ts.map

package/dist/comment-syntax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-syntax.d.ts","sourceRoot":"","sources":["../src/comment-syntax.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAE5C,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CAClC;AAMD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACrD,QAAQ,CAAC,YAAY,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC5C;AA0LD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACrD;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,yBAAyB,GAClC,kBAAkB,CA4FpB;AACD,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,QAAQ,CAAC,GAClD,gBAAgB,CAQlB;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC,MAAM,CAGR"}

package/dist/compiler-signatures.d.ts

@@ -0,0 +1,100 @@
+import { type ExtensionTagSource, type FormSpecPlacement, type TagDefinition, type TagSignature } from "./tag-registry.js";
+/**
+ * Target kinds that can be represented in a synthetic compiler call.
+ *
+ * This intentionally excludes `"none"`, because a missing target is modeled by
+ * omitting the synthetic target argument entirely.
+ */
+export type SyntheticTagTargetKind = "path" | "member" | "variant";
+/**
+ * A normalized target argument that can be lowered into a synthetic helper
+ * call for compiler-backed validation.
+ */
+export interface SyntheticTagTargetSpecifier {
+    readonly kind: SyntheticTagTargetKind;
+    readonly text: string;
+}
+/**
+ * Inputs required to lower a parsed FormSpec tag into a synthetic TypeScript
+ * helper call.
+ *
+ * `hostType` and `subjectType` are trusted snippets of TypeScript type syntax
+ * supplied by the caller. They are embedded into an in-memory synthetic source
+ * file and are never executed.
+ */
+export interface LowerSyntheticTagApplicationOptions {
+    readonly tagName: string;
+    readonly placement: FormSpecPlacement;
+    readonly hostType: string;
+    readonly subjectType: string;
+    readonly target?: SyntheticTagTargetSpecifier | null;
+    readonly argumentExpression?: string | null;
+    readonly extensions?: readonly ExtensionTagSource[];
+}
+/**
+ * Result of lowering a tag application into the synthetic call representation
+ * used for compiler-backed validation.
+ */
+export interface LoweredSyntheticTagApplication {
+    readonly definition: TagDefinition;
+    readonly matchingSignatures: readonly TagSignature[];
+    readonly callExpression: string;
+}
+/**
+ * A simplified TypeScript diagnostic surfaced from the synthetic compiler pass.
+ */
+export interface SyntheticCompilerDiagnostic {
+    readonly code: number;
+    readonly message: string;
+}
+/**
+ * Options for running the TypeScript checker against a synthetic tag call.
+ */
+export interface CheckSyntheticTagApplicationOptions extends LowerSyntheticTagApplicationOptions {
+    readonly supportingDeclarations?: readonly string[];
+}
+/**
+ * Result of checking a lowered synthetic tag application with the TypeScript
+ * compiler.
+ */
+export interface SyntheticTagCheckResult {
+    readonly sourceText: string;
+    readonly diagnostics: readonly SyntheticCompilerDiagnostic[];
+}
+/**
+ * Filters a tag definition's overloads down to the ones that apply to the
+ * requested placement and synthetic target form.
+ *
+ * This is the overload-selection primitive used by both the lowering phase
+ * and cursor-aware tooling that wants to show only the currently-applicable
+ * signatures for a tag.
+ */
+export declare function getMatchingTagSignatures(definition: TagDefinition, placement: FormSpecPlacement, targetKind: SyntheticTagTargetKind | null): readonly TagSignature[];
+/**
+ * Builds the synthetic helper declarations used to validate FormSpec tag
+ * applications through the TypeScript checker.
+ *
+ * The returned string is a virtual `.d.ts`-style prelude that declares the
+ * `__formspec.*` helper namespace together with context, path, member, and
+ * variant helper types. It is intended to be embedded into an in-memory
+ * TypeScript program, never emitted to disk.
+ */
+export declare function buildSyntheticHelperPrelude(extensions?: readonly ExtensionTagSource[]): string;
+/**
+ * Lowers a normalized tag application into a synthetic helper call.
+ *
+ * The caller is responsible for supplying trusted `hostType` and `subjectType`
+ * snippets that are valid TypeScript type syntax in the generated synthetic
+ * program. This function does not sanitize those snippets; it only assembles
+ * the helper call and selects the matching overload metadata.
+ */
+export declare function lowerTagApplicationToSyntheticCall(options: LowerSyntheticTagApplicationOptions): LoweredSyntheticTagApplication;
+/**
+ * Runs the TypeScript checker against a lowered synthetic tag application.
+ *
+ * This is the compiler-backed validation entrypoint used by FormSpec analysis
+ * to verify placement, target binding, and argument compatibility without
+ * requiring comment tags themselves to be valid TypeScript syntax.
+ */
+export declare function checkSyntheticTagApplication(options: CheckSyntheticTagApplicationOptions): SyntheticTagCheckResult;
+//# sourceMappingURL=compiler-signatures.d.ts.map

package/dist/compiler-signatures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler-signatures.d.ts","sourceRoot":"","sources":["../src/compiler-signatures.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EAEtB,KAAK,aAAa,EAClB,KAAK,YAAY,EAElB,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAC;IACrD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACrD;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,YAAY,EAAE,CAAC;IACrD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mCAAoC,SAAQ,mCAAmC;IAC9F,QAAQ,CAAC,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrD;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC9D;AAuOD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,aAAa,EACzB,SAAS,EAAE,iBAAiB,EAC5B,UAAU,EAAE,sBAAsB,GAAG,IAAI,GACxC,SAAS,YAAY,EAAE,CAKzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,CAAC,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,CAW9F;AAED;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,mCAAmC,GAC3C,8BAA8B,CAsChC;AA2CD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mCAAmC,GAC3C,uBAAuB,CAqCzB"}

package/dist/cursor-context.d.ts

@@ -0,0 +1,89 @@
+import { type ParsedCommentBlock, type ParsedCommentTag } from "./comment-syntax.js";
+import type * as ts from "typescript";
+import { type ExtensionTagSource, type FormSpecPlacement, type FormSpecTargetKind, type TagDefinition, type TagSignature } from "./tag-registry.js";
+export interface EnclosingDocComment {
+    readonly text: string;
+    readonly start: number;
+    readonly end: number;
+    readonly parsed: ParsedCommentBlock;
+}
+export interface CommentCursorTarget {
+    readonly kind: "tag-name" | "colon" | "target" | "argument";
+    readonly tag: ParsedCommentTag;
+}
+export type CommentCompletionContext = {
+    readonly kind: "tag-name";
+    readonly prefix: string;
+} | {
+    readonly kind: "target";
+    readonly tag: ParsedCommentTag;
+} | {
+    readonly kind: "argument";
+    readonly tag: ParsedCommentTag;
+} | {
+    readonly kind: "none";
+};
+export interface CommentSemanticContextOptions {
+    readonly extensions?: readonly ExtensionTagSource[];
+    readonly placement?: FormSpecPlacement | null;
+    readonly checker?: ts.TypeChecker;
+    readonly subjectType?: ts.Type;
+}
+export interface CommentTagSemanticContext {
+    readonly tag: ParsedCommentTag;
+    readonly tagDefinition: TagDefinition | null;
+    readonly placement: FormSpecPlacement | null;
+    readonly signatures: readonly TagSignature[];
+    readonly supportedTargets: readonly FormSpecTargetKind[];
+    readonly targetCompletions: readonly string[];
+    readonly compatiblePathTargets: readonly string[];
+    readonly valueLabels: readonly string[];
+    readonly tagHoverMarkdown: string | null;
+    readonly targetHoverMarkdown: string | null;
+    readonly argumentHoverMarkdown: string | null;
+}
+export type SemanticCommentCompletionContext = {
+    readonly kind: "tag-name";
+    readonly prefix: string;
+    readonly availableTags: readonly TagDefinition[];
+} | {
+    readonly kind: "target";
+    readonly semantic: CommentTagSemanticContext;
+} | {
+    readonly kind: "argument";
+    readonly semantic: CommentTagSemanticContext;
+    readonly valueLabels: readonly string[];
+} | {
+    readonly kind: "none";
+};
+export interface CommentHoverInfo {
+    readonly kind: "tag-name" | "target" | "argument";
+    readonly markdown: string;
+}
+export declare function getCommentTagSemanticContext(tag: ParsedCommentTag, options?: CommentSemanticContextOptions): CommentTagSemanticContext;
+export declare function findEnclosingDocComment(documentText: string, offset: number, options?: {
+    readonly extensions?: readonly ExtensionTagSource[];
+}): EnclosingDocComment | null;
+export declare function findCommentTagAtOffset(documentText: string, offset: number, options?: {
+    readonly extensions?: readonly ExtensionTagSource[];
+}): ParsedCommentTag | null;
+export declare function getCommentCursorTargetAtOffset(documentText: string, offset: number, options?: {
+    readonly extensions?: readonly ExtensionTagSource[];
+}): CommentCursorTarget | null;
+export declare function getTagCompletionPrefixAtOffset(documentText: string, offset: number): string | null;
+export declare function getCommentCompletionContextAtOffset(documentText: string, offset: number, options?: {
+    readonly extensions?: readonly ExtensionTagSource[];
+}): CommentCompletionContext;
+/**
+ * Resolves the completion context at a document offset, upgrading syntax-only
+ * results with placement/type-aware semantics when TypeScript binding data is
+ * available.
+ */
+export declare function getSemanticCommentCompletionContextAtOffset(documentText: string, offset: number, options?: CommentSemanticContextOptions): SemanticCommentCompletionContext;
+/**
+ * Returns hover information for the comment token under the given document
+ * offset, including semantic target/argument help when binding data is
+ * available.
+ */
+export declare function getCommentHoverInfoAtOffset(documentText: string, offset: number, options?: CommentSemanticContextOptions): CommentHoverInfo | null;
+//# sourceMappingURL=cursor-context.d.ts.map

package/dist/cursor-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-context.d.ts","sourceRoot":"","sources":["../src/cursor-context.ts"],"names":[],"mappings":"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"}

package/dist/file-snapshots.d.ts

@@ -0,0 +1,18 @@
+import * as ts from "typescript";
+import { type FormSpecAnalysisFileSnapshot } from "./semantic-protocol.js";
+import type { ExtensionTagSource } from "./tag-registry.js";
+/**
+ * Options used when building a serializable, editor-oriented snapshot for a
+ * TypeScript source file.
+ */
+export interface BuildFormSpecAnalysisFileSnapshotOptions {
+    readonly checker: ts.TypeChecker;
+    readonly extensions?: readonly ExtensionTagSource[];
+}
+/**
+ * Builds a transport-safe snapshot of every FormSpec-bearing doc comment in a
+ * source file, including semantic hover/completion context and file-local
+ * diagnostics.
+ */
+export declare function buildFormSpecAnalysisFileSnapshot(sourceFile: ts.SourceFile, options: BuildFormSpecAnalysisFileSnapshotOptions): FormSpecAnalysisFileSnapshot;
+//# sourceMappingURL=file-snapshots.d.ts.map

package/dist/file-snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-snapshots.d.ts","sourceRoot":"","sources":["../src/file-snapshots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAQjC,OAAO,EAKL,KAAK,4BAA4B,EAClC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,kBAAkB,EAAqB,MAAM,mBAAmB,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACrD;AA6ND;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,OAAO,EAAE,wCAAwC,GAChD,4BAA4B,CAkE9B"}