@stripe/extensibility-language-server 0.2.8 → 0.3.1

package/dist/plugin/declaration-tooltip-experiences.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Declaration-hover experiences layered on top of native TypeScript quick info.
+ *
+ * Each "experience" turns a single FormSpec fact category into one hover
+ * section so the plugin can mix and match them without hard-coding one giant
+ * formatter.
+ */
+import type * as tsServer from 'typescript/lib/tsserverlibrary.js';
+import type { FormSpecAnalysisCommentSnapshot } from '@formspec/ts-plugin';
+import type { TooltipSection, TooltipSurface } from './quick-info-composer.js';
+/**
+ * The declaration snapshot and native hover that synthesized sections can use.
+ *
+ * @internal
+ */
+export interface DeclarationTooltipContext {
+    readonly surface: TooltipSurface;
+    readonly comment: FormSpecAnalysisCommentSnapshot;
+    readonly baseQuickInfo: tsServer.QuickInfo | undefined;
+}
+/**
+ * Materialize all declaration-hover sections that apply to the current symbol.
+ *
+ * @internal
+ */
+export declare function getDeclarationTooltipSections(context: DeclarationTooltipContext): readonly TooltipSection[];
+//# sourceMappingURL=declaration-tooltip-experiences.d.ts.map

package/dist/plugin/declaration-tooltip-experiences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration-tooltip-experiences.d.ts","sourceRoot":"","sources":["../../src/plugin/declaration-tooltip-experiences.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,KAAK,QAAQ,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,EACV,+BAA+B,EAEhC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/E;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,+BAA+B,CAAC;IAClD,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;CACxD;AA4BD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,yBAAyB,GACjC,SAAS,cAAc,EAAE,CAK3B"}

package/dist/plugin/display-parts.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Shared helpers for building tsserver display-part arrays.
+ *
+ * The plugin emits the same `SymbolDisplayPart` shape that native TypeScript
+ * hovers use so that editors preserve their standard rendering pipeline.
+ */
+import type * as tsServer from 'typescript/lib/tsserverlibrary.js';
+/**
+ * Wrap plain text as a one-part display block.
+ *
+ * @internal
+ */
+export declare function toDisplayParts(text: string, kind?: string): tsServer.SymbolDisplayPart[];
+/**
+ * Create a single display part with the requested tsserver kind.
+ *
+ * @internal
+ */
+export declare function toDisplayPart(text: string, kind?: string): tsServer.SymbolDisplayPart;
+/**
+ * Treat empty strings as no content so callers can compose blocks safely.
+ *
+ * @internal
+ */
+export declare function hasDisplayPartsContent(parts: readonly tsServer.SymbolDisplayPart[] | undefined): boolean;
+/**
+ * Join documentation blocks with blank lines while skipping empty sections.
+ *
+ * @internal
+ */
+export declare function joinDisplayPartBlocks(blocks: readonly (readonly tsServer.SymbolDisplayPart[] | undefined)[]): tsServer.SymbolDisplayPart[];
+//# sourceMappingURL=display-parts.d.ts.map

package/dist/plugin/display-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-parts.d.ts","sourceRoot":"","sources":["../../src/plugin/display-parts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,KAAK,QAAQ,MAAM,mCAAmC,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,SAAS,GACZ,QAAQ,CAAC,iBAAiB,EAAE,CAE9B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAS,GAAG,QAAQ,CAAC,iBAAiB,CAKrF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,QAAQ,CAAC,iBAAiB,EAAE,GAAG,SAAS,GACvD,OAAO,CAET;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,CAAC,SAAS,QAAQ,CAAC,iBAAiB,EAAE,GAAG,SAAS,CAAC,EAAE,GACrE,QAAQ,CAAC,iBAAiB,EAAE,CAkB9B"}

package/dist/plugin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,QAAQ,MAAM,mCAAmC,CAAC;AAiGnE;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,QAAQ,CAAC;CACtC,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,CAW/B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,KAAK,QAAQ,MAAM,mCAAmC,CAAC;AAo1BnE;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,QAAQ,CAAC;CACtC,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,CAiB/B"}

package/dist/plugin/quick-info-composer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Hover composition helpers for merging native tsserver quick info with
+ * additional FormSpec-authored sections.
+ */
+import type * as tsServer from 'typescript/lib/tsserverlibrary.js';
+/** @internal */
+export type TooltipSurface = 'declaration-hover';
+/**
+ * A synthesized documentation block to splice around native hover content.
+ *
+ * @internal
+ */
+export interface TooltipSection {
+    readonly placement: 'before-docs' | 'after-docs';
+    readonly documentation: readonly tsServer.SymbolDisplayPart[];
+    readonly suppressTagNames?: readonly string[];
+}
+/**
+ * Inputs for hover composition.
+ *
+ * @internal
+ */
+export interface ComposeQuickInfoOptions {
+    readonly typescript: typeof tsServer;
+    readonly position: number;
+    readonly baseQuickInfo: tsServer.QuickInfo | undefined;
+    readonly sections: readonly TooltipSection[];
+    readonly fallbackDocumentation?: readonly tsServer.SymbolDisplayPart[];
+    readonly fallbackDisplayParts?: readonly tsServer.SymbolDisplayPart[];
+}
+/**
+ * Preserve native TypeScript quick info when available, and only synthesize a
+ * standalone hover when FormSpec has something useful to add on its own.
+ *
+ * @internal
+ */
+export declare function composeQuickInfo(options: ComposeQuickInfoOptions): tsServer.QuickInfo | undefined;
+//# sourceMappingURL=quick-info-composer.d.ts.map

package/dist/plugin/quick-info-composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-info-composer.d.ts","sourceRoot":"","sources":["../../src/plugin/quick-info-composer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,KAAK,QAAQ,MAAM,mCAAmC,CAAC;AAOnE,gBAAgB;AAChB,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,YAAY,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,SAAS,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAC9D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,OAAO,QAAQ,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IACvE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,QAAQ,CAAC,iBAAiB,EAAE,CAAC;CACvE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,GAC/B,QAAQ,CAAC,SAAS,GAAG,SAAS,CAwDhC"}