@moldable-ai/ui 0.2.29 → 0.2.32

package/dist/components/ui/toolbar.js

@@ -3,8 +3,8 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { cn } from '../../lib/utils.js';
 import { Separator } from './separator.js';
 import { Text } from './text.js';
-import { cva } from 'class-variance-authority';
 import { handleWindowTitlebarDoubleClick, handleWindowTitlebarMouseDown, } from './window-titlebar.js';
+import { cva } from 'class-variance-authority';
 const toolbarVariants = cva('z-20 flex min-h-toolbar w-full shrink-0 items-center gap-control-gap px-control-inline', {
     variants: {
         variant: {
@@ -18,7 +18,7 @@ const toolbarVariants = cva('z-20 flex min-h-toolbar w-full shrink-0 items-cente
             none: '',
         },
         density: {
-            compact: 'py-1',
+            compact: 'py-2',
             default: 'py-1.5',
             comfortable: 'py-2',
         },
@@ -68,7 +68,7 @@ function ToolbarContent({ className, ...props }) {
     return (_jsx("div", { "data-slot": "toolbar-content", className: cn('flex min-w-0 flex-1 flex-col', className), ...props }));
 }
 function ToolbarTitle({ className, ...props }) {
-    return (_jsx(Text, { as: "h2", variant: "strong", truncate: true, "data-slot": "toolbar-title", className: cn('text-[15px] font-medium', className), ...props }));
+    return (_jsx(Text, { as: "h2", variant: "strong", truncate: true, "data-slot": "toolbar-title", className: cn('text-[13px] font-bold leading-[15px]', className), ...props }));
 }
 function ToolbarDescription({ className, ...props }) {
     return (_jsx(Text, { as: "p", variant: "small", color: "secondary", truncate: true, "data-slot": "toolbar-description", className: className, ...props }));

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { cn } from './lib/utils.js';
-export { ThemeProvider, useTheme, themeScript, type Theme } from './lib/theme.js';
+export { ThemeProvider, useTheme, themeScript, type Theme, type ThemeProviderProps, } from './lib/theme.js';
+export * from './tokens/index.js';
 export { WorkspaceProvider, useWorkspace, WORKSPACE_HEADER, } from './lib/workspace.js';
 export { useMoldableCommands, useMoldableCommand, useMoldableAppCommands, useMoldableWindowShortcuts, useMoldableNavigationPop, useMoldableNavigationState, isInMoldable, sendToMoldable, pushMoldableNavigation, popMoldableNavigation, resetMoldableNavigation, downloadFile, publishMoldableArtifact, setMoldableWindowFullscreen, type AppCommand, type CommandAction, type CommandsResponse, type CommandMessage, type MoldableNavigationEntry, type MoldableNavigationPopMessage, type MoldableNavigationStateMessage, type MoldableWindowShortcut, type MoldableWindowShortcutDefaults, type DownloadFileOptions, type MoldableArtifactFile, type MoldableArtifactPublishOptions, type MoldableArtifactPublishResult, type MoldableWindowFullscreenMode, type MoldableWindowFullscreenOptions, type MoldableWindowFullscreenResult, type MoldableWindowFullscreenMessage, type MoldableWindowFullscreenResultMessage, } from './lib/commands.js';
 export * from './lib/native-capabilities/index.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,7 +1,9 @@
 // Export utilities
 export { cn } from './lib/utils.js';
 // Export theme
-export { ThemeProvider, useTheme, themeScript } from './lib/theme.js';
+export { ThemeProvider, useTheme, themeScript, } from './lib/theme.js';
+// Export design-system contracts
+export * from './tokens/index.js';
 // Export workspace
 export { WorkspaceProvider, useWorkspace, WORKSPACE_HEADER, } from './lib/workspace.js';
 // Export commands

package/dist/lib/frame-lifecycle.d.ts

@@ -31,6 +31,7 @@ export interface MoldableHostContextMessage {
     platform?: 'macos' | 'windows' | 'linux' | 'unknown';
     windowId?: string;
     nativeMaterial?: {
+        background?: unknown;
         regions?: {
             sidebar?: unknown;
         };

package/dist/lib/frame-lifecycle.d.ts.map

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

package/dist/lib/frame-lifecycle.js

@@ -156,6 +156,13 @@ export function applyMoldableHostContext(message) {
         delete root.dataset.moldableNativeMaterialSidebar;
         clearSidebarMaterialRegion();
     }
+    if (message.displayMode === 'window' &&
+        message.nativeMaterial?.background === true) {
+        root.dataset.moldableNativeMaterialBackground = 'available';
+    }
+    else {
+        delete root.dataset.moldableNativeMaterialBackground;
+    }
     const insets = message.safeInsets;
     if (insets) {
         applyBoundedLength('--window-safe-area-top', insets.top);

package/dist/lib/theme.d.ts

@@ -1,15 +1,49 @@
 import { type ReactNode } from 'react';
-export type Theme = 'light' | 'dark' | 'system';
-type ResolvedTheme = 'light' | 'dark';
+import type { ControlSize, MaterialContext, ResolvedUIAppearance, UIAppearance, UIPlatform, UIPlatformPack, UIPlatformVersion, UIPreferences, UISidebarStyle, UITheme } from '../tokens/contracts.js';
+/** @deprecated Use UIAppearance. */
+export type Theme = UIAppearance;
+/** @deprecated Use ResolvedUIAppearance. */
+type ResolvedTheme = ResolvedUIAppearance;
 interface ThemeContextValue {
+    uiTheme: UITheme;
+    setUITheme: (theme: UITheme) => void;
+    platform: UIPlatform;
+    platformVersion: UIPlatformVersion;
+    platformPack: UIPlatformPack;
+    setPlatformPack: (platform: UIPlatform, version: UIPlatformVersion) => void;
+    sidebarStyle: UISidebarStyle;
+    setSidebarStyle: (style: UISidebarStyle) => void;
+    appearance: UIAppearance;
+    resolvedAppearance: ResolvedUIAppearance;
+    setAppearance: (appearance: UIAppearance) => void;
+    controlSize: ControlSize;
+    setControlSize: (controlSize: ControlSize) => void;
+    materialContext: MaterialContext;
+    setMaterialContext: (materialContext: MaterialContext) => void;
+    preferences: UIPreferences;
+    /** @deprecated Use appearance. */
     theme: Theme;
+    /** @deprecated Use resolvedAppearance. */
     resolvedTheme: ResolvedTheme;
+    /** @deprecated Use setAppearance. */
     setTheme: (theme: Theme) => void;
 }
-export declare function ThemeProvider({ children }: {
+export interface ThemeProviderProps {
     children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+    platform?: UIPlatform;
+    platformVersion?: UIPlatformVersion;
+    uiTheme?: UITheme;
+    sidebarStyle?: UISidebarStyle;
+    appearance?: UIAppearance;
+    controlSize?: ControlSize;
+    materialContext?: MaterialContext;
+    preferences?: UIPreferences;
+    storageKey?: string | false;
+}
+export declare function ThemeProvider({ children, platform, platformVersion, uiTheme: uiThemeProp, sidebarStyle: sidebarStyleProp, appearance: appearanceProp, controlSize: controlSizeProp, materialContext: materialContextProp, preferences, storageKey, }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useTheme(): ThemeContextValue;
+/** Internal-friendly optional access for components that also work standalone. */
+export declare function useOptionalTheme(): ThemeContextValue | null;
 /**
  * Inline script to prevent theme flash on page load.
  * Add this to your <head> in layout.tsx:
@@ -20,6 +54,6 @@ export declare function useTheme(): ThemeContextValue;
  * </head>
  * ```
  */
-export declare const themeScript = "\n(function() {\n  var params = new URLSearchParams(window.location.search);\n  var theme = params.get('theme');\n  if (!theme) {\n    theme = localStorage.getItem('moldable-theme');\n  }\n  if (theme === 'system' || !theme) {\n    theme = window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';\n  }\n  document.documentElement.classList.add(theme);\n})();\n";
+export declare const themeScript = "\n(function() {\n  var params = new URLSearchParams(window.location.search);\n  var theme = params.get('theme');\n  if (!theme) {\n    theme = localStorage.getItem('moldable-theme');\n  }\n  if (theme === 'system' || !theme) {\n    theme = window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';\n  }\n  document.documentElement.classList.add(theme);\n  document.documentElement.dataset.uiTheme = 'moldable';\n  document.documentElement.dataset.uiPlatform = 'macos';\n  document.documentElement.dataset.uiPlatformVersion = '27';\n  document.documentElement.dataset.uiPlatformPack = 'macos-27';\n  document.documentElement.dataset.uiSidebarStyle = 'edge-to-edge';\n  document.documentElement.dataset.uiAppearance = theme;\n  document.documentElement.dataset.controlSize = 'medium';\n  document.documentElement.dataset.materialContext = 'content';\n})();\n";
 export {};
 //# sourceMappingURL=theme.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/lib/theme.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAA;AAGd,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AAC/C,KAAK,aAAa,GAAG,OAAO,GAAG,MAAM,CAAA;AAErC,UAAU,iBAAiB;IACzB,KAAK,EAAE,KAAK,CAAA;IACZ,aAAa,EAAE,aAAa,CAAA;IAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACjC;AA6CD,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CA0ClE;AAED,wBAAgB,QAAQ,sBAMvB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,kYAYvB,CAAA"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/lib/theme.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAA;AAEd,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,OAAO,EACR,MAAM,qBAAqB,CAAA;AAG5B,oCAAoC;AACpC,MAAM,MAAM,KAAK,GAAG,YAAY,CAAA;AAChC,4CAA4C;AAC5C,KAAK,aAAa,GAAG,oBAAoB,CAAA;AAEzC,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACpC,QAAQ,EAAE,UAAU,CAAA;IACpB,eAAe,EAAE,iBAAiB,CAAA;IAClC,YAAY,EAAE,cAAc,CAAA;IAC5B,eAAe,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;IAC3E,YAAY,EAAE,cAAc,CAAA;IAC5B,eAAe,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;IAChD,UAAU,EAAE,YAAY,CAAA;IACxB,kBAAkB,EAAE,oBAAoB,CAAA;IACxC,aAAa,EAAE,CAAC,UAAU,EAAE,YAAY,KAAK,IAAI,CAAA;IACjD,WAAW,EAAE,WAAW,CAAA;IACxB,cAAc,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAA;IAClD,eAAe,EAAE,eAAe,CAAA;IAChC,kBAAkB,EAAE,CAAC,eAAe,EAAE,eAAe,KAAK,IAAI,CAAA;IAC9D,WAAW,EAAE,aAAa,CAAA;IAC1B,kCAAkC;IAClC,KAAK,EAAE,KAAK,CAAA;IACZ,0CAA0C;IAC1C,aAAa,EAAE,aAAa,CAAA;IAC5B,qCAAqC;IACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACjC;AAMD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAA;IACnB,QAAQ,CAAC,EAAE,UAAU,CAAA;IACrB,eAAe,CAAC,EAAE,iBAAiB,CAAA;IACnC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,YAAY,CAAC,EAAE,cAAc,CAAA;IAC7B,UAAU,CAAC,EAAE,YAAY,CAAA;IACzB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,WAAW,CAAC,EAAE,aAAa,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;CAC5B;AA2CD,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,QAAkB,EAClB,eAAsB,EACtB,OAAO,EAAE,WAAwB,EACjC,YAAY,EAAE,gBAAgB,EAC9B,UAAU,EAAE,cAAc,EAC1B,WAAW,EAAE,eAA0B,EACvC,eAAe,EAAE,mBAA+B,EAChD,WAAgB,EAChB,UAAwB,GACzB,EAAE,kBAAkB,2CA+IpB;AAED,wBAAgB,QAAQ,sBAMvB;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,6BAE/B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,i3BAoBvB,CAAA"}

package/dist/lib/theme.js

@@ -2,6 +2,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useCallback, useContext, useEffect, useState, } from 'react';
 import { TooltipProvider } from '../components/ui/tooltip.js';
+import { resolvePlatformPack } from '../tokens/contracts.js';
 const ThemeContext = createContext(null);
 const STORAGE_KEY = 'moldable-theme';
 function getSystemTheme() {
@@ -22,14 +23,16 @@ function getUrlTheme() {
     }
     return null;
 }
-function getStoredTheme() {
+function getStoredTheme(storageKey = STORAGE_KEY) {
     if (typeof window === 'undefined')
         return 'system';
     // URL parameter takes precedence (for iframe embedding)
     const urlTheme = getUrlTheme();
     if (urlTheme)
         return urlTheme;
-    const stored = localStorage.getItem(STORAGE_KEY);
+    if (!storageKey)
+        return 'system';
+    const stored = localStorage.getItem(storageKey);
     if (stored === 'light' || stored === 'dark' || stored === 'system') {
         return stored;
     }
@@ -41,36 +44,109 @@ function resolveTheme(theme) {
     }
     return theme;
 }
-export function ThemeProvider({ children }) {
-    const [theme, setThemeState] = useState(() => getStoredTheme());
-    const [resolvedTheme, setResolvedTheme] = useState(() => resolveTheme(theme));
-    const setTheme = useCallback((newTheme) => {
-        setThemeState(newTheme);
-        localStorage.setItem(STORAGE_KEY, newTheme);
+export function ThemeProvider({ children, platform = 'macos', platformVersion = '27', uiTheme: uiThemeProp = 'moldable', sidebarStyle: sidebarStyleProp, appearance: appearanceProp, controlSize: controlSizeProp = 'medium', materialContext: materialContextProp = 'content', preferences = {}, storageKey = STORAGE_KEY, }) {
+    const [platformSelection, setPlatformSelection] = useState(platform);
+    const [platformVersionSelection, setPlatformVersionSelection] = useState(platformVersion);
+    const platformPack = resolvePlatformPack(platformSelection, platformVersionSelection);
+    const [uiTheme, setUIThemeState] = useState(uiThemeProp);
+    const [sidebarStyle, setSidebarStyle] = useState(() => sidebarStyleProp ?? 'edge-to-edge');
+    const [appearance, setAppearanceState] = useState(() => appearanceProp ?? getStoredTheme(storageKey));
+    const [resolvedAppearance, setResolvedAppearance] = useState(() => resolveTheme(appearance));
+    const [controlSize, setControlSize] = useState(controlSizeProp);
+    const [materialContext, setMaterialContext] = useState(materialContextProp);
+    const setAppearance = useCallback((newAppearance) => {
+        setAppearanceState(newAppearance);
+        if (storageKey && typeof window !== 'undefined') {
+            localStorage.setItem(storageKey, newAppearance);
+        }
+    }, [storageKey]);
+    const setPlatformPack = useCallback((nextPlatform, nextVersion) => {
+        setPlatformSelection(nextPlatform);
+        setPlatformVersionSelection(nextVersion);
     }, []);
-    // Apply theme to document
+    const setUITheme = useCallback((nextTheme) => {
+        setUIThemeState(nextTheme);
+        if (sidebarStyleProp === undefined) {
+            setSidebarStyle('edge-to-edge');
+        }
+    }, [sidebarStyleProp]);
+    useEffect(() => setPlatformSelection(platform), [platform]);
+    useEffect(() => setPlatformVersionSelection(platformVersion), [platformVersion]);
+    useEffect(() => {
+        setUIThemeState(uiThemeProp);
+        setSidebarStyle(sidebarStyleProp ?? 'edge-to-edge');
+    }, [sidebarStyleProp, uiThemeProp]);
     useEffect(() => {
-        const resolved = resolveTheme(theme);
-        setResolvedTheme(resolved);
+        if (appearanceProp)
+            setAppearanceState(appearanceProp);
+    }, [appearanceProp]);
+    useEffect(() => setControlSize(controlSizeProp), [controlSizeProp]);
+    useEffect(() => setMaterialContext(materialContextProp), [materialContextProp]);
+    useEffect(() => {
+        const resolved = resolveTheme(appearance);
+        setResolvedAppearance(resolved);
         const root = document.documentElement;
         root.classList.remove('light', 'dark');
         root.classList.add(resolved);
-    }, [theme]);
-    // Listen for system theme changes
+        root.dataset.uiTheme = uiTheme;
+        root.dataset.uiPlatform = platformPack.platform;
+        root.dataset.uiPlatformVersion = platformPack.version;
+        root.dataset.uiPlatformPack = platformPack.id;
+        root.dataset.uiSidebarStyle = sidebarStyle;
+        root.dataset.uiAppearance = resolved;
+        root.dataset.controlSize = controlSize;
+        root.dataset.materialContext = materialContext;
+        root.dataset.contrast = preferences.contrast ?? 'system';
+        root.dataset.transparency = preferences.transparency ?? 'system';
+        root.dataset.motion = preferences.motion ?? 'system';
+    }, [
+        appearance,
+        controlSize,
+        materialContext,
+        preferences.contrast,
+        preferences.motion,
+        preferences.transparency,
+        platformPack.id,
+        platformPack.platform,
+        platformPack.version,
+        sidebarStyle,
+        uiTheme,
+    ]);
     useEffect(() => {
-        if (theme !== 'system')
+        if (appearance !== 'system')
             return;
         const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
         const handleChange = () => {
             const resolved = getSystemTheme();
-            setResolvedTheme(resolved);
+            setResolvedAppearance(resolved);
             document.documentElement.classList.remove('light', 'dark');
             document.documentElement.classList.add(resolved);
+            document.documentElement.dataset.uiAppearance = resolved;
         };
         mediaQuery.addEventListener('change', handleChange);
         return () => mediaQuery.removeEventListener('change', handleChange);
-    }, [theme]);
-    return (_jsx(ThemeContext.Provider, { value: { theme, resolvedTheme, setTheme }, children: _jsx(TooltipProvider, { children: children }) }));
+    }, [appearance]);
+    return (_jsx(ThemeContext.Provider, { value: {
+            uiTheme,
+            setUITheme,
+            platform: platformPack.platform,
+            platformVersion: platformPack.version,
+            platformPack,
+            setPlatformPack,
+            sidebarStyle,
+            setSidebarStyle,
+            appearance,
+            resolvedAppearance,
+            setAppearance,
+            controlSize,
+            setControlSize,
+            materialContext,
+            setMaterialContext,
+            preferences,
+            theme: appearance,
+            resolvedTheme: resolvedAppearance,
+            setTheme: setAppearance,
+        }, children: _jsx(TooltipProvider, { children: children }) }));
 }
 export function useTheme() {
     const context = useContext(ThemeContext);
@@ -79,6 +155,10 @@ export function useTheme() {
     }
     return context;
 }
+/** Internal-friendly optional access for components that also work standalone. */
+export function useOptionalTheme() {
+    return useContext(ThemeContext);
+}
 /**
  * Inline script to prevent theme flash on page load.
  * Add this to your <head> in layout.tsx:
@@ -100,5 +180,13 @@ export const themeScript = `
     theme = window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
   }
   document.documentElement.classList.add(theme);
+  document.documentElement.dataset.uiTheme = 'moldable';
+  document.documentElement.dataset.uiPlatform = 'macos';
+  document.documentElement.dataset.uiPlatformVersion = '27';
+  document.documentElement.dataset.uiPlatformPack = 'macos-27';
+  document.documentElement.dataset.uiSidebarStyle = 'edge-to-edge';
+  document.documentElement.dataset.uiAppearance = theme;
+  document.documentElement.dataset.controlSize = 'medium';
+  document.documentElement.dataset.materialContext = 'content';
 })();
 `;

package/dist/tokens/contracts.d.ts

@@ -0,0 +1,79 @@
+export type UITheme = 'platform' | 'moldable';
+export type UIPlatform = 'macos' | 'windows' | 'web';
+export type UIPlatformVersion = string;
+/**
+ * A component recipe can intentionally come from a different versioned
+ * platform source than the application's base platform pack.
+ *
+ * Public names describe the anatomy an app is choosing. The registry below
+ * records which immutable platform source defines each recipe.
+ */
+export type UISidebarStyle = 'platform' | 'floating' | 'edge-to-edge';
+export type PlatformPackId = `${UIPlatform}-${string}`;
+export interface UIPlatformPack {
+    id: PlatformPackId;
+    platform: UIPlatform;
+    version: UIPlatformVersion;
+    capabilities: {
+        nativeMaterials: boolean;
+        nativeWindowChrome: boolean;
+        overlayScrollbars: boolean;
+    };
+}
+export type UIAppearance = 'light' | 'dark' | 'system';
+export type ResolvedUIAppearance = Exclude<UIAppearance, 'system'>;
+export type ControlSize = 'mini' | 'small' | 'medium' | 'large' | 'xl';
+export type LayoutDensity = 'compact' | 'regular' | 'comfortable';
+export type MaterialThickness = 'ultra-thick' | 'thick' | 'medium' | 'thin' | 'ultra-thin';
+export type MaterialContext = 'content' | 'over-glass';
+export type ContrastPreference = 'system' | 'standard' | 'increased';
+export type TransparencyPreference = 'system' | 'standard' | 'reduced';
+export type MotionPreference = 'system' | 'standard' | 'reduced';
+export interface UIPreferences {
+    contrast?: ContrastPreference;
+    transparency?: TransparencyPreference;
+    motion?: MotionPreference;
+}
+export declare const CONTROL_SIZES: readonly ["mini", "small", "medium", "large", "xl"];
+export declare const MATERIAL_THICKNESSES: readonly ["ultra-thick", "thick", "medium", "thin", "ultra-thin"];
+export declare const SIDEBAR_STYLES: {
+    readonly platform: {
+        readonly id: "platform";
+        readonly sourcePlatform: null;
+        readonly sourceVersion: null;
+    };
+    readonly floating: {
+        readonly id: "floating";
+        readonly sourcePlatform: "macos";
+        readonly sourceVersion: "26";
+    };
+    readonly 'edge-to-edge': {
+        readonly id: "edge-to-edge";
+        readonly sourcePlatform: "macos";
+        readonly sourceVersion: "27";
+    };
+};
+export declare const PLATFORM_PACKS: {
+    readonly 'macos-27': {
+        readonly id: "macos-27";
+        readonly platform: "macos";
+        readonly version: "27";
+        readonly capabilities: {
+            readonly nativeMaterials: true;
+            readonly nativeWindowChrome: true;
+            readonly overlayScrollbars: true;
+        };
+    };
+    readonly 'web-default': {
+        readonly id: "web-default";
+        readonly platform: "web";
+        readonly version: "default";
+        readonly capabilities: {
+            readonly nativeMaterials: false;
+            readonly nativeWindowChrome: false;
+            readonly overlayScrollbars: false;
+        };
+    };
+};
+export declare function resolvePlatformPack(platform: UIPlatform, version: UIPlatformVersion): UIPlatformPack;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/tokens/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/tokens/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,UAAU,CAAA;AAE7C,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,CAAA;AAEpD,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,CAAA;AAErE,MAAM,MAAM,cAAc,GAAG,GAAG,UAAU,IAAI,MAAM,EAAE,CAAA;AAEtD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,cAAc,CAAA;IAClB,QAAQ,EAAE,UAAU,CAAA;IACpB,OAAO,EAAE,iBAAiB,CAAA;IAC1B,YAAY,EAAE;QACZ,eAAe,EAAE,OAAO,CAAA;QACxB,kBAAkB,EAAE,OAAO,CAAA;QAC3B,iBAAiB,EAAE,OAAO,CAAA;KAC3B,CAAA;CACF;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEtD,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;AAElE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAA;AAEtE,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAA;AAEjE,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,OAAO,GACP,QAAQ,GACR,MAAM,GACN,YAAY,CAAA;AAEhB,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,YAAY,CAAA;AAEtD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAA;AAEpE,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;AAEtE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;AAEhE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,YAAY,CAAC,EAAE,sBAAsB,CAAA;IACrC,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAC1B;AAED,eAAO,MAAM,aAAa,qDAMiB,CAAA;AAE3C,eAAO,MAAM,oBAAoB,mEAMgB,CAAA;AAEjD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;CAuB1B,CAAA;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;CAqBwB,CAAA;AAEnD,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,UAAU,EACpB,OAAO,EAAE,iBAAiB,GACzB,cAAc,CAMhB"}

package/dist/tokens/contracts.js

@@ -0,0 +1,57 @@
+export const CONTROL_SIZES = [
+    'mini',
+    'small',
+    'medium',
+    'large',
+    'xl',
+];
+export const MATERIAL_THICKNESSES = [
+    'ultra-thick',
+    'thick',
+    'medium',
+    'thin',
+    'ultra-thin',
+];
+export const SIDEBAR_STYLES = {
+    platform: {
+        id: 'platform',
+        sourcePlatform: null,
+        sourceVersion: null,
+    },
+    floating: {
+        id: 'floating',
+        sourcePlatform: 'macos',
+        sourceVersion: '26',
+    },
+    'edge-to-edge': {
+        id: 'edge-to-edge',
+        sourcePlatform: 'macos',
+        sourceVersion: '27',
+    },
+};
+export const PLATFORM_PACKS = {
+    'macos-27': {
+        id: 'macos-27',
+        platform: 'macos',
+        version: '27',
+        capabilities: {
+            nativeMaterials: true,
+            nativeWindowChrome: true,
+            overlayScrollbars: true,
+        },
+    },
+    'web-default': {
+        id: 'web-default',
+        platform: 'web',
+        version: 'default',
+        capabilities: {
+            nativeMaterials: false,
+            nativeWindowChrome: false,
+            overlayScrollbars: false,
+        },
+    },
+};
+export function resolvePlatformPack(platform, version) {
+    const exact = Object.values(PLATFORM_PACKS).find((pack) => pack.platform === platform && pack.version === version);
+    return exact ?? PLATFORM_PACKS['web-default'];
+}

package/dist/tokens/index.d.ts

@@ -0,0 +1,2 @@
+export { CONTROL_SIZES, MATERIAL_THICKNESSES, PLATFORM_PACKS, SIDEBAR_STYLES, resolvePlatformPack, type ContrastPreference, type ControlSize, type LayoutDensity, type MaterialContext, type MaterialThickness, type MotionPreference, type PlatformPackId, type ResolvedUIAppearance, type TransparencyPreference, type UIAppearance, type UIPlatform, type UIPlatformPack, type UIPlatformVersion, type UIPreferences, type UISidebarStyle, type UITheme, } from './contracts.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tokens/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,OAAO,GACb,MAAM,aAAa,CAAA"}

package/dist/tokens/index.js

@@ -0,0 +1 @@
+export { CONTROL_SIZES, MATERIAL_THICKNESSES, PLATFORM_PACKS, SIDEBAR_STYLES, resolvePlatformPack, } from './contracts.js';

package/docs/README.md

@@ -8,6 +8,8 @@ feels at home on macOS without imitating private platform implementation.
 
 - [Foundations](./foundations.md)
 - [Design tokens](./design-tokens.md)
+- [Platform architecture](./platform-architecture.md)
+- [macOS design audit](./macos-design-audit.md)
 - [Adaptive materials](./adaptive-materials.md)
 - [App anatomy](./app-anatomy.md)
 - [Standalone app windows](./standalone-app-windows.md)

package/docs/adaptive-materials.md

@@ -6,14 +6,15 @@ not replace content surfaces.
 
 ## Roles
 
-Use `regular` material for normal toolbar and window chrome, grouped controls,
-menus, and temporary control overlays. It provides enough frosting for text
-and icons to remain stable as content moves behind it.
+Choose `ultra-thick`, `thick`, `medium`, `thin`, or `ultra-thin` according to
+the surface hierarchy. Medium material is the normal choice for window chrome,
+grouped controls, menus, and temporary control overlays.
 
-Use `clear` material only for compact controls floating over photos, maps,
+Use ultra-thin material only for compact controls floating over photos, maps,
 video, or another richly colored canvas. Check the control against the
 lightest, darkest, and busiest content it can cover. If contrast is not stable,
-use `regular`.
+use medium. The `regular` and `clear` names remain compatibility aliases for
+`medium` and `ultra-thin`, respectively.
 
 Documents, calendars, tables, forms, cards, sheets, inspectors, and primary
 working canvases remain opaque. Do not stack translucent content cards to
@@ -24,7 +25,7 @@ create hierarchy.
 `Material` applies one adaptive surface:
 
 ```tsx
-<Material asChild variant="clear" shape="circle" interactive>
+<Material asChild variant="ultra-thin" shape="circle" interactive>
   <IconButton label="Center map" variant="ghost">
     <Locate />
   </IconButton>
@@ -34,7 +35,7 @@ create hierarchy.
 `MaterialGroup` applies one sampled layer to a related cluster:
 
 ```tsx
-<MaterialGroup variant="regular" shape="capsule" spacing="compact">
+<MaterialGroup variant="medium" shape="capsule" spacing="compact">
   <IconButton label="Previous" variant="ghost">
     <ChevronLeft />
   </IconButton>
@@ -75,5 +76,9 @@ sampled layers and avoid nesting them.
 CSS material samples content inside the app renderer. It cannot sample the
 desktop behind a native window. Native behind-window material, window
 transparency, active-window appearance, and energy policy remain host-owned
-capabilities. Apps should use the same semantic variants regardless of which
-adapter renders them.
+capabilities. Apps should use the same thickness roles regardless of which
+adapter renders them. Apps opt into native regions per window through
+`moldable.json`; renderer-owned background and sidebar surfaces additionally
+opt in through `AppFrame`. Full-window background material uses a frosted,
+tinted host surface rather than uncovered transparency. Content that needs a
+stable reading surface can remain opaque above it.

package/docs/design-tokens.md

@@ -114,8 +114,9 @@ disabled, and invalid states. Disabled wins over pointer states. Focus remains
 visible when combined with selected or invalid. Selection is durable state;
 hover is not a substitute for it.
 
-Focus rings use the neutral translucent `--ring` token at one pixel. Never use
-plain `focus:` ring utilities or accent colors for keyboard focus.
+Focus rings use the shared `--ring` token and the width defined by each
+component recipe. Never use plain `focus:` ring utilities or invent a
+component-local focus color.
 
 Do not use state-layer colors as arbitrary fills. Prefer the shared component
 when one exists.
@@ -141,11 +142,14 @@ stay theme-aware and do not inherit Moldable's legacy brand orange. Apps may
 override the complete series palette at a theme boundary, but chart
 components and stories should never embed raw series colors.
 
-Adaptive material has two semantic variants. Each includes fill, fallback,
-border, highlight, blur, and saturation tokens:
+Adaptive material has five standard thickness variants: `ultra-thick`,
+`thick`, `medium`, `thin`, and `ultra-thin`. Each includes fill, fallback,
+border, highlight, blur, and saturation tokens. `regular` remains a
+compatibility alias for `medium`, and `clear` remains a compatibility alias
+for `ultra-thin`.
 
-- `--material-regular-*` supports normal toolbar and control chrome.
-- `--material-clear-*` supports compact controls over media or a richly
+- Medium material supports normal toolbar and control chrome.
+- Ultra-thin material supports compact controls over media or a richly
   colored canvas.
 - `shadow-panel`, `shadow-overlay`, `shadow-dialog`, and `shadow-window`
   provide elevation independently from translucency.

package/docs/foundations.md

@@ -22,9 +22,9 @@ Status color communicates status only; it is not decoration.
 - Preserve usable pointer targets even when the visible control is small.
 - Prefer separators, background shifts, and whitespace over nested cards.
 - Working panes own scrolling. The window shell should not accidentally scroll.
-- Set `data-density="compact"`, `"default"`, or `"comfortable"` at a
-  composition boundary. Components should consume density tokens rather than
-  inventing per-screen heights.
+- Set `data-density="compact"` or `"comfortable"` at a composition boundary;
+  omit it for regular/default density. Components should consume density
+  tokens rather than inventing per-screen heights.
 
 ## Surfaces