svelte-origin 0.0.0 → 1.0.0-next.15

package/dist/preprocess.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Svelte preprocessor for svelte-origin
+ *
+ * This preprocessor transforms $attrs.* and $origin macros before
+ * Svelte compiles the code. It runs as part of the Svelte compilation
+ * pipeline, guaranteeing it executes before the Svelte compiler sees the code.
+ *
+ * This is the PRIMARY and RECOMMENDED way to use svelte-origin.
+ * The Vite plugin is a secondary option for advanced use cases.
+ */
+export interface SvelteOriginPreprocessOptions {
+    /** Enable debug logging */
+    debug?: boolean;
+    /**
+     * Manual path aliases for resolving imports.
+     * These have the highest priority and override auto-detected aliases.
+     *
+     * @example
+     * ```js
+     * svelteOriginPreprocess({
+     *   aliases: {
+     *     '$lib': 'src/lib',
+     *     '$components': 'src/lib/components'
+     *   }
+     * })
+     * ```
+     */
+    aliases?: Record<string, string>;
+    /**
+     * Project root directory for resolving paths.
+     * Defaults to process.cwd()
+     */
+    root?: string;
+    /**
+     * Whether to auto-detect aliases from tsconfig.json and svelte.config.js
+     *
+     * When enabled (default), the preprocessor 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.
+     * If not specified, will search for tsconfig.json and .svelte-kit/tsconfig.json
+     */
+    tsconfig?: string;
+    /**
+     * Path to svelte.config.js (relative to root or absolute).
+     * Only used when autoDetectAliases is true.
+     * If not specified, will search for svelte.config.js in the root.
+     */
+    svelteConfig?: string;
+}
+type PreprocessorMarkup = {
+    content: string;
+    filename?: string;
+    attributes?: Record<string, string | boolean>;
+};
+type PreprocessorResult = {
+    code: string;
+    map?: object;
+} | undefined;
+export declare function svelteOriginPreprocess(options?: SvelteOriginPreprocessOptions): {
+    name: string;
+    script(params: PreprocessorMarkup): Promise<PreprocessorResult>;
+};
+export default svelteOriginPreprocess;