@loworbitstudio/visor-theme-engine 0.4.0 → 0.4.2

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import { c as GeneratedPrimitives, i as SemanticTokens, R as ResolvedThemeConfig } from '../types-DgAumoCX.js';
+import { c as GeneratedPrimitives, i as SemanticTokens, R as ResolvedThemeConfig } from '../types-ljcTtODU.js';
 
 /**
  * Adapter types for the Visor theme engine.
@@ -33,8 +33,39 @@ interface DocsAdapterOptions extends AdapterOptions {
     /** Include font imports at the top (default: true) */
     includeFontImports?: boolean;
 }
+/** Options specific to the Flutter adapter. */
+interface FlutterAdapterOptions {
+    /** Package name for the generated Dart package (default: "ui") */
+    packageName?: string;
+    /**
+     * Skip full package scaffolding; emit only token files for slot-in to an
+     * existing `packages/ui/` (default: false).
+     */
+    tokensOnly?: boolean;
+    /** Emit only light-brightness theme getters (default: emit both). */
+    lightOnly?: boolean;
+    /** Emit only dark-brightness theme getters (default: emit both). */
+    darkOnly?: boolean;
+    /** Name for the generated theme class (default: "VisorAppTheme"). */
+    themeClassName?: string;
+    /** visor_core pub.dev version constraint (default: "^0.1.0"). */
+    visorCoreVersion?: string;
+}
+/**
+ * File-map output produced by adapters that emit a directory tree
+ * (e.g. the Flutter adapter emits an entire Dart package).
+ *
+ * Keys are paths relative to the caller-supplied output directory;
+ * values are file contents. Callers walk the map, mkdir each parent,
+ * and write each file.
+ */
+interface AdapterFileMap {
+    files: Record<string, string>;
+}
+/** Narrow a union [string | AdapterFileMap] to the file-map case. */
+declare function isAdapterFileMap(output: string | AdapterFileMap): output is AdapterFileMap;
 /** Supported adapter names. */
-type AdapterName = "nextjs" | "fumadocs" | "deck" | "docs";
+type AdapterName = "nextjs" | "fumadocs" | "deck" | "docs" | "flutter";
 
 /**
  * NextJS Adapter
@@ -108,17 +139,51 @@ declare function deckAdapter(input: AdapterInput, options?: DeckAdapterOptions):
 /**
  * Generate docs-site CSS for a theme.
  *
- * Output is class-scoped (.{slug}-theme) with no @layer wrapping,
- * matching the hand-written theme files in packages/docs/app/.
+ * Output is class-scoped (.{slug}-theme) and wrapped in @layer visor-adaptive
+ * so consumer overrides (unlayered) and visor-core's own visor-adaptive layer
+ * cascade correctly. Font @import / @font-face statements stay outside the
+ * layer block per CSS spec (VI-312).
  */
 declare function docsAdapter(input: AdapterInput, options?: DocsAdapterOptions): string;
 
+/**
+ * Flutter Adapter
+ *
+ * Generates a Dart package (or token-only file set) from Visor theme data,
+ * matching the Low Orbit canonical `packages/ui/` structure:
+ *
+ * ```
+ * packages/ui/
+ * ├── pubspec.yaml
+ * ├── lib/
+ * │   ├── ui.dart                             # barrel
+ * │   └── src/
+ * │       ├── colors/visor_colors.dart        # primitives + VisorColors.light/dark
+ * │       ├── typography/visor_text_styles.dart
+ * │       ├── spacing/visor_spacing.dart
+ * │       ├── radius/visor_radius.dart
+ * │       ├── shadows/visor_shadows.dart
+ * │       ├── strokes/visor_stroke_widths.dart
+ * │       ├── motion/visor_motion.dart
+ * │       └── theme/visor_theme.dart          # VisorAppTheme.{light,dark}
+ * ```
+ */
+
+/**
+ * Generate a Flutter token package from theme engine output.
+ *
+ * @returns File map keyed by path relative to the output directory.
+ */
+declare function flutterAdapter(input: AdapterInput, options?: FlutterAdapterOptions): AdapterFileMap;
+
 /**
  * CSS @layer utilities for adapter output.
  *
- * Establishes a specificity ordering so theme overrides work
- * without !important. Layers are adapter-only — the base
- * generateFullBundleCss output is not wrapped in layers.
+ * Establishes a specificity ordering so theme overrides work without
+ * !important. Both adapter output (here) and visor-core's emitted CSS
+ * (packages/tokens/src/generate/generate-css.ts) declare this same layer
+ * order — defense in depth, so whichever stylesheet loads first establishes
+ * the cascade.
  */
 /** Layer order declaration — must appear before any @layer blocks. */
 declare const LAYER_ORDER = "@layer visor-primitives, visor-semantic, visor-adaptive, visor-bridge;";
@@ -147,4 +212,4 @@ interface FumadocsBridgeEntry {
  */
 declare const FUMADOCS_BRIDGE_MAP: Record<string, FumadocsBridgeEntry>;
 
-export { type AdapterInput, type AdapterName, type AdapterOptions, type DeckAdapterOptions, type DocsAdapterOptions, FUMADOCS_BRIDGE_MAP, type FumadocsBridgeEntry, LAYER_ORDER, type NextJSAdapterOptions, deckAdapter, docsAdapter, fumadocsAdapter, nextjsAdapter, wrapInLayer };
+export { type AdapterFileMap, type AdapterInput, type AdapterName, type AdapterOptions, type DeckAdapterOptions, type DocsAdapterOptions, FUMADOCS_BRIDGE_MAP, type FlutterAdapterOptions, type FumadocsBridgeEntry, LAYER_ORDER, type NextJSAdapterOptions, deckAdapter, docsAdapter, flutterAdapter, fumadocsAdapter, isAdapterFileMap, nextjsAdapter, wrapInLayer };