sveld 0.34.1 → 0.35.0

package/lib/writer/Writer.d.ts

@@ -1,70 +1,36 @@
-import { type ParserOptions } from "prettier";
-export declare const DEFAULT_TYPESCRIPT_PRINT_WIDTH = 80;
 /**
- * Options for configuring a Writer instance.
+ * Base writer class for file system operations.
  *
- * Extends Prettier's ParserOptions with parser and printWidth settings.
- */
-interface WriterOptions extends Pick<ParserOptions, "parser" | "printWidth"> {
-}
-/**
- * Base writer class for formatting and writing files.
- *
- * Handles file formatting using Prettier and file system operations.
- * Automatically creates directories as needed and formats content
- * before writing.
+ * Automatically creates directories as needed before writing.
  *
  * @example
  * ```ts
- * const writer = new Writer({ parser: "typescript", printWidth: 80 });
+ * const writer = new Writer();
  * await writer.write("./dist/index.d.ts", "export type Props = {};");
  * ```
  */
 export default class Writer {
-    options: WriterOptions;
-    /**
-     * Creates a new Writer instance.
-     *
-     * @param options - Writer configuration options
-     */
-    constructor(options: WriterOptions);
-    /**
-     * Formats raw content using Prettier.
-     *
-     * Applies formatting based on the configured parser and print width.
-     * Returns the original content if formatting fails.
-     *
-     * @param raw - The raw content to format
-     * @returns Formatted content, or original content if formatting fails
-     *
-     * @example
-     * ```ts
-     * const formatted = await writer.format("export type Props={}");
-     * // Returns: "export type Props = {};\n"
-     * ```
-     */
-    format(raw: string): Promise<string>;
     /**
-     * Writes formatted content to a file.
+     * Writes content to a file.
      *
-     * Creates the directory structure if needed, formats the content,
-     * and writes it to the specified file path.
+     * Creates the directory structure if needed, then writes the content
+     * to the specified file path.
      *
      * @param filePath - The path where the file should be written
-     * @param raw - The raw content to format and write
+     * @param raw - The content to write
      *
      * @example
      * ```ts
      * await writer.write("./dist/index.d.ts", "export type Props={}");
-     * // Creates ./dist/index.d.ts with formatted content
+     * // Creates ./dist/index.d.ts with the given content
      * ```
      */
     write(filePath: string, raw: string): Promise<void>;
 }
 /**
- * Creates a Writer instance configured for JSON files.
+ * Creates a Writer instance for JSON files.
  *
- * @returns A Writer instance with JSON parser and 80 character print width
+ * @returns A Writer instance
  *
  * @example
  * ```ts
@@ -74,10 +40,9 @@ export default class Writer {
  */
 export declare function createJsonWriter(): Writer;
 /**
- * Creates a Writer instance configured for TypeScript files.
+ * Creates a Writer instance for TypeScript files.
  *
- * @param printWidth - Prettier print width for emitted TypeScript files
- * @returns A Writer instance with TypeScript parser and 80 character print width by default
+ * @returns A Writer instance
  *
  * @example
  * ```ts
@@ -85,5 +50,4 @@ export declare function createJsonWriter(): Writer;
  * await writer.write("index.d.ts", "export type Props={};");
  * ```
  */
-export declare function createTypeScriptWriter(printWidth?: number): Writer;
-export {};
+export declare function createTypeScriptWriter(): Writer;

package/lib/writer/WriterMarkdown.d.ts

@@ -6,7 +6,7 @@ interface MarkdownOptions {
 }
 export type { AppendType };
 /**
- * Markdown writer with Prettier formatting and optional append callbacks.
+ * Markdown writer with optional append callbacks.
  *
  * @example
  * ```ts

package/lib/writer/format-generated-ts.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Reformats generator-emitted `.d.ts` source for consistent indentation and
+ * spacing, without depending on an external formatter. This is a structural
+ * cleanup pass (bracket-depth reindentation, blank-line normalization) rather
+ * than a full TypeScript printer — it does not wrap long lines or rewrite
+ * operator spacing.
+ */
+export declare function formatGeneratedTypeScript(raw: string): string;

package/lib/writer/writer-custom-elements-core.d.ts

@@ -0,0 +1,86 @@
+import type { DeprecatedValue } from "../ComponentParser";
+import type { ComponentDocApi, ComponentDocs } from "../plugin";
+/**
+ * Minimal local subset of the published Custom Elements Manifest schema
+ * (schemaVersion "1.0.0") for the fields sveld can populate. See
+ * https://github.com/webcomponents/custom-elements-manifest for the full spec.
+ */
+export interface CemType {
+    text: string;
+}
+export interface CemClassField {
+    kind: "field";
+    name: string;
+    type?: CemType;
+    default?: string;
+    description?: string;
+    deprecated?: DeprecatedValue;
+}
+export interface CemAttribute {
+    name: string;
+    fieldName: string;
+    type?: CemType;
+    default?: string;
+    description?: string;
+}
+export interface CemEvent {
+    name: string;
+    type: CemType;
+    description?: string;
+    deprecated?: DeprecatedValue;
+}
+export interface CemSlot {
+    name: string;
+    description?: string;
+    deprecated?: DeprecatedValue;
+}
+export interface CemClassDeclaration {
+    kind: "class";
+    name: string;
+    description?: string;
+    members: CemClassField[];
+    attributes: CemAttribute[];
+    events: CemEvent[];
+    slots: CemSlot[];
+    /** Only present when the source component sets `<svelte:options customElement="..." />`. */
+    tagName?: string;
+    /** Only present when the source component sets `<svelte:options customElement="..." />`. */
+    customElement?: true;
+}
+export interface CemJavaScriptExport {
+    kind: "js";
+    name: string;
+    declaration: {
+        name: string;
+        module: string;
+    };
+}
+export interface CemCustomElementExport {
+    kind: "custom-element-definition";
+    name: string;
+    declaration: {
+        name: string;
+        module: string;
+    };
+}
+export type CemExport = CemJavaScriptExport | CemCustomElementExport;
+export interface CemModule {
+    kind: "javascript-module";
+    path: string;
+    declarations: CemClassDeclaration[];
+    exports: CemExport[];
+}
+export interface CustomElementsManifest {
+    schemaVersion: "1.0.0";
+    modules: CemModule[];
+}
+export interface BuildCustomElementsManifestOptions {
+    /** Resolves each component's manifest `path`. Defaults to the component's `filePath` as-is. */
+    resolveModulePath?: (component: ComponentDocApi) => string;
+}
+/**
+ * Builds a Custom Elements Manifest (schemaVersion "1.0.0") in memory, with
+ * no file-system or `node:*` dependency so it can run in the browser (e.g.
+ * the playground).
+ */
+export declare function buildCustomElementsManifest(components: ComponentDocs, options?: BuildCustomElementsManifestOptions): CustomElementsManifest;

package/lib/writer/writer-custom-elements.d.ts

@@ -0,0 +1,15 @@
+import type { ComponentDocs } from "../plugin";
+export type { CemAttribute, CemClassDeclaration, CemClassField, CemCustomElementExport, CemEvent, CemExport, CemJavaScriptExport, CemModule, CemSlot, CemType, CustomElementsManifest, } from "./writer-custom-elements-core";
+export interface WriteCustomElementsOptions {
+    inputDir: string;
+    outFile: string;
+}
+/**
+ * Writes component documentation as a Custom Elements Manifest
+ * (schemaVersion "1.0.0"). Components without a `customElementTag` (i.e. not
+ * compiled with `<svelte:options customElement="..." />`) still emit a plain
+ * class declaration; the manifest is most useful for `customElement`-compiled
+ * builds, where editors, Storybook, and other CEM-aware tooling can resolve
+ * `tagName`, `attributes`, and `events`.
+ */
+export default function writeCustomElements(components: ComponentDocs, options: WriteCustomElementsOptions): Promise<void>;

package/lib/writer/writer-ts-definitions-core.d.ts

@@ -24,4 +24,15 @@ export declare function getTypeDefs(def: Pick<ComponentDocApi, "typedefs">): str
  * ```
  */
 export declare function getContextDefs(def: Pick<ComponentDocApi, "contexts" | "generics">): string;
-export declare function writeTsDefinition(component: ComponentDocApi): string;
+export interface WriteTsDefinitionOptions {
+    /**
+     * `"class"` (default) extends the deprecated `SvelteComponentTyped`.
+     * `"component"` emits `declare const X: Component<Props, Exports, Bindings>`
+     * instead, for Svelte 5+ consumers. Generic components get a per-component
+     * interface with a generic call signature instead of `Component<...>`
+     * directly, since a `declare const` can't itself carry a generic type
+     * parameter (see `genGenericComponentDeclaration`).
+     */
+    format?: "class" | "component";
+}
+export declare function writeTsDefinition(component: ComponentDocApi, options?: WriteTsDefinitionOptions): string;

package/lib/writer/writer-ts-definitions.d.ts

@@ -1,5 +1,6 @@
 import type { ParsedExports } from "../parse-exports";
 import type { ComponentDocs } from "../plugin";
+import { type WriteTsDefinitionOptions } from "./writer-ts-definitions-core";
 /**
  * Re-export browser-compatible functions from core module.
  *
@@ -9,7 +10,7 @@ import type { ComponentDocs } from "../plugin";
  *
  * @see {@link ./writer-ts-definitions-core} for the core implementation
  */
-export { formatTsProps, getContextDefs, getTypeDefs, writeTsDefinition, } from "./writer-ts-definitions-core";
+export { formatTsProps, getContextDefs, getTypeDefs, type WriteTsDefinitionOptions, writeTsDefinition, } from "./writer-ts-definitions-core";
 /**
  * Options for writing TypeScript definition files.
  *
@@ -17,6 +18,7 @@ export { formatTsProps, getContextDefs, getTypeDefs, writeTsDefinition, } from "
  * @property inputDir - The input directory containing source components
  * @property preamble - Text to prepend to the main `index.d.ts` file
  * @property exports - Parsed export information for generating the index file
+ * @property format - `"class"` (default) or `"component"`; see {@link WriteTsDefinitionOptions}
  *
  * @example
  * ```ts
@@ -28,12 +30,11 @@ export { formatTsProps, getContextDefs, getTypeDefs, writeTsDefinition, } from "
  * };
  * ```
  */
-export interface WriteTsDefinitionsOptions {
+export interface WriteTsDefinitionsOptions extends WriteTsDefinitionOptions {
     outDir: string;
     inputDir: string;
     preamble: string;
     exports: ParsedExports;
-    printWidth?: number;
 }
 /**
  * Writes TypeScript definition files for all parsed Svelte components.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sveld",
-  "version": "0.34.1",
+  "version": "0.35.0",
   "license": "Apache-2.0",
   "description": "Generate TypeScript definitions and component documentation for your Svelte components.",
   "type": "module",
@@ -13,9 +13,6 @@
       "default": "./lib/index.js"
     }
   },
-  "dependencies": {
-    "prettier": "^3.8.4"
-  },
   "bin": {
     "sveld": "cli.js"
   },