svelte-origin 0.0.0 → 1.0.0-next.15

package/dist/plugin.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Unified Vite/Rollup/Rolldown plugin for svelte-origin
+ *
+ * This plugin transforms macro syntax in:
+ * - .svelte.ts/.svelte.js files (origin definitions)
+ * - .svelte files (component scripts using $attrs.origin, $attrs.for, etc.)
+ *
+ * Works with Vite, Rollup, and Rolldown.
+ *
+ * NOTE: For best compatibility (especially with rolldown-vite), use the
+ * Svelte preprocessor instead of or in addition to this plugin:
+ *
+ * ```js
+ * // svelte.config.js
+ * import { svelteOriginPreprocess } from 'svelte-origin/preprocess'
+ *
+ * export default {
+ *   preprocess: [
+ *     svelteOriginPreprocess(),  // MUST come first
+ *     vitePreprocess()
+ *   ]
+ * }
+ * ```
+ */
+import { parseOriginSchemaFromSource, findImportPath, type ParsedOriginSchema, type ParsedAttrInfo, type SchemaResolver } from './transform/schema';
+type Plugin = {
+    name: string;
+    enforce?: 'pre' | 'post';
+    resolveId?: (id: string, importer?: string) => Promise<string | null | undefined | {
+        id: string;
+        external?: boolean;
+    }> | string | null | undefined | {
+        id: string;
+        external?: boolean;
+    };
+    load?: (id: string) => Promise<{
+        code: string;
+        map?: any;
+    } | string | null | undefined> | {
+        code: string;
+        map?: any;
+    } | string | null | undefined;
+    transform?: (code: string, id: string) => Promise<{
+        code: string;
+        map?: any;
+    } | null | undefined> | {
+        code: string;
+        map?: any;
+    } | null | undefined;
+};
+export interface SvelteOriginPluginOptions {
+    /**
+     * File extensions to process for origin definitions
+     * @default ['.svelte.ts', '.svelte.js', '.origin.svelte.ts']
+     */
+    extensions?: string[];
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Output transformed code to .transformed.txt files for debugging
+     * @default false
+     */
+    outputTransformed?: boolean;
+    /**
+     * Directory to output transformed files (relative to file or absolute)
+     * @default same directory as source file
+     */
+    outputDir?: string;
+    /**
+     * Manual alias mappings for resolving non-relative imports.
+     * These have the highest priority and override auto-detected aliases.
+     *
+     * @example
+     * aliases: {
+     *   '$lib': 'src/lib',
+     *   '$components': 'src/lib/components'
+     * }
+     */
+    aliases?: Record<string, string>;
+    /**
+     * Project root for resolving relative alias paths
+     * @default process.cwd()
+     */
+    root?: string;
+    /**
+     * Whether to auto-detect aliases from tsconfig.json and svelte.config.js
+     *
+     * When enabled (default), the plugin will:
+     * 1. Read tsconfig.json (and any configs it extends) for compilerOptions.paths
+     * 2. Read .svelte-kit/tsconfig.json for SvelteKit-generated paths
+     * 3. Read svelte.config.js for kit.alias configuration
+     *
+     * Manual aliases always take priority over auto-detected ones.
+     *
+     * @default true
+     */
+    autoDetectAliases?: boolean;
+    /**
+     * Path to tsconfig.json (relative to root or absolute).
+     * Only used when autoDetectAliases is true.
+     */
+    tsconfig?: string;
+    /**
+     * Path to svelte.config.js (relative to root or absolute).
+     * Only used when autoDetectAliases is true.
+     */
+    svelteConfig?: string;
+}
+/**
+ * Create a unified plugin for svelte-origin macros.
+ * Works with Vite, Rollup, and Rolldown.
+ *
+ * @example
+ * // vite.config.ts
+ * import { svelteOrigin } from 'svelte-origin/plugin'
+ * import { sveltekit } from '@sveltejs/kit/vite'
+ *
+ * export default {
+ *   plugins: [
+ *     svelteOrigin(),
+ *     sveltekit()
+ *   ]
+ * }
+ *
+ * @example
+ * // rollup.config.js
+ * import { svelteOrigin } from 'svelte-origin/plugin'
+ * import svelte from 'rollup-plugin-svelte'
+ *
+ * export default {
+ *   plugins: [
+ *     svelteOrigin(),
+ *     svelte()
+ *   ]
+ * }
+ */
+export declare function svelteOrigin(options?: SvelteOriginPluginOptions): Plugin;
+export default svelteOrigin;
+export { findImportPath, parseOriginSchemaFromSource };
+export type { ParsedOriginSchema, SchemaResolver, ParsedAttrInfo };