@loworbitstudio/visor-theme-engine 0.1.0 → 0.4.1

package/README.md

@@ -0,0 +1,29 @@
+# @loworbitstudio/visor-theme-engine
+
+Theme engine for the [Visor](https://visor.loworbit.studio) design system — shade generation, token mapping, font resolution, and import/export for `.visor.yaml` themes.
+
+## Installation
+
+```bash
+npm install @loworbitstudio/visor-theme-engine
+```
+
+## What It Does
+
+- Generates dark and light color scales from a brand anchor color using OKLCH
+- Maps theme configuration (`.visor.yaml`) to CSS custom properties
+- Resolves font declarations against the Visor fonts CDN
+- Exports theme bundles for use in any project
+- Provides a `docsAdapter` for registering themes in fumadocs sites
+
+## Usage
+
+Themes are typically managed via the Visor CLI (`visor theme sync`). Direct API usage is for advanced cases — building custom theme tooling or integrating with non-CLI workflows.
+
+```ts
+import { generateTheme } from '@loworbitstudio/visor-theme-engine'
+```
+
+## Documentation
+
+Full docs at [visor.loworbit.studio](https://visor.loworbit.studio).

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import { c as GeneratedPrimitives, i as SemanticTokens, R as ResolvedThemeConfig } from '../types-r7ae3WP2.js';
+import { c as GeneratedPrimitives, i as SemanticTokens, R as ResolvedThemeConfig } from '../types-gAlkt__C.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
@@ -113,6 +144,36 @@ declare function deckAdapter(input: AdapterInput, options?: DeckAdapterOptions):
  */
 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.
  *
@@ -147,4 +208,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 };