dsh-plugin-subscription-usage 0.0.0-stage → 0.2.0

package/lib/client/index.js

@@ -0,0 +1,113 @@
+import { en, zh, LOCALE_NS } from './locales.js';
+import { css } from './styles.js';
+import { SubscriptionsStore } from './store.js';
+import { PrefsStore } from './prefs.js';
+import { ProviderCard } from './ProviderCard.js';
+import { Footer } from './Footer.js';
+import { Usage, UsageNavIcon } from './Usage.js';
+import { Gauge } from './Gauge.js';
+import { Notice } from './Notice.js';
+import { ImageGenerateToolview, createImageLoader } from './ImageGenerateToolview.js';
+import { VideoGenerateToolview, createVideoLoader } from './VideoGenerateToolview.js';
+import { SpeedSelect, createSpeedLoader, createSpeedSetter } from './SpeedSelect.js';
+import { fastCommandDescription } from './fast-command.js';
+/** The Host entry id from cordis.patch.yml; the Models page dispatches our card by it. */
+const ENTRY_ID = 'subscription-models';
+export const inject = ['slots', 'connection', 'locale'];
+const hasMethod = (value, name) => typeof value === 'object' && value !== null && name in value && typeof value[name] === 'function';
+export function apply(ctx) {
+    ctx.effect(() => ctx.locale.register(LOCALE_NS, { en, zh }), 'dsh-plugin-subscription-usage: copy');
+    ctx.effect(() => {
+        const style = document.createElement('style');
+        style.dataset.plugin = 'dsh-plugin-subscription-usage';
+        style.textContent = css;
+        document.head.appendChild(style);
+        return () => { style.remove(); };
+    }, 'dsh-plugin-subscription-usage: stylesheet');
+    // In the browser the `connection` key holds the full client handle.
+    const connection = ctx.get('connection');
+    const t = ctx.locale.bind(LOCALE_NS);
+    const store = new SubscriptionsStore(connection.rpc);
+    const prefs = new PrefsStore();
+    const surface = () => ({ store, prefs, rpc: connection.rpc, t });
+    ctx.inject(['configForms'], scope => {
+        const forms = scope.get('configForms');
+        if (!hasMethod(forms, 'get'))
+            return;
+        scope.effect(() => prefs.bind(forms.get(ENTRY_ID)), 'dsh-plugin-subscription-usage: usage preferences');
+    });
+    ctx.slots.inject('settings.models.provider-card', () => ctx.slots.register({
+        name: 'settings.models.provider-card', key: ENTRY_ID, inject: surface,
+    }, ProviderCard));
+    ctx.slots.inject('settings.models.footer', () => ctx.slots.register({
+        name: 'settings.models.footer', id: 'subscription-models', order: 10, inject: surface,
+    }, Footer));
+    ctx.slots.inject('settings.section', () => ctx.slots.register({
+        name: 'settings.section', id: 'subscription-usage', order: 11, label: () => t('usage'), inject: surface,
+    }, Usage));
+    // The nav row keeps the shell's gear unless an icon is registered under the section id.
+    ctx.slots.inject('settings.section.icon', () => ctx.slots.register({
+        name: 'settings.section.icon', id: 'subscription-usage',
+    }, UsageNavIcon));
+    const models = () => {
+        const service = ctx.get('modelDirectories');
+        return hasMethod(service, 'directoryFor') ? service : undefined;
+    };
+    const gaugeInject = (sessionId) => {
+        let currentModel;
+        try {
+            currentModel = models()?.directoryFor(sessionId).store;
+        }
+        catch {
+            // An unknown session has no directory yet; the gauge then follows pinned providers only.
+        }
+        return { ...surface(), sessionId, currentModel };
+    };
+    ctx.slots.inject('conversation.composer.dock', () => ctx.slots.register({
+        name: 'conversation.composer.dock', id: 'subscription-models.gauge', order: 10, inject: gaugeInject,
+    }, Gauge));
+    ctx.slots.inject('conversation.hero.options', () => ctx.slots.register({
+        name: 'conversation.hero.options', id: 'subscription-models.gauge', order: 10, inject: gaugeInject,
+    }, Gauge));
+    ctx.slots.inject('shell.overlay', () => ctx.slots.register({
+        name: 'shell.overlay', id: 'subscription-models.notice', order: 50, inject: surface,
+    }, Notice));
+    ctx.slots.inject('tool.call.toolview', () => ctx.slots.register({
+        name: 'tool.call.toolview', key: 'image_generate', locale: LOCALE_NS,
+        inject: () => ({ load: createImageLoader(connection.rpc) }),
+    }, ImageGenerateToolview));
+    ctx.slots.inject('tool.call.toolview', () => ctx.slots.register({
+        name: 'tool.call.toolview', key: 'video_generate', locale: LOCALE_NS,
+        inject: () => ({ loadVideo: createVideoLoader(connection.rpc) }),
+    }, VideoGenerateToolview));
+    ctx.slots.inject('conversation.input.right', () => ctx.slots.register({
+        name: 'conversation.input.right', id: 'codex-speed', order: 0, locale: LOCALE_NS,
+        inject: (sessionId) => ({
+            loadSpeed: createSpeedLoader(connection, models, sessionId),
+            setSpeed: createSpeedSetter(connection, sessionId, models),
+        }),
+    }, SpeedSelect));
+    ctx.inject(['commandUi'], (scope) => {
+        const command = scope.get('commandUi');
+        scope.effect(() => command.register({
+            name: 'fast',
+            description: fastCommandDescription(() => t('commandFast')),
+            available: () => true,
+            ui: {
+                kind: 'popupSelect',
+                options: async (session) => {
+                    const state = await createSpeedLoader(connection, models, session.sessionId)();
+                    if (!state.visible)
+                        throw new Error(t('commandFastUnavailable'));
+                    return [
+                        { id: 'standard', label: t('speedStandard'), detail: t('speedStandardDescription') },
+                        { id: 'fast', label: t('speedFast'), detail: t('speedFastDescription') },
+                    ].map(option => ({ ...option, active: option.id === state.tier }));
+                },
+                onSelect: async (option, session) => {
+                    await createSpeedSetter(connection, session.sessionId, models)(option.id === 'fast' ? 'fast' : 'standard');
+                },
+            },
+        }), 'dsh-plugin-subscription-usage: /fast');
+    });
+}

package/lib/client/locales.d.ts

@@ -0,0 +1,139 @@
+/** Copy for every Client surface of this plugin, in one locale namespace. */
+export declare const en: {
+    readonly signIn: "Sign in";
+    readonly signInAgain: "Sign in";
+    readonly noApiKey: "No API key needed";
+    readonly signInExpired: "Sign-in expired";
+    readonly signedIn: "Signed in";
+    readonly signInNeeded: "Sign-in needed";
+    readonly manage: "Manage";
+    readonly modelsCount: "{visible}/{total} models";
+    readonly modelsCountTitle: "Models shown in the picker";
+    readonly refreshUsage: "Refresh usage";
+    readonly refreshUsageNamed: "Refresh {name} usage";
+    readonly refreshedWait: "Refreshed. Again in {seconds}s";
+    readonly defaultAccount: "Default account";
+    readonly servingAccount: "Serving this session";
+    readonly live: "live";
+    readonly liveTitle: "Updates with every response";
+    readonly agoShort: "{time} ago";
+    readonly staleShort: "{time} old";
+    readonly staleTitle: "Refresh failed. Retrying {when}";
+    readonly noUsageData: "No usage data";
+    readonly noUsageDataTitle: "This provider does not publish usage";
+    readonly usageUnavailable: "Usage unavailable";
+    readonly moreAccounts: "{count} more accounts";
+    readonly stepTabOpened: "Tab opened";
+    readonly stepApprove: "Approve access";
+    readonly stepLoadModels: "Load models";
+    readonly stepCodeIssued: "Code issued";
+    readonly stepWaitingGithub: "Waiting for GitHub";
+    readonly pasteRedirect: "Paste redirect URL instead";
+    readonly pastePlaceholder: "Redirect URL or code";
+    readonly continue: "Continue";
+    readonly cancel: "Cancel";
+    readonly copyCode: "Copy code";
+    readonly claudeImport: "Import Claude Code";
+    readonly claudeBrowser: "Browser sign-in";
+    readonly tabAccounts: "Accounts";
+    readonly tabModels: "Models";
+    readonly tabTools: "Tools";
+    readonly pool: "Pool";
+    readonly poolInclude: "Include {account} in the pool";
+    readonly makeDefault: "Make default";
+    readonly signOut: "Sign out";
+    readonly addAccount: "Add account";
+    readonly searchModels: "Search {count} models";
+    readonly showInPicker: "Show {model} in the picker";
+    readonly pickerCount: "{visible} of {total} in the picker";
+    readonly autoShowNew: "Show new models automatically";
+    readonly selectAll: "Select all";
+    readonly deselectAll: "Deselect all";
+    readonly effortFor: "Default effort for {model}";
+    readonly effortAuto: "Auto";
+    readonly toolWebSearch: "Web search";
+    readonly toolImage: "Image generation";
+    readonly toolVideo: "Video generation";
+    readonly toolXSearch: "X search";
+    readonly toolsNote: "Applies to new sessions";
+    readonly save: "Save";
+    readonly saving: "Saving…";
+    readonly saveFailed: "Could not save: {message}";
+    readonly loadFailed: "Could not load: {message}";
+    readonly window5h: "5h";
+    readonly window7d: "7d";
+    readonly windowOther: "limit";
+    readonly resetsIn: "in {time}";
+    readonly emptyAt: "empty {time}";
+    readonly backAt: "back {time}";
+    readonly tipUsedLeft: "{used}% used · {left}% left";
+    readonly tipElapsed: "{percent}% of the window has passed";
+    readonly tipPace: "Pace: ~{percent}% by reset";
+    readonly tipResets: "Resets {time}";
+    readonly tipCount: "{used} of {limit} used";
+    readonly notReported: "Not reported";
+    readonly subscriptions: "Subscriptions";
+    readonly addProvider: "Add a provider";
+    readonly apiKey: "API key";
+    readonly addKey: "Add";
+    readonly removeKey: "Remove key";
+    readonly keyHelp: "Paste an API key. It is checked once, then stored on this machine.";
+    readonly keyChecking: "Checking key…";
+    readonly usageEmpty: "Sign in to a subscription in Models to see its usage here.";
+    readonly composerUsage: "Composer usage";
+    readonly composerUsageNote: "Current model plus pinned";
+    readonly showQuotaAs: "Show quota as";
+    readonly displayLeft: "Left";
+    readonly displayUsed: "Used";
+    readonly paceWarnings: "Pace warnings";
+    readonly proxy: "Proxy";
+    readonly proxyOff: "Off";
+    readonly proxyOn: "On";
+    readonly configure: "Configure";
+    readonly proxyUrl: "Proxy URL";
+    readonly proxyBypass: "Bypass hosts, comma separated";
+    readonly proxyEnabled: "Use this proxy";
+    readonly proxyTest: "Test";
+    readonly proxyTestOk: "HTTP {status} in {ms} ms";
+    readonly usage: "Usage";
+    readonly usageLabel: "Subscription usage";
+    readonly refreshNow: "Refresh now";
+    readonly usageSettings: "Usage settings";
+    readonly pin: "Pin to composer";
+    readonly unpin: "Unpin from composer";
+    readonly otherProviders: "{count} more";
+    readonly noticeEmpty: "{provider} {window} empty around {time}";
+    readonly noticeOut: "{provider} {window} limit reached";
+    readonly noticeSwitched: "{provider} limit reached. Switched to {account}";
+    readonly dismiss: "Dismiss";
+    readonly generating: "Generating image…";
+    readonly generatingVideo: "Generating video…";
+    readonly image: "image";
+    readonly imageClose: "Close";
+    readonly imageLoadFailed: "Retry";
+    readonly imageLoading: "Loading…";
+    readonly imagePreview: "Image preview";
+    readonly speed: "Speed";
+    readonly speedStandard: "Standard";
+    readonly speedStandardDescription: "Default speed";
+    readonly speedFast: "Fast";
+    readonly speedFastDescription: "1.5x speed, more usage";
+    readonly videoLoadFailed: "Video failed to load: {message}";
+    readonly videoLoading: "Loading video…";
+    readonly viewImage: "View image";
+    readonly viewImageNamed: "View {name}";
+    readonly commandFast: "Switch the Codex speed tier (Standard/Fast)";
+    readonly commandFastUnavailable: "The current model has no fast tier; /fast only works on Codex models whose catalog advertises one";
+};
+/** Every copy key. */
+export type SubscriptionsKey = keyof typeof en;
+/** The locale namespace this plugin registers. */
+export declare const LOCALE_NS = "subscription-models";
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        'subscription-models': SubscriptionsKey;
+    }
+}
+export declare const zh: Record<SubscriptionsKey, string>;
+/** Fill `{name}` placeholders. */
+export declare function format(text: string, params?: Record<string, string | number>): string;

package/lib/client/locales.js

@@ -0,0 +1,267 @@
+/** Copy for every Client surface of this plugin, in one locale namespace. */
+export const en = {
+    // Provider card
+    signIn: 'Sign in',
+    signInAgain: 'Sign in',
+    noApiKey: 'No API key needed',
+    signInExpired: 'Sign-in expired',
+    signedIn: 'Signed in',
+    signInNeeded: 'Sign-in needed',
+    manage: 'Manage',
+    modelsCount: '{visible}/{total} models',
+    modelsCountTitle: 'Models shown in the picker',
+    refreshUsage: 'Refresh usage',
+    refreshUsageNamed: 'Refresh {name} usage',
+    refreshedWait: 'Refreshed. Again in {seconds}s',
+    defaultAccount: 'Default account',
+    servingAccount: 'Serving this session',
+    live: 'live',
+    liveTitle: 'Updates with every response',
+    agoShort: '{time} ago',
+    staleShort: '{time} old',
+    staleTitle: 'Refresh failed. Retrying {when}',
+    noUsageData: 'No usage data',
+    noUsageDataTitle: 'This provider does not publish usage',
+    usageUnavailable: 'Usage unavailable',
+    moreAccounts: '{count} more accounts',
+    // Sign-in flow
+    stepTabOpened: 'Tab opened',
+    stepApprove: 'Approve access',
+    stepLoadModels: 'Load models',
+    stepCodeIssued: 'Code issued',
+    stepWaitingGithub: 'Waiting for GitHub',
+    pasteRedirect: 'Paste redirect URL instead',
+    pastePlaceholder: 'Redirect URL or code',
+    continue: 'Continue',
+    cancel: 'Cancel',
+    copyCode: 'Copy code',
+    claudeImport: 'Import Claude Code',
+    claudeBrowser: 'Browser sign-in',
+    // Manage panel
+    tabAccounts: 'Accounts',
+    tabModels: 'Models',
+    tabTools: 'Tools',
+    pool: 'Pool',
+    poolInclude: 'Include {account} in the pool',
+    makeDefault: 'Make default',
+    signOut: 'Sign out',
+    addAccount: 'Add account',
+    searchModels: 'Search {count} models',
+    showInPicker: 'Show {model} in the picker',
+    pickerCount: '{visible} of {total} in the picker',
+    autoShowNew: 'Show new models automatically',
+    selectAll: 'Select all',
+    deselectAll: 'Deselect all',
+    effortFor: 'Default effort for {model}',
+    effortAuto: 'Auto',
+    toolWebSearch: 'Web search',
+    toolImage: 'Image generation',
+    toolVideo: 'Video generation',
+    toolXSearch: 'X search',
+    toolsNote: 'Applies to new sessions',
+    save: 'Save',
+    saving: 'Saving…',
+    saveFailed: 'Could not save: {message}',
+    loadFailed: 'Could not load: {message}',
+    // Window labels and times
+    window5h: '5h',
+    window7d: '7d',
+    windowOther: 'limit',
+    resetsIn: 'in {time}',
+    emptyAt: 'empty {time}',
+    backAt: 'back {time}',
+    tipUsedLeft: '{used}% used · {left}% left',
+    tipElapsed: '{percent}% of the window has passed',
+    tipPace: 'Pace: ~{percent}% by reset',
+    tipResets: 'Resets {time}',
+    tipCount: '{used} of {limit} used',
+    notReported: 'Not reported',
+    // Footer
+    subscriptions: 'Subscriptions',
+    addProvider: 'Add a provider',
+    apiKey: 'API key',
+    addKey: 'Add',
+    removeKey: 'Remove key',
+    keyHelp: 'Paste an API key. It is checked once, then stored on this machine.',
+    keyChecking: 'Checking key…',
+    usageEmpty: 'Sign in to a subscription in Models to see its usage here.',
+    composerUsage: 'Composer usage',
+    composerUsageNote: 'Current model plus pinned',
+    showQuotaAs: 'Show quota as',
+    displayLeft: 'Left',
+    displayUsed: 'Used',
+    paceWarnings: 'Pace warnings',
+    proxy: 'Proxy',
+    proxyOff: 'Off',
+    proxyOn: 'On',
+    configure: 'Configure',
+    proxyUrl: 'Proxy URL',
+    proxyBypass: 'Bypass hosts, comma separated',
+    proxyEnabled: 'Use this proxy',
+    proxyTest: 'Test',
+    proxyTestOk: 'HTTP {status} in {ms} ms',
+    // Gauge and popover
+    usage: 'Usage',
+    usageLabel: 'Subscription usage',
+    refreshNow: 'Refresh now',
+    usageSettings: 'Usage settings',
+    pin: 'Pin to composer',
+    unpin: 'Unpin from composer',
+    otherProviders: '{count} more',
+    // Notices
+    noticeEmpty: '{provider} {window} empty around {time}',
+    noticeOut: '{provider} {window} limit reached',
+    noticeSwitched: '{provider} limit reached. Switched to {account}',
+    dismiss: 'Dismiss',
+    // Retained upstream surfaces
+    generating: 'Generating image…',
+    generatingVideo: 'Generating video…',
+    image: 'image',
+    imageClose: 'Close',
+    imageLoadFailed: 'Retry',
+    imageLoading: 'Loading…',
+    imagePreview: 'Image preview',
+    speed: 'Speed',
+    speedStandard: 'Standard',
+    speedStandardDescription: 'Default speed',
+    speedFast: 'Fast',
+    speedFastDescription: '1.5x speed, more usage',
+    videoLoadFailed: 'Video failed to load: {message}',
+    videoLoading: 'Loading video…',
+    viewImage: 'View image',
+    viewImageNamed: 'View {name}',
+    commandFast: 'Switch the Codex speed tier (Standard/Fast)',
+    commandFastUnavailable: 'The current model has no fast tier; /fast only works on Codex models whose catalog advertises one',
+};
+/** The locale namespace this plugin registers. */
+export const LOCALE_NS = 'subscription-models';
+export const zh = {
+    signIn: '登录',
+    signInAgain: '重新登录',
+    noApiKey: '无需 API 密钥',
+    signInExpired: '登录已过期',
+    signedIn: '已登录',
+    signInNeeded: '需要登录',
+    manage: '管理',
+    modelsCount: '{visible}/{total} 个模型',
+    modelsCountTitle: '模型选择器中显示的模型',
+    refreshUsage: '刷新用量',
+    refreshUsageNamed: '刷新 {name} 用量',
+    refreshedWait: '已刷新，{seconds} 秒后可再次刷新',
+    defaultAccount: '默认账号',
+    servingAccount: '正在为本会话服务',
+    live: '实时',
+    liveTitle: '每次回复后更新',
+    agoShort: '{time}前',
+    staleShort: '已过 {time}',
+    staleTitle: '刷新失败，{when}重试',
+    noUsageData: '无用量数据',
+    noUsageDataTitle: '该服务商不提供用量数据',
+    usageUnavailable: '用量不可用',
+    moreAccounts: '另外 {count} 个账号',
+    stepTabOpened: '已打开标签页',
+    stepApprove: '批准访问',
+    stepLoadModels: '加载模型',
+    stepCodeIssued: '已生成代码',
+    stepWaitingGithub: '等待 GitHub',
+    pasteRedirect: '改为粘贴回调 URL',
+    pastePlaceholder: '回调 URL 或授权码',
+    continue: '继续',
+    cancel: '取消',
+    copyCode: '复制代码',
+    claudeImport: '导入 Claude Code',
+    claudeBrowser: '浏览器登录',
+    tabAccounts: '账号',
+    tabModels: '模型',
+    tabTools: '工具',
+    pool: '账号池',
+    poolInclude: '将 {account} 加入账号池',
+    makeDefault: '设为默认',
+    signOut: '退出登录',
+    addAccount: '添加账号',
+    searchModels: '搜索 {count} 个模型',
+    showInPicker: '在选择器中显示 {model}',
+    pickerCount: '选择器中显示 {visible}/{total}',
+    autoShowNew: '自动显示新模型',
+    selectAll: '全选',
+    deselectAll: '全不选',
+    effortFor: '{model} 的默认推理强度',
+    effortAuto: '自动',
+    toolWebSearch: '网页搜索',
+    toolImage: '图片生成',
+    toolVideo: '视频生成',
+    toolXSearch: 'X 搜索',
+    toolsNote: '对新会话生效',
+    save: '保存',
+    saving: '保存中…',
+    saveFailed: '保存失败：{message}',
+    loadFailed: '加载失败：{message}',
+    window5h: '5h',
+    window7d: '7d',
+    windowOther: '限额',
+    resetsIn: '{time}后',
+    emptyAt: '{time} 用尽',
+    backAt: '{time} 恢复',
+    tipUsedLeft: '已用 {used}% · 剩余 {left}%',
+    tipElapsed: '窗口已过 {percent}%',
+    tipPace: '按当前速度：重置前约用 {percent}%',
+    tipResets: '{time} 重置',
+    tipCount: '已用 {used} / {limit}',
+    notReported: '未提供',
+    subscriptions: '订阅',
+    addProvider: '添加提供商',
+    apiKey: 'API 密钥',
+    addKey: '添加',
+    removeKey: '移除密钥',
+    keyHelp: '粘贴 API 密钥。验证一次后保存在本机。',
+    keyChecking: '正在验证密钥…',
+    usageEmpty: '在“模型”中登录订阅后，可在此查看用量。',
+    composerUsage: '输入框用量',
+    composerUsageNote: '当前模型和已固定',
+    showQuotaAs: '额度显示为',
+    displayLeft: '剩余',
+    displayUsed: '已用',
+    paceWarnings: '速度预警',
+    proxy: '代理',
+    proxyOff: '关闭',
+    proxyOn: '开启',
+    configure: '配置',
+    proxyUrl: '代理 URL',
+    proxyBypass: '绕过的主机，逗号分隔',
+    proxyEnabled: '使用此代理',
+    proxyTest: '测试',
+    proxyTestOk: 'HTTP {status}，耗时 {ms} ms',
+    usage: '用量',
+    usageLabel: '订阅用量',
+    refreshNow: '立即刷新',
+    usageSettings: '用量设置',
+    pin: '固定到输入框',
+    unpin: '从输入框取消固定',
+    otherProviders: '另外 {count} 个',
+    noticeEmpty: '{provider} {window} 预计 {time} 用尽',
+    noticeOut: '{provider} {window} 已达上限',
+    noticeSwitched: '{provider} 已达上限，已切换到 {account}',
+    dismiss: '关闭',
+    generating: '正在生成图片…',
+    generatingVideo: '正在生成视频…',
+    image: '图片',
+    imageClose: '关闭',
+    imageLoadFailed: '重试',
+    imageLoading: '加载中…',
+    imagePreview: '图片预览',
+    speed: '速度',
+    speedStandard: '标准',
+    speedStandardDescription: '默认速度',
+    speedFast: '快速',
+    speedFastDescription: '约 1.5 倍速度，消耗更多用量',
+    videoLoadFailed: '视频加载失败：{message}',
+    videoLoading: '视频加载中…',
+    viewImage: '查看图片',
+    viewImageNamed: '查看 {name}',
+    commandFast: '切换 Codex 速度档（标准/快速）',
+    commandFastUnavailable: '当前模型不支持快速档；/fast 仅对目录声明了 fast tier 的 Codex 模型可用',
+};
+/** Fill `{name}` placeholders. */
+export function format(text, params = {}) {
+    return text.replace(/\{(\w+)\}/g, (match, key) => (key in params ? String(params[key]) : match));
+}

package/lib/client/meter.d.ts

@@ -0,0 +1,91 @@
+import type { UsageWindow } from '../providers/common.js';
+import type { Pace, QuotaDisplay } from '../usage/pace.js';
+import type { SubscriptionsKey } from './locales.js';
+export type T = (key: SubscriptionsKey) => string;
+/** Translate with placeholders. */
+export declare function tf(t: T, key: SubscriptionsKey, params: Record<string, string | number>): string;
+declare const PATHS: {
+    readonly refresh: import("react").JSX.Element;
+    readonly alert: import("react").JSX.Element;
+    readonly check: import("react").JSX.Element;
+    readonly star: import("react").JSX.Element;
+    readonly bolt: import("react").JSX.Element;
+    readonly pin: import("react").JSX.Element;
+    readonly pinFilled: import("react").JSX.Element;
+    readonly gear: import("react").JSX.Element;
+    readonly ext: import("react").JSX.Element;
+    readonly copy: import("react").JSX.Element;
+    readonly x: import("react").JSX.Element;
+    readonly right: import("react").JSX.Element;
+    readonly down: import("react").JSX.Element;
+    readonly meter: import("react").JSX.Element;
+    readonly sparkle: import("react").JSX.Element;
+};
+export type IconName = keyof typeof PATHS;
+/** One 16-unit stroke icon. */
+export declare function Icon({ name, size, className }: {
+    name: IconName;
+    size?: number;
+    className?: string;
+}): import("react").JSX.Element;
+/** "3h 6m", "2d 12h", "42m". */
+export declare function shortDuration(ms: number): string;
+/**
+ * A short point in time in the browser's locale: "6:04 PM" today, "Wed" within
+ * the week, "12 Nov" beyond. The day alone keeps the time column narrow; the
+ * tooltip carries the exact reset time.
+ */
+export declare function clockTime(at: number, now: number): string;
+/** Weekday and time, for tooltips. */
+export declare function fullTime(at: number): string;
+/** The window's length as "5h", "7d" or "30d", rounded to a whole unit; undefined when unknown. */
+export declare function lengthLabel(durationMs: number | undefined): string | undefined;
+/** "5h", "7d", "30d": the window's own length, else its kind, else "limit". */
+export declare function kindLabel(t: T, kind: UsageWindow['kind'], durationMs?: number): string;
+/** The length label, with a model scope when the window has one. A per-model quota is named by its scope alone. */
+export declare function windowLabel(t: T, window: UsageWindow): string;
+/** A window as shown, with the models it stands for when several share one quota. */
+export type ShownWindow = UsageWindow & {
+    models?: string[];
+};
+/**
+ * Per-model windows that report the same usage and reset share one quota pool
+ * (Antigravity reports one window per model), so they merge into one row named
+ * by model family. A per-model window at 0% with no reset carries no information
+ * and is hidden. Unscoped windows pass through unchanged.
+ */
+export declare function shownWindows(windows: readonly UsageWindow[] | undefined): ShownWindow[];
+/**
+ * What compact surfaces show: unscoped windows, session first. A provider that
+ * only reports per-model windows (Antigravity) shows its two most used instead.
+ */
+export declare function primaryWindows(windows: readonly UsageWindow[] | undefined): ShownWindow[];
+/** The pace bar: fill is quota, hatch is the forecast, color is the pace state. Drains in `left` mode. */
+export declare function Bar({ window, p, display, height }: {
+    window: UsageWindow;
+    p: Pace;
+    display: QuotaDisplay;
+    height?: number;
+}): import("react").JSX.Element;
+/** One window on the shared grid: label | bar | value | time. */
+export declare function WindowRow({ t, window, display, now }: {
+    t: T;
+    window: ShownWindow;
+    display: QuotaDisplay;
+    now: number;
+}): import("react").JSX.Element;
+/** Label, small bar and value, for summary rows and the gauge. */
+export declare function Mini({ t, window, display, now }: {
+    t: T;
+    window: ShownWindow;
+    display: QuotaDisplay;
+    now: number;
+}): import("react").JSX.Element;
+/** The mini meters of an account's unscoped windows. */
+export declare function Minis({ t, windows, display, now }: {
+    t: T;
+    windows: readonly UsageWindow[] | undefined;
+    display: QuotaDisplay;
+    now: number;
+}): import("react").JSX.Element | null;
+export {};