@purview-dev/astroc4 1.0.0-prerelease.5 → 1.0.0-prerelease.6

package/dist/integration.d.ts

@@ -1,37 +1,27 @@
 import type { AstroIntegration } from 'astro';
 import { LikeC4VitePlugin } from 'likec4/vite-plugin';
-/**
- * The published package name. Scoped because npm refuses the unscoped
- * `astroc4` — "too similar to existing package astro" — and because the scope
- * makes the specifiers this plugin writes into a site's pages unambiguous.
- */
+/** Scoped because npm refuses the unscoped `astroc4` as too similar to `astro`. */
 export declare const PACKAGE_NAME = "@purview-dev/astroc4";
 export interface LikeC4IntegrationOptions {
     /**
-     * Passed through to `LikeC4VitePlugin` — e.g. `{ workspace: 'diagrams' }` to
-     * look for .c4 files somewhere other than the site root.
+     * Passed through to `LikeC4VitePlugin`. Setting `workspace` or
+     * `languageServices` takes project discovery over, and `projects` is ignored.
      */
     vitePlugin?: Parameters<typeof LikeC4VitePlugin>[0];
-    /** Render ```likec4 fences in .mdx pages as diagrams. Defaults to `true`. */
+    /**
+     * Named LikeC4 projects, compiled alongside those discovered under the site
+     * root: `{ architecture: '../../docs/architecture/likec4' }`. Folders are
+     * relative to the site root or absolute.
+     */
+    projects?: Record<string, string>;
+    /** Render ```likec4 fences in .md and .mdx pages as diagrams. Defaults to `true`. */
     fences?: boolean;
 }
 /**
- * The `optimizeDeps.include` entries a site still needs for the island to
- * hydrate.
- *
- * Only the missing ones are returned: Astro merges the `vite` option with
- * Vite's `mergeConfig`, which concatenates arrays, so re-sending a site's own
- * entries would duplicate them. An entry that does not resolve is left out —
- * a site without React cannot render the island anyway, and naming a package
- * Vite cannot find breaks the optimizer with a less useful error.
- *
- * @param include The site's existing `vite.optimizeDeps.include`.
- * @param root The site root, where the dependency has to resolve from.
+ * The `optimizeDeps.include` entries the site still lacks. Only missing ones:
+ * Vite's `mergeConfig` concatenates arrays. Unresolvable ones are skipped, since
+ * naming a package Vite cannot find breaks the optimizer.
  */
 export declare function missingOptimizedDependencies(include: unknown, root: string): string[];
-/**
- * The integration both entry points install: LikeC4's Vite plugin, the fence
- * transform, and the dev-only bits that keep the islands hydrating.
- */
-export declare function likec4Integration({ vitePlugin, fences, }?: LikeC4IntegrationOptions): AstroIntegration;
+export declare function likec4Integration({ vitePlugin, projects, fences, }?: LikeC4IntegrationOptions): AstroIntegration;
 export default likec4Integration;