@purestack/ts-format 0.0.0-stage → 1.1.24

package/dist/ts-format.d.mts

@@ -0,0 +1,178 @@
+/*! @purestack/ts-format v1.1.24 | (c) 2026 Ahmed Yasin Koculu | MIT License */
+
+import * as TypeScript from "typescript-parser";
+//#region packages/ts-format/src/html.d.ts
+export interface HtmlFormattingOptions {
+  printWidth: number;
+  tabSize: number;
+  useTabs: boolean;
+}
+export declare function formatHtmlFragment(source: string, options: HtmlFormattingOptions): Promise<string>;
+/** Keep closing tags readable without inserting whitespace into inline content. */
+export declare function normalizeClosingTagSpacing(source: string): string;
+export declare function getLineIndent(line: string): string;
+export declare function normalizeSelfClosingTagSpacing(formatted: string): string;
+//#endregion
+//#region packages/ts-format/src/source.d.ts
+export interface SourceRange {
+  start: number;
+  end: number;
+}
+export interface SourceEdit extends SourceRange {
+  newText: string;
+}
+export interface FormatDiagnostic extends SourceRange {
+  message: string;
+}
+export interface FormatOptions extends Partial<HtmlFormattingOptions> {
+  filePath?: string;
+  language?: 'mdx' | 'typescript';
+  onlyWithinRange?: SourceRange;
+}
+export declare function intersects(left: SourceRange, right: SourceRange): boolean;
+/** Immutable source snapshot. All edit offsets refer to this text. */
+export declare class SourceText {
+  readonly text: string;
+  readonly filePath: string;
+  readonly options: HtmlFormattingOptions;
+  readonly diagnostics: FormatDiagnostic[];
+  private readonly lines;
+  private readonly eol;
+  constructor(text: string, options?: FormatOptions);
+  get lineCount(): number;
+  lineAt(line: number): {
+    text: string;
+    range: SourceRange;
+  };
+  positionAt(offset: number): {
+    line: number;
+    character: number;
+  };
+  offsetAt(position: {
+    line: number;
+    character: number;
+  }): number;
+  preserveEol(text: string): string;
+  report(range: SourceRange, error: unknown): void;
+}
+/** Apply non-overlapping edits against their original snapshot. */
+export declare function applySourceEdits(source: string, edits: readonly SourceEdit[]): string;
+//#endregion
+//#region packages/ts-format/src/expressions.d.ts
+interface RegorExpressionPlaceholder {
+  placeholder: string;
+  source: string;
+}
+/**
+ * Protects Regor {{ ... }} expressions while the surrounding markup is
+ * formatted as HTML. The expression source is restored byte-for-byte.
+ */
+export declare function maskRegorExpressions(source: string): {
+  expressions: RegorExpressionPlaceholder[];
+  placeholderContent: string;
+};
+export declare function restoreRegorExpressions(formatted: string, expressions: RegorExpressionPlaceholder[]): string;
+//#endregion
+//#region packages/ts-format/src/fences.d.ts
+export interface MdxFencePlaceholder {
+  placeholder: string;
+  source: string;
+}
+export interface MdxFence {
+  length: number;
+  marker: '`' | '~';
+}
+export interface MdxFenceDelimiter extends MdxFence {
+  suffix: string;
+}
+export interface MdxFenceDelimiterEditOptions {
+  onlyWithinRange?: SourceRange;
+}
+export declare function buildMdxFenceDelimiterEdits(document: SourceText, excludedRanges: SourceRange[], options?: MdxFenceDelimiterEditOptions): {
+  start: number;
+  end: number;
+  newText: string;
+}[];
+export declare function maskMdxFencedRegions(source: string): {
+  fences: MdxFencePlaceholder[];
+  placeholderContent: string;
+};
+export declare function restoreMdxFencedRegions(formatted: string, fences: MdxFencePlaceholder[]): string;
+export declare function parseMdxFenceDelimiter(trimmed: string): MdxFenceDelimiter | undefined;
+export declare function parseInlineMdxFenceOpener(trimmed: string): MdxFenceDelimiter | undefined;
+export declare function parseInlineMdxFenceCloser(trimmed: string, activeFence: MdxFence): MdxFenceDelimiter | undefined;
+export declare function isMdxFenceClosingDelimiter(delimiter: MdxFenceDelimiter, activeFence: MdxFence): boolean;
+//#endregion
+//#region packages/ts-format/src/markup.d.ts
+export declare const VOID_HTML_TAG_NAMES: Set<string>;
+export interface TagToken {
+  end: number;
+  kind: 'closing' | 'opening';
+  name: string;
+  nameEnd: number;
+  nameStart: number;
+  selfClosing: boolean;
+  start: number;
+}
+export declare function scanTagTokens(markup: string): TagToken[];
+export declare function isMdxExpressionStart(source: string, index: number): boolean;
+export declare function findMdxExpressionEnd(source: string, startIndex: number): number;
+export declare function findTagEnd(markup: string, startIndex: number): number;
+//#endregion
+//#region packages/ts-format/src/mdx.d.ts
+export interface MdxMarkupBlock {
+  content: string;
+  range: SourceRange;
+}
+interface MdxExpressionPlaceholder {
+  placeholder: string;
+  source: string;
+}
+interface MdxFormattingRequest {
+  onlyWithinRange?: SourceRange;
+}
+interface MdxMarkupBlockOptions {
+  includeIncomplete?: boolean;
+}
+export declare function buildMdxFormattingEdits(document: SourceText, request?: MdxFormattingRequest): Promise<SourceEdit[]>;
+export declare function getMdxMarkupBlocks(document: SourceText, options?: MdxMarkupBlockOptions): MdxMarkupBlock[];
+export declare function maskMdxExpressions(source: string): {
+  expressions: MdxExpressionPlaceholder[];
+  placeholderContent: string;
+};
+//#endregion
+//#region packages/ts-format/src/templates.d.ts
+export type SupportedTemplateTagName = 'html' | 'svg';
+export interface SupportedTaggedTemplate {
+  content: string;
+  contentRange: SourceRange;
+  expressions: TemplateExpressionPlaceholder[];
+  interpolationRanges: Array<{
+    start: number;
+    end: number;
+  }>;
+  placeholderContent: string;
+  tagName: SupportedTemplateTagName;
+}
+interface TemplateExpressionPlaceholder {
+  placeholder: string;
+  source: string;
+}
+interface TemplateFormattingRequest {
+  onlyWithinRange?: SourceRange;
+}
+export declare function buildTemplateFormattingEdits(document: SourceText, request?: TemplateFormattingRequest): Promise<SourceEdit[]>;
+export declare function getSupportedTaggedTemplates(document: SourceText): SupportedTaggedTemplate[];
+export declare function isOffsetInsideSupportedTaggedTemplate(sourceFile: TypeScript.SourceFile, offset: number): boolean;
+//#endregion
+//#region packages/ts-format/src/index.d.ts
+/** Formats only component markup and html/svg tagged template contents. */
+export declare function formatSource(text: string, options?: FormatOptions): Promise<{
+  code: string;
+  edits: SourceEdit[];
+  diagnostics: FormatDiagnostic[];
+  changed: boolean;
+}>;
+//#endregion
+export type { RegorExpressionPlaceholder };
+//# sourceMappingURL=ts-format.d.mts.map

package/dist/ts-format.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-format.d.mts","names":["_$__source0.SourceEdit","_$__source0.FormatDiagnostic"],"sources":["../src/html.ts","../src/source.ts","../src/expressions.ts","../src/fences.ts","../src/markup.ts","../src/mdx.ts","../src/templates.ts","../src/index.ts"],"mappings":";;iBAsBiB;EACf;EACA;EACA;;wBAGoB,mBACpB,gBACA,SAAS,wBAAqB;;wBAchB,2BAA2B;wBAQ3B,cAAc;wBAKd,+BAA+B;;;iBCvD9B;EACf;EACA;;iBAGe,mBAAmB;EAClC;;iBAGe,yBAAyB;EACxC;;iBAGe,sBAAsB,QAAQ;EAC7C;EACA;EACA,kBAAkB;;wBAGJ,WAAW,MAAM,aAAa,OAAO;;qBAKxC;WAQA;WAPF;WACA,SAAS;WACT,aAAa;mBACL;mBACA;EAEjB,YACW,cACT,UAAS;MAwBP;EAIJ,OAAO;IAjC+B;IAAe,OAAA;;EAqCrD,WAAW;IAWP;IACA;;EAIJ,SAAS;IAAY;IAAc;;EASnC,YAAY;EAIZ,OAAO,OAAO,aAAa;;;wBASb,iBAAiB,gBAAgB,gBAAgB;;;UCvGhD;EACf;EACA;;;;;;wBAOc,qBAAqB;eAArB;;;wBA8BA,wBACd,mBACA,aAAa;;;iBCnCE;EACf;EACA;;iBAGe;EACf;EACA;;iBAGe,0BAA0B;EACzC;;iBAGe;EACf,kBAAkB;;wBAGJ,4BACd,UAAU,YACV,gBAAgB,eAChB,UAAS;;;;;wBA+GK,qBAAqB;UAArB;;;wBAiDA,wBACd,mBACA,QAAQ;wBAoBM,uBACd,kBACC;wBAWa,0BAA0B,kBAAe;wBAOzC,0BACd,iBACA,aAAa,WAAQ;wBAcP,2BACd,WAAW,mBACX,aAAa;;;qBCzPF,qBAAmB;iBAiBf;EACf;EACA;EACA;EACA;EACA;EACA;EACA;;wBAGc,cAAc,iBAAc;wBAsC5B,qBAAqB,gBAAgB;wBAQrC,qBAAqB,gBAAgB;wBA2CrC,WAAW,gBAAgB;;;iBC3F1B;EACf;EACA,OAAO;;UAGC;EACR;EACA;;UAQQ;EACR,kBAAkB;;UAGV;EACR;;wBAcoB,wBACpB,UAAU,YACV,UAAS,uBAAyB,QAAA;wBA6BpB,mBACd,UAAU,YACV,UAAS,wBAA0B;wBA4MrB,mBAAmB;eAAnB;;;;;YC5RJ;iBAEK;EACf;EACA,cAAc;EACd,aAAa;EACb,qBAAqB;IAAQ;IAAe;;EAC5C;EACA,SAAS;;UAGD;EACR;EACA;;UAKQ;EACR,kBAAkB;;wBAGE,6BACpB,UAAU,YACV,UAAS,4BAA8B,QAAA;wBAwBzB,4BACd,UAAU,aACT;wBA4Ba,sCACd,YAAY,WAAW,YACvB;;;;wBC3EoB,aAAa,cAAc,UAAS,gBAAkB;;SAAlBA"}