import type { DocumentSync } from './documentSync.js';
export interface TokenDef {
    /** CSS variable name — e.g. `--app-color-surface-brand`. */
    name: string;
    /** Value for swatch display (hex, etc., light). The canvas is rendered with var(name) so it is for display only. */
    value: string;
    /** Dark mode value (if present, displays the swatch as half light/dark). */
    dark?: string;
    /** Optional group label. */
    group?: string;
}
/** The part of a runtime's document sync a token edit queues into. */
export type TokenSyncQueue = Pick<DocumentSync, 'queueTokenDesignChange'>;
/** One editor's design tokens and the overrides the designer applied. */
export declare function createTokens(): {
    setTokens: (t: TokenDef[]) => void;
    getTokens: () => TokenDef[];
    setOnTokensChange: (cb: ((changed: {
        name: string;
        value: string;
    }[]) => void) | null) => void;
    getTokenValue: (name: string) => string;
    getTokenOverrides: () => {
        name: string;
        value: string;
    }[];
    replaceTokenOverrides: (next: readonly {
        name: string;
        value: string;
    }[]) => void;
    applyTokenOverride: (sync: TokenSyncQueue, name: string, value: string) => void;
    resetTokenOverrides: (sync: TokenSyncQueue) => void;
};
export type Tokens = ReturnType<typeof createTokens>;