@purestack/ts-format 0.0.0-stage → 1.1.24

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ahmed Yasin Koculu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,45 @@
-# Temporary Holding Version
+# @purestack/ts-format
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The shared PureStack formatter used by PureStack CLI and the VS Code extension.
+Formats component markup in MDX/RMDX and `html`/`svg` tagged templates in TypeScript.
+Markdown prose, frontmatter, code samples, expressions, and surrounding TypeScript
+are preserved. Biome handles the rest of the project's formatting.
+
+```ts
+import { formatSource } from '@purestack/ts-format'
+
+const result = await formatSource(source, { filePath: 'content/page.mdx' })
+// result.code, result.changed, result.edits, result.diagnostics
+```
+
+Options include `printWidth` (80), `tabSize` (2), `useTabs` (false), and an optional
+`onlyWithinRange` with UTF-16 source offsets. Edits refer to the original source.
+Line endings are preserved. Diagnostics identify markup that could not be formatted.
+
+For files and directories:
+
+```ts
+import { formatFiles } from '@purestack/ts-format/files'
+
+const result = await formatFiles(['content'], {
+  cwd: process.cwd(),
+  write: true,
+})
+// result.checked, result.changed, result.errors
+```
+
+File operations default to checking without writing, honor Git ignores for directory
+scans, skip symlinks and generated directories, and collect failures across files.
+A file with formatting errors is never written. `exclude` accepts additional file
+or directory paths relative to `cwd`. Without Git, directory scans still work and
+skip known output, dependency, and cache directories.
+
+From a PureStack project:
+
+```sh
+purestack format content --write
+purestack format content --check
+```
+
+In this repository, `yarn format:markup --write` formats PureStack markup only.
+`yarn format` runs Biome followed by this formatter; `yarn format:check` checks both.

package/dist/files.d.mts

@@ -0,0 +1,39 @@
+/*! @purestack/ts-format v1.1.24 | (c) 2026 Ahmed Yasin Koculu | MIT License */
+
+//#region packages/ts-format/src/html.d.ts
+interface HtmlFormattingOptions {
+  printWidth: number;
+  tabSize: number;
+  useTabs: boolean;
+}
+//#endregion
+//#region packages/ts-format/src/source.d.ts
+interface SourceRange {
+  start: number;
+  end: number;
+}
+interface FormatOptions extends Partial<HtmlFormattingOptions> {
+  filePath?: string;
+  language?: 'mdx' | 'typescript';
+  onlyWithinRange?: SourceRange;
+}
+//#endregion
+//#region packages/ts-format/src/files.d.ts
+export interface FormatFilesOptions extends Omit<FormatOptions, 'filePath' | 'language' | 'onlyWithinRange'> {
+  cwd?: string;
+  write?: boolean;
+  /** Files or directories to omit, relative to cwd. */
+  exclude?: readonly string[];
+}
+export interface FormatFileError {
+  filePath: string;
+  message: string;
+}
+/** Discover source files, honor Git ignores in repositories, and collect all failures. */
+export declare function formatFiles(inputs?: readonly string[], options?: FormatFilesOptions): Promise<{
+  checked: number;
+  changed: string[];
+  errors: FormatFileError[];
+}>;
+//#endregion
+//# sourceMappingURL=files.d.mts.map

package/dist/files.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.mts","names":[],"sources":["../src/html.ts","../src/source.ts","../src/files.ts"],"mappings":";UAsBiB;EACf;EACA;EACA;;;;UCvBe;EACf;EACA;;UAWe,sBAAsB,QAAQ;EAC7C;EACA;EACA,kBAAkB;;;;iBCSH,2BACP,KAAK;EACb;EACA;;EAEA;;iBAGe;EACf;EACA;;;wBAIoB,YACpB,4BACA,UAAS,qBAAuB"}