@genispace/geniapp 0.3.0 → 0.4.0

package/dist/components/internal/shared-ui/components/features/knowledge/HighlightedSnippet.d.ts

@@ -0,0 +1,14 @@
+import { HTMLAttributes, ReactNode } from 'react';
+
+export interface HighlightRange {
+    start: number;
+    end: number;
+}
+export interface HighlightedSnippetProps extends HTMLAttributes<HTMLSpanElement> {
+    text: string;
+    query?: string;
+    ranges?: HighlightRange[];
+    renderHighlight?: (value: string, index: number) => ReactNode;
+}
+/** Render server/query highlights as React nodes, never as injected HTML. */
+export declare function HighlightedSnippet({ text, query, ranges, renderHighlight, className, ...props }: HighlightedSnippetProps): import("react").JSX.Element;

package/dist/components/internal/shared-ui/components/features/knowledge/index.d.ts

@@ -0,0 +1,2 @@
+export { EvidenceCitation, type EvidenceCitationProps, type EvidenceLocator, type EvidenceReference, } from './EvidenceCitation';
+export { HighlightedSnippet, type HighlightedSnippetProps, type HighlightRange, } from './HighlightedSnippet';

package/dist/components/internal/shared-ui/components/features/notification/NotificationBell.d.ts

@@ -0,0 +1,14 @@
+import { NotificationApiClient } from './NotificationList';
+
+interface NotificationBellProps {
+    apiClient: NotificationApiClient;
+    onViewAll?: () => void;
+    getUnreadCount?: () => Promise<{
+        success: boolean;
+        data: {
+            total: number;
+        };
+    }>;
+}
+export declare function NotificationBell({ apiClient, onViewAll, getUnreadCount }: NotificationBellProps): import("react").JSX.Element;
+export {};

package/dist/components/internal/shared-ui/components/features/notification/NotificationList.d.ts

@@ -0,0 +1,41 @@
+export interface Notification {
+    id: string;
+    title: string;
+    content: string;
+    type: 'INFO' | 'WARN' | 'ERROR' | 'SUCCESS' | 'ALERT' | 'SYSTEM';
+    scope: 'USER' | 'TEAM' | 'PLATFORM';
+    status: 'UNREAD' | 'READ' | 'ARCHIVED';
+    priority: 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT';
+    createdAt: string;
+    readAt: string | null;
+    relatedUrl: string | null;
+    senderUser?: {
+        id: string;
+        name: string;
+        avatarUrl: string | null;
+    };
+    actions?: {
+        id: string;
+        label: string;
+        url: string | null;
+        action: string | null;
+    }[];
+}
+export interface NotificationApiClient {
+    get: (url: string, config?: unknown) => Promise<{
+        data: unknown;
+    }>;
+    patch: (url: string, data?: unknown) => Promise<{
+        data: unknown;
+    }>;
+}
+interface NotificationListProps {
+    apiClient: NotificationApiClient;
+    onClose?: () => void;
+    onViewAll?: () => void;
+    maxHeight?: string;
+    showHeader?: boolean;
+    isPopover?: boolean;
+}
+export declare function NotificationList({ apiClient, onViewAll, maxHeight, showHeader, isPopover }: NotificationListProps): import("react").JSX.Element;
+export {};

package/dist/components/internal/shared-ui/components/features/notification/index.d.ts

@@ -0,0 +1,2 @@
+export * from './NotificationList';
+export * from './NotificationBell';

package/dist/components/internal/shared-ui/components/features/operator/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/internal/shared-ui/components/features/rbac/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/internal/shared-ui/components/features/rich-text/RichTextField.d.ts

@@ -0,0 +1,13 @@
+export interface RichTextFieldProps {
+    value: string;
+    onChange: (html: string) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    className?: string;
+    minHeight?: string;
+}
+/**
+ * Tiptap-based rich text (P2). Stores HTML; use for long description/narration fields.
+ * Requires peer deps: @tiptap/react, @tiptap/starter-kit, @tiptap/extension-underline, @tiptap/extension-placeholder.
+ */
+export declare function RichTextField({ value, onChange, placeholder, disabled, className, minHeight, }: RichTextFieldProps): import("react").JSX.Element;

package/dist/components/internal/shared-ui/components/features/space/SpaceContext.d.ts

@@ -0,0 +1,121 @@
+import { default as React, ReactNode } from 'react';
+import { SpaceSettings } from '../../../../shared-utils/index.ts';
+
+export type SubscriptionPlan = 'FREE' | 'PERSONAL' | 'PRO' | 'TEAM' | 'ENTERPRISE';
+export interface SpaceOwner {
+    id: string;
+    name: string;
+    email: string;
+    subscriptionPlan: SubscriptionPlan;
+    subscriptionExpiry: string;
+}
+export interface Space {
+    id: string;
+    name: string;
+    description: string;
+    type: 'personal' | 'collaborative';
+    role?: 'owner' | 'admin' | 'member' | 'viewer';
+    memberCount?: number;
+    createdAt: string;
+    updatedAt?: string;
+    avatar?: string | null;
+    members?: SpaceMember[];
+    currentUserRole?: string;
+    owner?: SpaceOwner;
+    subscriptionPlan?: SubscriptionPlan;
+    settings?: SpaceSettings;
+    resources?: {
+        total: number;
+        agents: number;
+        operators: number;
+        knowledgeBases: number;
+        tasks: number;
+    };
+}
+export interface SpaceMember {
+    id: string;
+    name: string;
+    email: string;
+    avatar?: string | null;
+    role: string;
+    roleName?: string;
+    joinedAt?: string;
+    status?: string;
+    lastActive?: string | null;
+}
+export declare const roleColors: {
+    OWNER: string;
+    ADMINISTRATOR: string;
+    ADMIN: string;
+    MEMBER: string;
+    VIEWER: string;
+    owner: string;
+    admin: string;
+    member: string;
+    viewer: string;
+};
+export declare const useRoleNames: () => {
+    OWNER: string;
+    ADMINISTRATOR: string;
+    ADMIN: string;
+    MEMBER: string;
+    VIEWER: string;
+    owner: string;
+    administrator: string;
+    member: string;
+    viewer: string;
+};
+export declare const getRoleName: (role: string, language?: string) => string;
+export declare const getRoleNameEn: (role: string) => string;
+export declare const getRoleClass: (role: string) => string;
+export declare const getSpaceIconType: (space: Space) => "personal" | "personal-pro" | "space" | "enterprise";
+export declare const getSpaceIconStyle: (space: Space) => string;
+export interface SpaceApiClient {
+    get: (url: string, params?: Record<string, unknown>, config?: any) => Promise<{
+        success: boolean;
+        data: unknown;
+        message?: string;
+    }>;
+    post: (url: string, data?: unknown, config?: any) => Promise<{
+        success: boolean;
+        data: unknown;
+        message?: string;
+    }>;
+    put: (url: string, data?: unknown, config?: any) => Promise<{
+        success: boolean;
+        data: unknown;
+        message?: string;
+    }>;
+}
+interface SpaceContextType {
+    spaces: Space[];
+    /** @deprecated Use `spaces` — compat alias until Phase 7 */
+    teams: Space[];
+    currentSpace: Space | null;
+    spaceMembers: SpaceMember[];
+    loading: boolean;
+    isSwitchingSpace: boolean;
+    error: string | null;
+    fetchSpaces: () => Promise<void>;
+    switchSpace: (space: Space, options?: {
+        skipNavigation?: boolean;
+    }) => Promise<void>;
+    fetchSpaceMembers: (spaceId: string) => Promise<void>;
+    updateCurrentSpaceSettings: (settings: SpaceSettings) => void;
+}
+export declare const SpaceContext: React.Context<SpaceContextType>;
+export interface SpaceProviderProps {
+    apiClient: SpaceApiClient;
+    user?: {
+        isLoggedIn?: boolean;
+    } | null;
+    onNavigate?: (path: string, options?: {
+        replace?: boolean;
+    }) => void;
+    onSpaceSwitch?: (spaceId: string) => void | Promise<void>;
+    spaceSwitchRedirectPath?: string;
+    children: ReactNode;
+}
+export declare const SpaceProvider: React.FC<SpaceProviderProps>;
+export declare const useSpace: () => SpaceContextType;
+export {};

package/dist/components/internal/shared-ui/components/features/space/SpaceSwitcher.d.ts

@@ -0,0 +1,13 @@
+export interface SpaceSwitcherProps {
+    className?: string;
+    manageSpaceUrl?: string;
+    createSpaceUrl?: string;
+    /** @deprecated Use manageSpaceUrl */
+    manageTeamUrl?: string;
+    /** @deprecated Use createSpaceUrl */
+    createTeamUrl?: string;
+    openSpaceLinksInExternalBrowser?: boolean;
+    /** @deprecated Use openSpaceLinksInExternalBrowser */
+    openTeamLinksInExternalBrowser?: boolean;
+}
+export declare function SpaceSwitcher({ className, manageSpaceUrl, createSpaceUrl, manageTeamUrl, createTeamUrl, openSpaceLinksInExternalBrowser, openTeamLinksInExternalBrowser, }: SpaceSwitcherProps): import("react").JSX.Element;

package/dist/components/internal/shared-ui/components/features/space/index.d.ts

@@ -0,0 +1,2 @@
+export * from './SpaceContext';
+export * from './SpaceSwitcher';

package/dist/components/internal/shared-ui/components/features/subscription/SubscriptionContext.d.ts

@@ -0,0 +1,26 @@
+import { ReactNode } from 'react';
+import { SubscriptionContext as SubscriptionContextType, SubscriptionPlan, FeatureKey, ResourceType, UpgradePrompt } from './types';
+
+interface SubscriptionContextValue {
+    context: SubscriptionContextType;
+    isLoading: boolean;
+    error: Error | null;
+    isStandalone: boolean;
+    canAccess: (featureKey: FeatureKey) => boolean;
+    hasPlan: (requiredPlan: SubscriptionPlan) => boolean;
+    checkLimit: (resourceType: ResourceType, currentCount?: number) => boolean;
+    getFeatureUpgradePrompt: (featureKey: FeatureKey) => UpgradePrompt | null;
+    getResourceUpgradePrompt: (resourceType: ResourceType) => UpgradePrompt | null;
+    refresh: () => Promise<void>;
+}
+declare const SubscriptionContextInstance: import('react').Context<SubscriptionContextValue>;
+interface SubscriptionProviderProps {
+    children: ReactNode;
+    fetchSubscriptionContext: (spaceId?: string) => Promise<SubscriptionContextType>;
+    spaceId?: string;
+    initialData?: SubscriptionContextType;
+    isLoggedIn?: boolean;
+}
+export declare function SubscriptionProvider({ children, fetchSubscriptionContext, spaceId, initialData, isLoggedIn, }: SubscriptionProviderProps): import("react").JSX.Element;
+export declare function useSubscriptionContext(): SubscriptionContextValue;
+export { SubscriptionContextInstance };

package/dist/components/internal/shared-ui/components/features/subscription/SubscriptionGuard.d.ts

@@ -0,0 +1,35 @@
+import { ReactNode, ReactElement } from 'react';
+import { SubscriptionPlan, FeatureKey, ResourceType, UpgradePrompt } from './types';
+
+interface SubscriptionGuardProps {
+    feature?: FeatureKey;
+    requiredPlan?: SubscriptionPlan;
+    children: ReactNode;
+    fallback?: ReactNode;
+    showUpgradePrompt?: boolean;
+    renderUpgradePrompt?: (prompt: UpgradePrompt) => ReactElement;
+}
+export declare function SubscriptionGuard({ feature, requiredPlan, children, fallback, showUpgradePrompt, renderUpgradePrompt, }: SubscriptionGuardProps): ReactElement | null;
+interface ResourceLimitGuardProps {
+    resource: ResourceType;
+    currentCount?: number;
+    children: ReactNode;
+    fallback?: ReactNode;
+    onLimitReached?: () => void;
+    showUpgradePrompt?: boolean;
+    renderUpgradePrompt?: (prompt: UpgradePrompt) => ReactElement;
+}
+export declare function ResourceLimitGuard({ resource, currentCount, children, fallback, onLimitReached, showUpgradePrompt, renderUpgradePrompt, }: ResourceLimitGuardProps): ReactElement | null;
+interface FeatureFlagProps {
+    feature: FeatureKey;
+    children: ReactNode;
+    otherwise?: ReactNode;
+}
+export declare function FeatureFlag({ feature, children, otherwise, }: FeatureFlagProps): ReactElement | null;
+interface PlanRequiredProps {
+    plan: SubscriptionPlan;
+    children: ReactNode;
+    otherwise?: ReactNode;
+}
+export declare function PlanRequired({ plan, children, otherwise, }: PlanRequiredProps): ReactElement | null;
+export {};

package/dist/components/internal/shared-ui/components/features/subscription/constants.d.ts

@@ -0,0 +1,126 @@
+import { SubscriptionPlan, FeatureKey, ResourceType } from './types';
+
+export declare const PLAN_HIERARCHY: SubscriptionPlan[];
+export declare const PLAN_DISPLAY_NAMES: Record<SubscriptionPlan, string>;
+export declare const FEATURE_DISPLAY_NAMES: Record<FeatureKey, string>;
+export declare const RESOURCE_DISPLAY_NAMES: Record<ResourceType, string>;
+export declare const FEATURE_KEYS: FeatureKey[];
+export declare const RESOURCE_TYPES: ResourceType[];
+export declare const DEFAULT_SUBSCRIPTION_CONTEXT: {
+    subscription: {
+        plan: SubscriptionPlan;
+        expiry: any;
+        isActive: boolean;
+        source: "DEFAULT";
+        isStandalone: boolean;
+    };
+    limits: {
+        teamsLimit: number;
+        teamMembersLimit: number;
+        canCreateCollaborativeTeams: boolean;
+        canInviteMembers: boolean;
+        agentLimit: number;
+        taskLimit: number;
+        knowledgeBaseLimit: number;
+        datasetLimit: number;
+        maxFileSize: number;
+        quotasPerMonth: number;
+        quotasCarryOver: boolean;
+        quotasCarryOverMaxMonths: number;
+        vectorStorageGB: number;
+        fileStorageGB: number;
+        apiRequestsPerMonth: number;
+        maxConcurrentTasks: number;
+    };
+    features: {
+        advancedModels: boolean;
+        customOperators: boolean;
+        apiAccess: boolean;
+        auditLogs: boolean;
+        sso: boolean;
+        prioritySupport: boolean;
+        scheduledTasks: boolean;
+        webhooks: boolean;
+        dataExport: boolean;
+        teamCollaboration: boolean;
+        advancedAnalytics: boolean;
+        customIntegrations: boolean;
+        slaGuarantee: boolean;
+        rbacControl: boolean;
+    };
+    usage: {
+        agent: number;
+        task: number;
+        knowledgeBase: number;
+        dataset: number;
+        team: number;
+        teamMember: number;
+    };
+    remaining: {
+        agent: number;
+        task: number;
+        knowledgeBase: number;
+        dataset: number;
+        team: number;
+        teamMember: number;
+    };
+};
+export declare const STANDALONE_SUBSCRIPTION_CONTEXT: {
+    subscription: {
+        plan: SubscriptionPlan;
+        expiry: any;
+        isActive: boolean;
+        source: "STANDALONE";
+        isStandalone: boolean;
+    };
+    limits: {
+        teamsLimit: number;
+        teamMembersLimit: number;
+        canCreateCollaborativeTeams: boolean;
+        canInviteMembers: boolean;
+        agentLimit: number;
+        taskLimit: number;
+        knowledgeBaseLimit: number;
+        datasetLimit: number;
+        maxFileSize: number;
+        quotasPerMonth: number;
+        quotasCarryOver: boolean;
+        quotasCarryOverMaxMonths: number;
+        vectorStorageGB: number;
+        fileStorageGB: number;
+        apiRequestsPerMonth: number;
+        maxConcurrentTasks: number;
+    };
+    features: {
+        advancedModels: boolean;
+        customOperators: boolean;
+        apiAccess: boolean;
+        auditLogs: boolean;
+        sso: boolean;
+        prioritySupport: boolean;
+        scheduledTasks: boolean;
+        webhooks: boolean;
+        dataExport: boolean;
+        teamCollaboration: boolean;
+        advancedAnalytics: boolean;
+        customIntegrations: boolean;
+        slaGuarantee: boolean;
+        rbacControl: boolean;
+    };
+    usage: {
+        agent: number;
+        task: number;
+        knowledgeBase: number;
+        dataset: number;
+        team: number;
+        teamMember: number;
+    };
+    remaining: {
+        agent: number;
+        task: number;
+        knowledgeBase: number;
+        dataset: number;
+        team: number;
+        teamMember: number;
+    };
+};

package/dist/components/internal/shared-ui/components/features/subscription/createSubscriptionService.d.ts

@@ -0,0 +1,34 @@
+import { SubscriptionContext, SubscriptionLimits, SubscriptionFeatures, ResourceUsage, ResourceRemaining, ResourceType, FeatureKey, AllPlansDetails } from './types';
+
+export interface ApiClientInterface {
+    get<T>(url: string, params?: unknown, config?: unknown): Promise<{
+        success: boolean;
+        data?: T;
+        message?: string;
+    }>;
+}
+export interface SubscriptionService {
+    getSubscriptionContext(spaceId?: string): Promise<SubscriptionContext>;
+    getSubscriptionLimits(spaceId?: string): Promise<{
+        limits: SubscriptionLimits;
+        usage: ResourceUsage;
+        remaining: ResourceRemaining;
+        isStandalone: boolean;
+    }>;
+    getSubscriptionFeatures(): Promise<{
+        features: SubscriptionFeatures;
+        isStandalone: boolean;
+    }>;
+    checkResourceLimit(resourceType: ResourceType, spaceId?: string): Promise<{
+        allowed: boolean;
+        current: number;
+        limit: number;
+        remaining: number;
+    }>;
+    checkFeatureAccess(featureKey: FeatureKey): Promise<{
+        feature: string;
+        enabled: boolean;
+    }>;
+    getPlanDetails(): Promise<AllPlansDetails>;
+}
+export declare function createSubscriptionService(apiClient: ApiClientInterface): SubscriptionService;

package/dist/components/internal/shared-ui/components/features/subscription/index.d.ts

@@ -0,0 +1,7 @@
+export type { SubscriptionPlan, SubscriptionSource, SubscriptionInfo, SubscriptionLimits, ResourceUsage, ResourceRemaining, SubscriptionFeatures, FeatureKey, SubscriptionContext, SubscriptionContextResponse, SubscriptionLimitsResponse, SubscriptionFeaturesResponse, ResourceLimitCheckResponse, FeatureCheckResponse, UpgradePrompt, ResourceType, PlanDetails, AllPlansDetails, DisplayLimit, SubscriptionDisplay, } from './types';
+export { PLAN_HIERARCHY, PLAN_DISPLAY_NAMES, FEATURE_DISPLAY_NAMES, RESOURCE_DISPLAY_NAMES, FEATURE_KEYS, RESOURCE_TYPES, DEFAULT_SUBSCRIPTION_CONTEXT, STANDALONE_SUBSCRIPTION_CONTEXT, } from './constants';
+export { isPlanSufficient, getUpgradePath, getNextPlan, getPlanDisplayName, getFeatureDisplayName, getResourceDisplayName, generateFeatureUpgradePrompt, generateResourceUpgradePrompt, formatLimitValue, isUnlimited, calculateUsagePercentage, getUsageLevel, } from './utils';
+export { SubscriptionProvider, useSubscriptionContext, SubscriptionContextInstance, } from './SubscriptionContext';
+export { useSubscription, type UseSubscriptionReturn, } from './useSubscription';
+export { SubscriptionGuard, ResourceLimitGuard, FeatureFlag, PlanRequired, } from './SubscriptionGuard';
+export { createSubscriptionService, type ApiClientInterface, type SubscriptionService, } from './createSubscriptionService';

package/dist/components/internal/shared-ui/components/features/subscription/types.d.ts

@@ -0,0 +1,161 @@
+export type SubscriptionPlan = 'FREE' | 'PERSONAL' | 'TEAM' | 'ENTERPRISE';
+export type SubscriptionSource = 'PERSONAL' | 'TEAM' | 'DEFAULT' | 'STANDALONE';
+export interface SubscriptionInfo {
+    plan: SubscriptionPlan;
+    expiry: string | null;
+    isActive: boolean;
+    source: SubscriptionSource;
+    isStandalone: boolean;
+    spaceId?: string;
+    spaceName?: string;
+}
+export interface SubscriptionLimits {
+    teamsLimit: number;
+    teamMembersLimit: number;
+    canCreateCollaborativeTeams?: boolean;
+    canInviteMembers?: boolean;
+    agentLimit: number;
+    taskLimit: number;
+    knowledgeBaseLimit: number;
+    datasetLimit: number;
+    maxFileSize: number;
+    quotasPerMonth?: number;
+    quotasCarryOver?: boolean;
+    quotasCarryOverMaxMonths?: number;
+    vectorStorageGB?: number;
+    fileStorageGB?: number;
+    apiRequestsPerMonth: number;
+    maxConcurrentTasks: number;
+}
+export interface ResourceUsage {
+    agent: number;
+    task: number;
+    knowledgeBase: number;
+    dataset: number;
+    team: number;
+    teamMember: number;
+}
+export interface ResourceRemaining {
+    agent: number;
+    task: number;
+    knowledgeBase: number;
+    dataset: number;
+    team: number;
+    teamMember: number;
+}
+export interface SubscriptionFeatures {
+    advancedModels: boolean;
+    customOperators: boolean;
+    apiAccess: boolean;
+    auditLogs: boolean;
+    sso: boolean;
+    prioritySupport: boolean;
+    scheduledTasks: boolean;
+    webhooks: boolean;
+    dataExport: boolean;
+    teamCollaboration: boolean;
+    advancedAnalytics: boolean;
+    customIntegrations?: boolean;
+    slaGuarantee?: boolean;
+    rbacControl?: boolean;
+}
+export type FeatureKey = keyof SubscriptionFeatures;
+export interface TokenBalance {
+    total: number;
+    subscription: number;
+    recharged: number;
+    expiresAt?: string | null;
+}
+export interface DisplayLimit {
+    key: string;
+    label: string;
+    value: string;
+    rawValue: number;
+}
+export interface SubscriptionDisplay {
+    planName: string;
+    features: string[];
+    limits: DisplayLimit[];
+}
+export interface SubscriptionContext {
+    subscription: SubscriptionInfo;
+    limits: SubscriptionLimits;
+    features: SubscriptionFeatures;
+    usage: ResourceUsage;
+    remaining: ResourceRemaining;
+    tokenBalance?: TokenBalance;
+    display?: SubscriptionDisplay;
+}
+export interface SubscriptionContextResponse {
+    success: boolean;
+    data: SubscriptionContext;
+}
+export interface SubscriptionLimitsResponse {
+    success: boolean;
+    data: {
+        limits: SubscriptionLimits;
+        usage: ResourceUsage;
+        remaining: ResourceRemaining;
+        isStandalone: boolean;
+    };
+}
+export interface SubscriptionFeaturesResponse {
+    success: boolean;
+    data: {
+        features: SubscriptionFeatures;
+        isStandalone: boolean;
+    };
+}
+export interface ResourceLimitCheckResponse {
+    success: boolean;
+    data: {
+        allowed: boolean;
+        current: number;
+        limit: number;
+        remaining: number;
+        isStandalone?: boolean;
+    };
+}
+export interface FeatureCheckResponse {
+    success: boolean;
+    data: {
+        feature: string;
+        enabled: boolean;
+        isStandalone?: boolean;
+        reason?: string;
+    };
+}
+export interface UpgradePrompt {
+    currentPlan: SubscriptionPlan;
+    suggestedPlan: SubscriptionPlan;
+    title: string;
+    description: string;
+    blockedItem: string;
+}
+export type ResourceType = 'agent' | 'task' | 'knowledgeBase' | 'dataset' | 'team' | 'teamMember';
+export interface PlanDetails {
+    name: string;
+    code: SubscriptionPlan;
+    teamsLimit: number;
+    teamMembersLimit: number;
+    canCreateCollaborativeTeams: boolean;
+    canInviteMembers: boolean;
+    agentLimit: number;
+    taskLimit: number;
+    knowledgeBaseLimit: number;
+    datasetLimit: number;
+    maxFileSize: number;
+    quotasPerMonth: number;
+    quotasCarryOver: boolean;
+    quotasCarryOverMaxMonths: number;
+    vectorStorageGB: number;
+    fileStorageGB: number;
+    apiRequestsPerMonth: number;
+    maxConcurrentTasks: number;
+    features: SubscriptionFeatures;
+}
+export interface AllPlansDetails {
+    plans: Record<SubscriptionPlan, PlanDetails>;
+    hierarchy: SubscriptionPlan[];
+    isStandalone: boolean;
+}

package/dist/components/internal/shared-ui/components/features/subscription/useSubscription.d.ts

@@ -0,0 +1,20 @@
+import { SubscriptionInfo, SubscriptionLimits, SubscriptionFeatures, ResourceUsage, ResourceRemaining, FeatureKey, ResourceType, SubscriptionPlan, UpgradePrompt, SubscriptionDisplay } from './types';
+
+export interface UseSubscriptionReturn {
+    subscription: SubscriptionInfo;
+    limits: SubscriptionLimits;
+    features: SubscriptionFeatures;
+    usage: ResourceUsage;
+    remaining: ResourceRemaining;
+    display?: SubscriptionDisplay;
+    isLoading: boolean;
+    isStandalone: boolean;
+    error: Error | null;
+    canAccess: (featureKey: FeatureKey) => boolean;
+    hasPlan: (requiredPlan: SubscriptionPlan) => boolean;
+    checkLimit: (resourceType: ResourceType, currentCount?: number) => boolean;
+    getFeatureUpgradePrompt: (featureKey: FeatureKey) => UpgradePrompt | null;
+    getResourceUpgradePrompt: (resourceType: ResourceType) => UpgradePrompt | null;
+    refresh: () => Promise<void>;
+}
+export declare function useSubscription(): UseSubscriptionReturn;

package/dist/components/internal/shared-ui/components/features/subscription/utils.d.ts

@@ -0,0 +1,18 @@
+import { SubscriptionPlan, UpgradePrompt, FeatureKey, ResourceType, SubscriptionLimits, ResourceRemaining } from './types';
+
+export declare function isPlanSufficient(currentPlan: SubscriptionPlan, requiredPlan: SubscriptionPlan): boolean;
+export declare function getUpgradePath(currentPlan: SubscriptionPlan): SubscriptionPlan[];
+export declare function getNextPlan(currentPlan: SubscriptionPlan): SubscriptionPlan | null;
+export declare function getPlanDisplayName(plan: SubscriptionPlan): string;
+export declare function getFeatureDisplayName(featureKey: FeatureKey): string;
+export declare function getResourceDisplayName(resourceType: ResourceType): string;
+export declare function generateFeatureUpgradePrompt(currentPlan: SubscriptionPlan, featureKey: FeatureKey): UpgradePrompt;
+export declare function generateResourceUpgradePrompt(currentPlan: SubscriptionPlan, resourceType: ResourceType, limit: number): UpgradePrompt;
+export declare function formatLimitValue(value: number): string;
+export declare function isUnlimited(value: number): boolean;
+/** Maps frontend ResourceType to plan limit field names (aligned with API RESOURCE_LIMIT_KEYS). */
+export declare function getResourceLimitValue(limits: SubscriptionLimits, resourceType: ResourceType): number | undefined;
+/** Maps frontend ResourceType to remaining usage keys (API uses spaceMember for teamMember). */
+export declare function getResourceRemainingValue(remaining: ResourceRemaining, resourceType: ResourceType): number | undefined;
+export declare function calculateUsagePercentage(current: number, limit: number): number;
+export declare function getUsageLevel(current: number, limit: number): 'low' | 'medium' | 'high' | 'full';

package/dist/components/internal/shared-ui/components/features/task/index.d.ts

@@ -0,0 +1 @@
+export {};