sveld 0.26.2 → 0.28.0

package/lib/cli.js

@@ -1,48 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.cli = cli;
-const plugin_node_resolve_1 = __importDefault(require("@rollup/plugin-node-resolve"));
-const rollup_1 = require("rollup");
-const rollup_plugin_svelte_1 = __importDefault(require("rollup-plugin-svelte"));
-const get_svelte_entry_1 = require("./get-svelte-entry");
-const plugin_1 = require("./plugin");
-/**
- * Command-line interface for sveld.
- *
- * Parses command-line arguments, runs Rollup to process the entry point,
- * generates component documentation, and writes output files.
- *
- * @param process - Node.js process object containing command-line arguments
- *
- * @example
- * ```ts
- * // Called from CLI: sveld --types --json --glob
- * // Parses: { types: true, json: true, glob: true }
- * ```
- */
-async function cli(process) {
-    const options = process.argv
-        .slice(2)
-        .map((arg) => {
-        const [flag, value] = arg.split("=");
-        const key = flag.slice(2);
-        return { [key]: value === undefined ? true : value };
-    })
-        .reduce((a, c) => {
-        for (const key in c) {
-            a[key] = c[key];
-        }
-        return a;
-    }, {});
-    const input = (0, get_svelte_entry_1.getSvelteEntry)() || "src/index.js";
-    const rollup_bundle = await (0, rollup_1.rollup)({
-        input,
-        plugins: [(0, rollup_plugin_svelte_1.default)(), (0, plugin_node_resolve_1.default)()],
-    });
-    await rollup_bundle.generate({});
-    const result = await (0, plugin_1.generateBundle)(input, options?.glob === true);
-    (0, plugin_1.writeOutput)(result, options, input);
-}

package/lib/create-exports.js

@@ -1,170 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createExports = createExports;
-exports.removeSvelteExt = removeSvelteExt;
-exports.convertSvelteExt = convertSvelteExt;
-const SVELTE_EXT_REGEX = /\.svelte$/;
-/**
- * Creates export statements from parsed export information.
- *
- * Groups exports by source file and generates optimized export statements.
- * Handles special cases like Svelte component exports, default exports,
- * and mixed exports from module context.
- *
- * @param parsed_exports - Map of export names to their source and metadata
- * @returns A string containing all export statements
- *
- * @example
- * ```ts
- * // Input:
- * { Button: { source: "./Button.svelte", default: true } }
- *
- * // Output:
- * // export { default as Button } from "./Button.svelte";
- * ```
- */
-function createExports(parsed_exports) {
-    /**
-     * Group exports by source file.
-     * This allows us to combine multiple exports from the same source
-     * into a single export statement for better organization.
-     */
-    const groupedBySource = new Map();
-    for (const [id, exportee] of Object.entries(parsed_exports)) {
-        const existing = groupedBySource.get(exportee.source) || [];
-        existing.push({ id, exportee });
-        groupedBySource.set(exportee.source, existing);
-    }
-    /**
-     * Generate export statements, keeping grouped exports together.
-     * Exports from the same source file are combined into single statements
-     * when possible for cleaner output.
-     */
-    const exportStatements = [];
-    for (const [source, exports] of groupedBySource) {
-        const isSvelteFile = SVELTE_EXT_REGEX.test(source);
-        /**
-         * Check if this source has both default and non-default exports (indicates module context exports).
-         * Exclude id="default" from this check, as that's just re-exporting the default as-is.
-         * Mixed exports occur when a Svelte file has both `<script context="module">` exports
-         * and a default component export.
-         */
-        const hasDefaultExport = exports.some(({ id, exportee }) => id !== "default" && exportee.default);
-        const hasNonDefaultExport = exports.some(({ exportee }) => !exportee.default);
-        const hasMixedExports = isSvelteFile && hasDefaultExport && hasNonDefaultExport;
-        /**
-         * Separate named exports from default exports.
-         * Also track "default as X" exports separately as they can be combined with named exports.
-         */
-        const namedExports = [];
-        const defaultExports = [];
-        /**
-         * Track "default as X" exports separately.
-         * These can be grouped with named exports from the same source.
-         */
-        const defaultAsExports = [];
-        for (const { id, exportee } of exports) {
-            /**
-             * If id is "default", always export as default.
-             * This handles explicit default re-exports.
-             */
-            if (id === "default") {
-                defaultExports.push(`export { default } from "${source}";`);
-                continue;
-            }
-            /**
-             * If exportee.default is true, we're re-exporting a default export with a new name.
-             * Handle mixed exports specially (both default and named from module context).
-             */
-            if (exportee.default) {
-                if (exportee.mixed) {
-                    defaultExports.push(`export { default as ${id} } from "${source}";`);
-                    defaultExports.push(`export { default } from "${source}";`);
-                }
-                else {
-                    /**
-                     * Use "default as X" so they can be grouped with named exports from same source.
-                     * This allows combining default-as-renamed with named exports in one statement.
-                     */
-                    defaultAsExports.push(`default as ${id}`);
-                }
-            }
-            else if (isSvelteFile && !hasMixedExports) {
-                /**
-                 * For Svelte files without mixed exports, treat as component (re-export default).
-                 * Svelte components are default exports, so we re-export them as named exports.
-                 */
-                defaultAsExports.push(`default as ${id}`);
-            }
-            else {
-                /**
-                 * It's a named export (including named exports from Svelte module context).
-                 * These come from `<script context="module">` blocks.
-                 */
-                namedExports.push(id);
-            }
-        }
-        /**
-         * Combine default-as-renamed and named exports from same source (for Svelte module exports).
-         * This creates statements like: `export { default as Component, namedExport } from "source"`
-         */
-        if (defaultAsExports.length > 0 && namedExports.length > 0) {
-            /**
-             * Combine into single statement: export { default as X, namedExport } from "source".
-             * This is more efficient and cleaner than separate statements.
-             */
-            exportStatements.push(`export { ${[...defaultAsExports, ...namedExports].join(", ")} } from "${source}";`);
-        }
-        else {
-            /**
-             * Generate grouped named exports.
-             * Multiple named exports from the same source are combined.
-             */
-            if (namedExports.length > 0) {
-                exportStatements.push(`export { ${namedExports.join(", ")} } from "${source}";`);
-            }
-            /**
-             * Add default-as exports.
-             * These are component re-exports: `export { default as ComponentName } from "source"`.
-             */
-            if (defaultAsExports.length > 0) {
-                exportStatements.push(`export { ${defaultAsExports.join(", ")} } from "${source}";`);
-            }
-        }
-        /**
-         * Add default exports (these cannot be grouped).
-         * Default exports must be in separate statements as they can't be combined
-         * with named exports in the same statement.
-         */
-        exportStatements.push(...defaultExports);
-    }
-    return exportStatements.join("\n");
-}
-/**
- * Removes the `.svelte` extension from a file path.
- *
- * @param filePath - The file path to process
- * @returns The path without the .svelte extension
- *
- * @example
- * ```ts
- * removeSvelteExt("./Button.svelte") // Returns: "./Button"
- * ```
- */
-function removeSvelteExt(filePath) {
-    return filePath.replace(SVELTE_EXT_REGEX, "");
-}
-/**
- * Converts a `.svelte` file path to a `.svelte.d.ts` TypeScript definition path.
- *
- * @param filePath - The Svelte file path to convert
- * @returns The path with .svelte.d.ts extension
- *
- * @example
- * ```ts
- * convertSvelteExt("./Button.svelte") // Returns: "./Button.svelte.d.ts"
- * ```
- */
-function convertSvelteExt(filePath) {
-    return filePath.replace(SVELTE_EXT_REGEX, ".svelte.d.ts");
-}

package/lib/element-tag-map.js

@@ -1,158 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getElementByTag = getElementByTag;
-/**
- * Element tag map adapted from TypeScript's `lib.dom.d.ts`.
- *
- * Maps HTML element tag names to their corresponding TypeScript element types.
- * Used for generating proper TypeScript types for element bindings and rest props.
- * See the TypeScript lib.dom.d.ts for the original source.
- *
- * @example
- * ```ts
- * tag_map["button"] // "HTMLButtonElement"
- * tag_map["div"]    // "HTMLDivElement"
- * tag_map["input"]  // "HTMLInputElement"
- * ```
- */
-const tag_map = {
-    a: "HTMLAnchorElement",
-    abbr: "HTMLElement",
-    address: "HTMLElement",
-    applet: "HTMLUnknownElement",
-    area: "HTMLAreaElement",
-    article: "HTMLElement",
-    aside: "HTMLElement",
-    audio: "HTMLAudioElement",
-    b: "HTMLElement",
-    base: "HTMLBaseElement",
-    basefont: "HTMLElement",
-    bdi: "HTMLElement",
-    bdo: "HTMLElement",
-    blockquote: "HTMLQuoteElement",
-    body: "HTMLBodyElement",
-    br: "HTMLBRElement",
-    button: "HTMLButtonElement",
-    canvas: "HTMLCanvasElement",
-    caption: "HTMLTableCaptionElement",
-    cite: "HTMLElement",
-    code: "HTMLElement",
-    col: "HTMLTableColElement",
-    colgroup: "HTMLTableColElement",
-    data: "HTMLDataElement",
-    datalist: "HTMLDataListElement",
-    dd: "HTMLElement",
-    del: "HTMLModElement",
-    details: "HTMLDetailsElement",
-    dfn: "HTMLElement",
-    dialog: "HTMLDialogElement",
-    dir: "HTMLDirectoryElement",
-    div: "HTMLDivElement",
-    dl: "HTMLDListElement",
-    dt: "HTMLElement",
-    em: "HTMLElement",
-    embed: "HTMLEmbedElement",
-    fieldset: "HTMLFieldSetElement",
-    figcaption: "HTMLElement",
-    figure: "HTMLElement",
-    font: "HTMLFontElement",
-    footer: "HTMLElement",
-    form: "HTMLFormElement",
-    frame: "HTMLFrameElement",
-    frameset: "HTMLFrameSetElement",
-    h1: "HTMLHeadingElement",
-    h2: "HTMLHeadingElement",
-    h3: "HTMLHeadingElement",
-    h4: "HTMLHeadingElement",
-    h5: "HTMLHeadingElement",
-    h6: "HTMLHeadingElement",
-    head: "HTMLHeadElement",
-    header: "HTMLElement",
-    hgroup: "HTMLElement",
-    hr: "HTMLHRElement",
-    html: "HTMLHtmlElement",
-    i: "HTMLElement",
-    iframe: "HTMLIFrameElement",
-    img: "HTMLImageElement",
-    input: "HTMLInputElement",
-    ins: "HTMLModElement",
-    kbd: "HTMLElement",
-    label: "HTMLLabelElement",
-    legend: "HTMLLegendElement",
-    li: "HTMLLIElement",
-    link: "HTMLLinkElement",
-    main: "HTMLElement",
-    map: "HTMLMapElement",
-    mark: "HTMLElement",
-    marquee: "HTMLMarqueeElement",
-    menu: "HTMLMenuElement",
-    meta: "HTMLMetaElement",
-    meter: "HTMLMeterElement",
-    nav: "HTMLElement",
-    noscript: "HTMLElement",
-    object: "HTMLObjectElement",
-    ol: "HTMLOListElement",
-    optgroup: "HTMLOptGroupElement",
-    option: "HTMLOptionElement",
-    output: "HTMLOutputElement",
-    p: "HTMLParagraphElement",
-    param: "HTMLParamElement",
-    picture: "HTMLPictureElement",
-    pre: "HTMLPreElement",
-    progress: "HTMLProgressElement",
-    q: "HTMLQuoteElement",
-    rp: "HTMLElement",
-    rt: "HTMLElement",
-    ruby: "HTMLElement",
-    s: "HTMLElement",
-    samp: "HTMLElement",
-    script: "HTMLScriptElement",
-    search: "HTMLElement",
-    section: "HTMLElement",
-    select: "HTMLSelectElement",
-    slot: "HTMLSlotElement",
-    small: "HTMLElement",
-    source: "HTMLSourceElement",
-    span: "HTMLSpanElement",
-    strong: "HTMLElement",
-    style: "HTMLStyleElement",
-    sub: "HTMLElement",
-    summary: "HTMLElement",
-    sup: "HTMLElement",
-    table: "HTMLTableElement",
-    tbody: "HTMLTableSectionElement",
-    td: "HTMLTableCellElement",
-    template: "HTMLTemplateElement",
-    textarea: "HTMLTextAreaElement",
-    tfoot: "HTMLTableSectionElement",
-    th: "HTMLTableCellElement",
-    thead: "HTMLTableSectionElement",
-    time: "HTMLTimeElement",
-    title: "HTMLTitleElement",
-    tr: "HTMLTableRowElement",
-    track: "HTMLTrackElement",
-    u: "HTMLElement",
-    ul: "HTMLUListElement",
-    var: "HTMLElement",
-    video: "HTMLVideoElement",
-    wbr: "HTMLElement",
-};
-/**
- * Gets the TypeScript element type for a given HTML tag name.
- *
- * Returns the specific element type (e.g., `HTMLButtonElement`) if the tag
- * is in the map, otherwise returns the generic `HTMLElement` type.
- *
- * @param element - The HTML tag name (e.g., "button", "div", "input")
- * @returns The corresponding TypeScript element type name
- *
- * @example
- * ```ts
- * getElementByTag("button")  // Returns: "HTMLButtonElement"
- * getElementByTag("div")     // Returns: "HTMLDivElement"
- * getElementByTag("custom")  // Returns: "HTMLElement" (fallback)
- * ```
- */
-function getElementByTag(element) {
-    return element in tag_map ? tag_map[element] : "HTMLElement";
-}

package/lib/get-svelte-entry.js

@@ -1,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSvelteEntry = getSvelteEntry;
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-/**
- * Get the file path entry point for uncompiled Svelte source code
- * Expects a "svelte" field in the consumer's `package.json`
- */
-function getSvelteEntry(entryPoint) {
-    if (entryPoint) {
-        const entry_path = (0, node_path_1.join)(process.cwd(), entryPoint);
-        if ((0, node_fs_1.existsSync)(entry_path)) {
-            return entryPoint;
-        }
-        else {
-            console.log(`Invalid entry point: ${entry_path}.`);
-            return null;
-        }
-    }
-    const pkg_path = (0, node_path_1.join)(process.cwd(), "package.json");
-    if (!(0, node_fs_1.existsSync)(pkg_path)) {
-        console.log("Could not locate a package.json file.\n");
-        return null;
-    }
-    try {
-        const pkg = JSON.parse((0, node_fs_1.readFileSync)(pkg_path, "utf-8"));
-        if (typeof pkg.svelte === "string" && pkg.svelte.trim()) {
-            return pkg.svelte;
-        }
-        console.log("Could not determine an entry point.\n");
-        console.log('Specify an entry point to your Svelte code in the "svelte" field of your package.json.\n');
-        return null;
-    }
-    catch (error) {
-        console.error("Error reading package.json:", error);
-        throw error;
-    }
-}

package/lib/parse-exports.js

@@ -1,112 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseExports = parseExports;
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-const acorn_1 = require("acorn");
-const path_1 = require("./path");
-const resolve_alias_1 = require("./resolve-alias");
-const astCache = new Map();
-/**
- * Parses export statements from JavaScript/TypeScript source code.
- *
- * Extracts all exports (default, named, and re-exports) and resolves
- * their source paths, handling path aliases and directory imports.
- * Caches parsed ASTs for performance.
- *
- * @param source - The source code to parse
- * @param dir - The directory context for resolving relative paths and aliases
- * @returns A map of export names to their source paths and metadata
- *
- * @example
- * ```ts
- * // Source: export { Button } from "./Button.svelte";
- * //        export default App from "./App.svelte";
- * parseExports(source, "./src")
- * // Returns: {
- * //   Button: { source: "./Button.svelte", default: false },
- * //   App: { source: "./App.svelte", default: true }
- * // }
- * ```
- */
-function parseExports(source, dir) {
-    let ast = astCache.get(source);
-    if (!ast) {
-        ast = (0, acorn_1.parse)(source, {
-            ecmaVersion: "latest",
-            sourceType: "module",
-        });
-        astCache.set(source, ast);
-    }
-    const exports_by_identifier = {};
-    for (const node of ast.body) {
-        if (node.type === "ExportDefaultDeclaration") {
-            const id = node.declaration.name;
-            if (id in exports_by_identifier) {
-                exports_by_identifier[id].default = true;
-            }
-            else {
-                exports_by_identifier[id] = { source: "", default: true };
-            }
-        }
-        else if (node.type === "ExportAllDeclaration") {
-            if (!node.source)
-                continue;
-            const resolvedSource = (0, resolve_alias_1.resolvePathAliasAbsolute)(node.source.value, dir);
-            let file_path = (0, node_path_1.resolve)(dir, resolvedSource);
-            if (!(0, node_fs_1.lstatSync)(file_path).isFile()) {
-                const files = (0, node_fs_1.readdirSync)(file_path);
-                for (const file of files)
-                    if (file.includes("index")) {
-                        file_path = (0, node_path_1.join)(file_path, file);
-                        break;
-                    }
-            }
-            const export_file = (0, node_fs_1.readFileSync)(file_path, "utf-8");
-            const exports = parseExports(export_file, (0, node_path_1.dirname)(file_path));
-            for (const [key, value] of Object.entries(exports)) {
-                const source = (0, path_1.normalizeSeparators)(`./${(0, node_path_1.join)(node.source.value, value.source)}`);
-                exports_by_identifier[key] = {
-                    ...value,
-                    source,
-                };
-            }
-        }
-        else if (node.type === "ExportNamedDeclaration") {
-            for (const specifier of node.specifiers) {
-                const exported_name = specifier.exported.name;
-                const local_name = specifier.local.name;
-                const id = exported_name || local_name;
-                if (id in exports_by_identifier) {
-                    if (node.type === "ExportNamedDeclaration") {
-                        exports_by_identifier[id].mixed = true;
-                    }
-                    if (!exports_by_identifier[id].source) {
-                        exports_by_identifier[id].source = (0, resolve_alias_1.resolvePathAlias)(node.source?.value ?? "", dir);
-                    }
-                }
-                else {
-                    exports_by_identifier[id] = {
-                        source: (0, resolve_alias_1.resolvePathAlias)(node.source?.value ?? "", dir),
-                        default: local_name === "default",
-                    };
-                }
-            }
-        }
-        else if (node.type === "ImportDeclaration") {
-            const id = node.specifiers[0].local.name;
-            if (id in exports_by_identifier) {
-                if (!exports_by_identifier[id].source) {
-                    exports_by_identifier[id].source = (0, resolve_alias_1.resolvePathAlias)(node.source?.value ?? "", dir);
-                }
-            }
-            else {
-                exports_by_identifier[id] = {
-                    source: (0, resolve_alias_1.resolvePathAlias)(node.source?.value ?? "", dir),
-                    default: id === "default",
-                };
-            }
-        }
-    }
-    return exports_by_identifier;
-}

package/lib/path.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeSeparators = normalizeSeparators;
-const node_path_1 = require("node:path");
-/**
- * Normalize directory separators to always use `/`.
- * @param filePath A file path.
- * @returns Path with normalized separators.
- */
-function normalizeSeparators(filePath) {
-    return node_path_1.sep === "/" ? filePath : filePath.split(node_path_1.sep).join("/");
-}