@sylwellsoftware/fray 0.6.0 → 1.0.0

package/dist/routing/router.d.ts

@@ -0,0 +1,109 @@
+import type { ReadableEmitter } from '@sylwellsoftware/glue';
+import type { WritableEmitter } from '../Components/component.js';
+import type { NavigationAdapter } from './navigationAdapter.js';
+import type { AnyRouteDescriptor, LiteralRouteDescriptor, ParameterRouteDescriptor, RouteDescriptor, RouteQueryCodec, RouteTarget, RouteValueResolver } from './route.js';
+export type NavigationHistoryMode = 'push' | 'replace';
+export interface BrowserRouterOptions {
+    adapter: NavigationAdapter;
+}
+export interface NavigationTransition {
+    readonly state: 'pending' | 'idle';
+    readonly requestedLocation: string;
+    readonly settledLocation: string;
+}
+export interface NavigationIssue {
+    readonly requestedLocation: string;
+    readonly failedRouteId: string | null;
+    readonly reason: string;
+    readonly fallbackLocation: string;
+}
+export interface ResolvedRoute {
+    readonly route: AnyRouteDescriptor | null;
+    readonly parent: ResolvedRoute | null;
+    readonly segment: string | null;
+    readonly value: unknown;
+    readonly pathname: string;
+}
+export interface SelectionRouteBinding {
+    readonly route: LiteralRouteDescriptor;
+    readonly active: () => boolean;
+    readonly activate: (signal: AbortSignal) => void | Promise<void>;
+    readonly disabled?: boolean;
+}
+export interface ValueRouteBinding<TValue> {
+    readonly route: ParameterRouteDescriptor<TValue>;
+    readonly valueEmitter: WritableEmitter<TValue | null>;
+    readonly resolve?: RouteValueResolver<TValue>;
+}
+export interface RouteQueryBinding<TValue> {
+    readonly name: string;
+    readonly valueEmitter: WritableEmitter<TValue>;
+    readonly codec: RouteQueryCodec<TValue>;
+    readonly defaultValue: TValue;
+    readonly equals?: (left: TValue, right: TValue) => boolean;
+}
+export interface RouteRegistration {
+    readonly context: ResolvedRoute;
+    dispose(): void;
+}
+export declare class BrowserRouter {
+    readonly adapter: NavigationAdapter;
+    readonly root: ResolvedRoute;
+    readonly transition: ReadableEmitter<NavigationTransition>;
+    readonly issue: ReadableEmitter<NavigationIssue | null>;
+    private readonly transitionEmitter;
+    private readonly issueEmitter;
+    private readonly scopes;
+    private readonly contextCache;
+    private readonly knownQueryNames;
+    private readonly registryWaiters;
+    private readonly adapterUnsubscribe;
+    private controller;
+    private activeContext;
+    private requested;
+    private applying;
+    private syncQueued;
+    private disposed;
+    constructor(adapter: NavigationAdapter);
+    openScope(context: ResolvedRoute, owner: object): () => void;
+    completeScope(context: ResolvedRoute, owner: object): void;
+    registerSelectionRoutes(parent: ResolvedRoute, owner: object, bindings: readonly SelectionRouteBinding[], subscribe: (listener: () => void) => () => void): ReadonlyMap<LiteralRouteDescriptor, ResolvedRoute>;
+    unregisterRoutes(parent: ResolvedRoute, owner: object): void;
+    registerValueRoute<TValue>(parent: ResolvedRoute, owner: object, binding: ValueRouteBinding<TValue>): RouteRegistration & {
+        contextFor(value: TValue): ResolvedRoute;
+    };
+    registerQuery<TValue>(context: ResolvedRoute, owner: object, binding: RouteQueryBinding<TValue>): () => void;
+    navigate(target: RouteTarget | ResolvedRoute, options?: {
+        history?: NavigationHistoryMode;
+    }): Promise<void>;
+    redirect(target: RouteTarget | ResolvedRoute): Promise<void>;
+    href(target: RouteTarget | ResolvedRoute): string;
+    resolve(route: RouteDescriptor, from: ResolvedRoute): ResolvedRoute;
+    formatActiveLocation(): string;
+    isActive(target: RouteTarget | ResolvedRoute, exact?: boolean): boolean;
+    dispose(): void;
+    private startTransition;
+    private runTransition;
+    private waitForCompleteScope;
+    private waitForRegistryChange;
+    private wakeRegistry;
+    private fallback;
+    private literalContext;
+    private resolveTargetContext;
+    private parameterContext;
+    private cachedContext;
+    private scope;
+    private removeOwnerEntries;
+    private removeOwnerQueries;
+    private scheduleStateSync;
+    private formatStateLocation;
+    private findActiveContext;
+    private formatContext;
+    private applyQueriesInLineage;
+    private applyQueryEntry;
+    private withApplication;
+    private assertActive;
+}
+export declare function createBrowserRouter(options: BrowserRouterOptions): BrowserRouter;
+export declare function waitForRouteValue<TValue, TError>(emitter: ReadableEmitter<TValue, TError>, accept: (value: TValue) => boolean, signal: AbortSignal): Promise<TValue>;
+//# sourceMappingURL=router.d.ts.map

package/dist/routing/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/routing/router.ts"],"names":[],"mappings":"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"}

package/dist/runtime.d.ts

@@ -1,27 +1,24 @@
 import type { Component, ComponentDependency } from './Components/component.js';
 import type { StyleRegistry } from './styling/styleRegistry.js';
 import { ServiceScope } from './services.js';
-export interface FrayElementNameOptions {
-    /** Namespace prepended to component host names. Defaults to `fray`. */
-    prefix?: string | null;
-    /** Complete standards-valid tag names keyed by stable component host name. */
-    overrides?: Readonly<Record<string, string>>;
-}
+import type { BrowserRouter } from './routing/router.js';
 export interface FrayRuntimeOptions {
-    elementNames?: FrayElementNameOptions;
     /** Service scope inherited by every component created or mounted here. */
     services?: ServiceScope;
+    /** Optional caller-owned browser router inherited by routed components. */
+    router?: BrowserRouter;
 }
-/** Immutable application scope for element naming and structural styles. */
+/** Immutable application scope for structural styles and browser services. */
 export declare class FrayRuntime {
-    readonly elementPrefix: string | null;
-    readonly elementNameOverrides: Readonly<Record<string, string>>;
     readonly styleRegistry: StyleRegistry;
     readonly services: ServiceScope;
+    readonly router: BrowserRouter | null;
+    private readonly routedRoots;
     constructor(options?: FrayRuntimeOptions, registry?: StyleRegistry);
-    resolveElementName(hostName: string, standaloneHostName?: string | null): string;
-    resolveHostSelector(selector: string, hostName: string, standaloneHostName?: string | null): string;
-    resolveHostCSS(cssText: string, hostName: string, standaloneHostName?: string | null): string;
+    /** Resolve a fixed one-hyphen public host name for a built-in component. */
+    resolveElementName(hostName: string): string;
+    resolveHostSelector(selector: string, hostName: string): string;
+    resolveHostCSS(cssText: string, hostName: string): string;
     create<TArgs extends unknown[], TComponent extends Component>(componentType: new (...args: TArgs) => TComponent, ...args: TArgs): TComponent;
     mount<TComponent extends Component>(component: TComponent, parent: ParentNode, before?: Node | null): TComponent;
     registerStyles(dependency: ComponentDependency): this;

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,SAAS,EACT,mBAAmB,EACtB,MAAM,2BAA2B,CAAA;AAKlC,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,4BAA4B,CAAA;AAC7D,OAAO,EAAC,YAAY,EAAqB,MAAM,eAAe,CAAA;AAa9D,MAAM,WAAW,sBAAsB;IACnC,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAC/C;AAED,MAAM,WAAW,kBAAkB;IAC/B,YAAY,CAAC,EAAE,sBAAsB,CAAA;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,YAAY,CAAA;CAC1B;AAED,4EAA4E;AAC5E,qBAAa,WAAW;IACpB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC/D,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;gBAG3B,OAAO,GAAE,kBAAuB,EAChC,QAAQ,GAAE,aAAqC;IAgCnD,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM;IAWtF,mBAAmB,CACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,kBAAkB,GAAE,MAAM,GAAG,IAAW,GACzC,MAAM;IAKT,cAAc,CACV,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,kBAAkB,GAAE,MAAM,GAAG,IAAW,GACzC,MAAM;IAKT,MAAM,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,UAAU,SAAS,SAAS,EACxD,aAAa,EAAE,KAAI,GAAG,IAAI,EAAE,KAAK,KAAK,UAAU,EAChD,GAAG,IAAI,EAAE,KAAK,GACf,UAAU;IAMb,KAAK,CAAC,UAAU,SAAS,SAAS,EAC9B,SAAS,EAAE,UAAU,EACrB,MAAM,EAAE,UAAU,EAClB,MAAM,GAAE,IAAI,GAAG,IAAW,GAC3B,UAAU;IAMb,cAAc,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI;IAQrD,YAAY,CAAC,cAAc,GAAE,QAA8B,GAAG,gBAAgB;CAGjF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAE/E;AAED,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,aAAqC,CAAA"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,SAAS,EACT,mBAAmB,EACtB,MAAM,2BAA2B,CAAA;AAKlC,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,4BAA4B,CAAA;AAC7D,OAAO,EAAC,YAAY,EAAqB,MAAM,eAAe,CAAA;AAC9D,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAA;AAatD,MAAM,WAAW,kBAAkB;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,aAAa,CAAA;CACzB;AAED,8EAA8E;AAC9E,qBAAa,WAAW;IACpB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2B;gBAGnD,OAAO,GAAE,kBAAuB,EAChC,QAAQ,GAAE,aAAqC;IAsBnD,4EAA4E;IAC5E,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAO5C,mBAAmB,CACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACjB,MAAM;IAKT,cAAc,CACV,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACjB,MAAM;IAKT,MAAM,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,UAAU,SAAS,SAAS,EACxD,aAAa,EAAE,KAAI,GAAG,IAAI,EAAE,KAAK,KAAK,UAAU,EAChD,GAAG,IAAI,EAAE,KAAK,GACf,UAAU;IAMb,KAAK,CAAC,UAAU,SAAS,SAAS,EAC9B,SAAS,EAAE,UAAU,EACrB,MAAM,EAAE,UAAU,EAClB,MAAM,GAAE,IAAI,GAAG,IAAW,GAC3B,UAAU;IAoBb,cAAc,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI;IAQrD,YAAY,CAAC,cAAc,GAAE,QAA8B,GAAG,gBAAgB;CAGjF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAE/E;AAED,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,aAAqC,CAAA"}

package/dist/styling/styleRegistry.d.ts

@@ -2,12 +2,8 @@
 export declare class StyleRegistry {
     readonly id: string;
     private readonly cssFragments;
-    private readonly baseStyleMap;
     constructor(id?: string);
     registerCSS(css: string): this;
-    registerBaseStyle(selector: string, styleNames: string | readonly string[]): this;
-    generateRootCSS(): string;
-    generateBaseStyleCSS(): string;
     generateCSS(): string;
     injectAll(targetDocument?: Document): HTMLStyleElement;
     reset(): void;

package/dist/styling/styleRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styleRegistry.d.ts","sourceRoot":"","sources":["../../src/styling/styleRegistry.ts"],"names":[],"mappings":"AAaA,oEAAoE;AACpE,qBAAa,aAAa;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwC;gBAEzD,EAAE,GAAE,MAAsC;IAKtD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM9B,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI;IAqBjF,eAAe,IAAI,MAAM;IAsBzB,oBAAoB,IAAI,MAAM;IAiB9B,WAAW,IAAI,MAAM;IAQrB,SAAS,CAAC,cAAc,GAAE,QAA8B,GAAG,gBAAgB;IAgB3E,KAAK,IAAI,IAAI;CAIhB;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD;AAED,0EAA0E;AAC1E,eAAO,MAAM,aAAa,eAAwB,CAAA"}
+{"version":3,"file":"styleRegistry.d.ts","sourceRoot":"","sources":["../../src/styling/styleRegistry.ts"],"names":[],"mappings":"AAgBA,oEAAoE;AACpE,qBAAa,aAAa;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;gBAElD,EAAE,GAAE,MAAsC;IAKtD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAiC9B,WAAW,IAAI,MAAM;IAQrB,SAAS,CAAC,cAAc,GAAE,QAA8B,GAAG,gBAAgB;IAgB3E,KAAK,IAAI,IAAI;CAGhB;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD;AAED,0EAA0E;AAC1E,eAAO,MAAM,aAAa,eAAwB,CAAA"}

package/dist/styling/theme.d.ts

@@ -1,11 +1,17 @@
 export type FrayStylesheetKind = 'theme' | 'colors';
+export type FrayAppearance = 'light' | 'dark' | 'system';
+export type FrayThemeAppearanceCapability = 'light' | 'dark' | 'adaptive';
 export interface FrayStylesheetOption {
     value: string;
     label: string;
     href: string;
 }
+export interface FrayThemeOption extends FrayStylesheetOption {
+    /** Appearance modes the selected theme deliberately supports. */
+    appearance: FrayThemeAppearanceCapability;
+}
 export type FrayThemeVariableLayer = 'palette' | 'theme';
-export type FrayThemeVariableValue = 'background' | 'border' | 'color' | 'dimension' | 'duration' | 'font' | 'radius' | 'shadow';
+export type FrayThemeVariableValue = 'background' | 'border' | 'color' | 'dimension' | 'duration' | 'font' | 'opacity' | 'radius' | 'shadow';
 export interface FrayThemeVariableDefinition {
     name: `--${string}`;
     layer: FrayThemeVariableLayer;
@@ -19,9 +25,15 @@ export interface FrayThemeVariableDefinition {
  * back through a family rather than forcing every theme to target every host.
  */
 export declare const frayThemeVariableCatalog: readonly FrayThemeVariableDefinition[];
-export declare const frayThemeOptions: readonly FrayStylesheetOption[];
+export declare const frayThemeOptions: readonly FrayThemeOption[];
 export declare const frayColorOptions: readonly FrayStylesheetOption[];
 /** Replace one of the two independently loaded Fray presentation stylesheets. */
 export declare function replaceFrayStylesheet(kind: FrayStylesheetKind, selection: FrayStylesheetOption, targetDocument?: Document): HTMLLinkElement;
+/**
+ * Select how an adaptive Fray theme resolves its light and dark mappings.
+ * `system` removes the root attribute so the browser preference applies.
+ */
+export declare function setFrayAppearance(appearance: FrayAppearance, targetDocument?: Document): void;
+export declare function getFrayAppearance(targetDocument?: Document): FrayAppearance;
 export declare function findFrayStylesheetOption(options: readonly FrayStylesheetOption[], value: string): FrayStylesheetOption;
 //# sourceMappingURL=theme.d.ts.map

package/dist/styling/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/styling/theme.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEnD,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,OAAO,CAAA;AACxD,MAAM,MAAM,sBAAsB,GAC5B,YAAY,GACZ,QAAQ,GACR,OAAO,GACP,WAAW,GACX,UAAU,GACV,MAAM,GACN,QAAQ,GACR,QAAQ,CAAA;AAEd,MAAM,WAAW,2BAA2B;IACxC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAA;IACnB,KAAK,EAAE,sBAAsB,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,sBAAsB,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,wCAmHc,CAAA;AAEnD,eAAO,MAAM,gBAAgB,iCAI3B,CAAA;AAEF,eAAO,MAAM,gBAAgB,iCAS3B,CAAA;AAEF,iFAAiF;AACjF,wBAAgB,qBAAqB,CACjC,IAAI,EAAE,kBAAkB,EACxB,SAAS,EAAE,oBAAoB,EAC/B,cAAc,GAAE,QAA8B,GAC/C,eAAe,CAoBjB;AAED,wBAAgB,wBAAwB,CACpC,OAAO,EAAE,SAAS,oBAAoB,EAAE,EACxC,KAAK,EAAE,MAAM,GACd,oBAAoB,CAItB"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/styling/theme.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,QAAQ,CAAA;AACnD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AACxD,MAAM,MAAM,6BAA6B,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAA;AAEzE,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IACzD,iEAAiE;IACjE,UAAU,EAAE,6BAA6B,CAAA;CAC5C;AAED,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,OAAO,CAAA;AACxD,MAAM,MAAM,sBAAsB,GAC5B,YAAY,GACZ,QAAQ,GACR,OAAO,GACP,WAAW,GACX,UAAU,GACV,MAAM,GACN,SAAS,GACT,QAAQ,GACR,QAAQ,CAAA;AAEd,MAAM,WAAW,2BAA2B;IACxC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAA;IACnB,KAAK,EAAE,sBAAsB,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,sBAAsB,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,wCAqIc,CAAA;AAEnD,eAAO,MAAM,gBAAgB,4BAI3B,CAAA;AAEF,eAAO,MAAM,gBAAgB,iCAS3B,CAAA;AAEF,iFAAiF;AACjF,wBAAgB,qBAAqB,CACjC,IAAI,EAAE,kBAAkB,EACxB,SAAS,EAAE,oBAAoB,EAC/B,cAAc,GAAE,QAA8B,GAC/C,eAAe,CAoBjB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,UAAU,EAAE,cAAc,EAC1B,cAAc,GAAE,QAA8B,GAC/C,IAAI,CASN;AAED,wBAAgB,iBAAiB,CAC7B,cAAc,GAAE,QAA8B,GAC/C,cAAc,CAMhB;AAED,wBAAgB,wBAAwB,CACpC,OAAO,EAAE,SAAS,oBAAoB,EAAE,EACxC,KAAK,EAAE,MAAM,GACd,oBAAoB,CAItB"}

package/package.json

@@ -2,7 +2,7 @@
   "type": "module",
   "name": "@sylwellsoftware/fray",
   "private": false,
-  "version": "0.6.0",
+  "version": "1.0.0",
   "description": "Browser-only TypeScript component runtime, JSX controls, and semantic themes.",
   "license": "Apache-2.0",
   "author": {
@@ -45,10 +45,9 @@
       "import": "./dist/jsx-dev-runtime.js"
     },
     "./styles/structural.css": "./styles/structural.css",
+    "./themes/base.css": "./themes/base.css",
     "./themes/*/theme.css": "./themes/*/theme.css",
-    "./colors/*/colors.css": "./colors/*/colors.css",
-    "./themes/light.css": "./themes/light.css",
-    "./themes/dark.css": "./themes/dark.css"
+    "./colors/*/colors.css": "./colors/*/colors.css"
   },
   "files": [
     "dist",
@@ -64,11 +63,11 @@
     "./themes/**/*.css"
   ],
   "peerDependencies": {
-    "@sylwellsoftware/glue": "^0.6.0"
+    "@sylwellsoftware/glue": "^0.8.0"
   },
   "devDependencies": {
     "vite": "^6.3.5",
-    "@sylwellsoftware/glue": "^0.6.0"
+    "@sylwellsoftware/glue": "^0.8.0"
   },
   "engines": {
     "node": ">=22",