@litelens/core 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,954 @@
+import { ElementType, ReactNode, ComponentType } from 'react';
+
+interface UseQueryCallback<T = unknown> {
+    select?: (data?: T) => T;
+}
+
+interface NavItem<T> {
+    id: string;
+    label: string;
+    view?: T;
+}
+interface NavGroup<T> {
+    id: string;
+    label: string;
+    icon: ElementType;
+    items: NavItem<T>[];
+    /** Whether the sidebar should render this group expanded the first time it's registered. */
+    defaultOpen?: boolean;
+}
+type NavEntry<T> = {
+    kind: "item";
+    icon: ElementType;
+    item: NavItem<T>;
+} | {
+    kind: "group";
+    group: NavGroup<T>;
+};
+
+interface ManagedField {
+    Manager: string;
+    Operation: string;
+    FieldsYAML: string;
+}
+
+interface PolicyRule {
+    Resources: string[];
+    Verbs: string[];
+    APIGroups: string[];
+    ResourceNames: string[];
+    NonResourceURLs: string[];
+}
+interface ClusterRole {
+    Name: string;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    Rules: PolicyRule[];
+}
+
+interface CRBSubject {
+    Kind: string;
+    Name: string;
+    Namespace: string;
+}
+interface ClusterRoleBinding {
+    Name: string;
+    Bindings: string;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    RoleRefKind: string;
+    RoleRefName: string;
+    RoleRefGroup: string;
+    Subjects: CRBSubject[];
+}
+
+interface ConfigMap {
+    Name: string;
+    Namespace: string;
+    Keys: string[];
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    Data: Record<string, string>;
+}
+
+interface CronJob {
+    Name: string;
+    Namespace: string;
+    Schedule: string;
+    Timezone: string;
+    Suspend: boolean;
+    Active: number;
+    LastSchedule: string;
+    Age: string;
+    CreatedAt: string;
+    Annotations?: Record<string, string>;
+    ManagedFields: ManagedField[];
+    ConcurrencyPolicy: string;
+    SuccessfulJobsHistoryLimit: number;
+    FailedJobsHistoryLimit: number;
+    LastSuccessfulTime?: string;
+    LastSuccessfulTimeAt?: string;
+    LastScheduleAt?: string;
+    JobParallelism: number;
+    JobCompletions: string;
+    JobSuspend: boolean;
+    JobTTLSecondsAfterFinished: number;
+}
+interface CronJobSummary {
+    Scheduled: number;
+    Suspended: number;
+}
+
+interface DaemonSet {
+    Name: string;
+    Namespace: string;
+    Pods: string;
+    NodeSelector: string;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    Selector: string;
+    Images: string[];
+    StrategyType: string;
+    Tolerations: number;
+    PodStatus: string;
+}
+interface DaemonSetSummary {
+    Running: number;
+    Pending: number;
+}
+
+interface PodCondition {
+    Type: string;
+    Status: string;
+    Message: string;
+    Reason: string;
+    LastProbeTime: string;
+    LastTransitionTime: string;
+}
+interface PodContainerPort {
+    Name: string;
+    HostIP: string;
+    HostPort: number;
+    ContainerPort: number;
+    Protocol: string;
+}
+interface PodContainerMount {
+    Path: string;
+    Name: string;
+    ReadOnly: boolean;
+}
+interface PodContainerLastStatus {
+    Reason: string;
+    ExitCode: number;
+    Started: string;
+    Finished: string;
+}
+interface PodContainerDetail {
+    Name: string;
+    Status: string;
+    Image: string;
+    Ready: boolean;
+    RestartCount: number;
+    LastStatus?: PodContainerLastStatus | null;
+    Ports: PodContainerPort[];
+    EnvVars: string[];
+    Mounts: PodContainerMount[];
+    Liveness: string;
+    Readiness: string;
+    Startup: string;
+    Command: string[];
+    Args: string[];
+    StatusMessage: string;
+    CPURequest: string;
+    CPULimit: string;
+    MemRequest: string;
+    MemLimit: string;
+    DiskRequest: string;
+    DiskLimit: string;
+    ContainerID: string;
+    Reason: string;
+    ExitCode?: number | null;
+    StartedAt: string;
+    FinishedAt: string;
+}
+interface PodVolumeSource {
+    Type: string;
+    Name: string;
+    Items: string[];
+    Expiration: string;
+    Path: string;
+}
+interface PodVolume {
+    Name: string;
+    Kind: string;
+    HostPath: string;
+    CheckBehavior: string;
+    Medium: string;
+    DefaultMode: string;
+    Sources: PodVolumeSource[];
+}
+interface TolerationDetail {
+    Key: string;
+    Operator: string;
+    Value: string;
+    Effect: string;
+    Seconds?: number | null;
+}
+interface Pod {
+    Name: string;
+    Namespace: string;
+    Status: string;
+    Ready: string;
+    Containers: number;
+    Restarts: number;
+    ControlledBy: string;
+    NodeName: string;
+    QoS: string;
+    Age: string;
+    CPU: string;
+    Memory: string;
+    Disk: string;
+    CPUPercent: number;
+    MemPercent: number;
+    DiskPercent: number;
+    CreatedAt: string;
+    ServiceAccount: string;
+    PriorityClass: string;
+    TerminationGracePeriod: string;
+    ControlledByName: string;
+    HostIPs: string[];
+    PodIPs: string[];
+    Tolerations: number;
+    TolerationDetails: TolerationDetail[];
+    AffinityCount: number;
+    Affinities: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    Conditions: PodCondition[];
+    ContainerDetails: PodContainerDetail[];
+    InitContainerDetails: PodContainerDetail[];
+    Volumes: PodVolume[];
+}
+interface PodSummary {
+    Running: number;
+    Pending: number;
+    Failed: number;
+    Succeeded: number;
+    Evicted: number;
+}
+
+interface DeploymentCondition {
+    Type: string;
+    Status: string;
+    Message?: string;
+    Reason?: string;
+    LastTransitionTime?: string;
+    LastUpdateTime?: string;
+}
+interface Deployment {
+    Name: string;
+    Namespace: string;
+    Pods: string;
+    Replicas: number;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    ReplicasDetail: string;
+    Selector: string;
+    NodeSelector: string;
+    StrategyType: string;
+    Conditions: DeploymentCondition[];
+    Tolerations: number;
+    TolerationDetails: TolerationDetail[];
+    AffinityCount: number;
+    Affinities: string;
+}
+interface DeploymentSummary {
+    Running: number;
+    Pending: number;
+}
+
+interface EndpointAddress {
+    IP: string;
+    Hostname: string;
+    TargetName: string;
+}
+interface EndpointPort {
+    Name: string;
+    Port: number;
+    Protocol: string;
+}
+interface EndpointSubset {
+    Addresses: EndpointAddress[];
+    Ports: EndpointPort[];
+}
+interface Endpoint {
+    Name: string;
+    Namespace: string;
+    Endpoints: string;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    Subsets: EndpointSubset[];
+}
+
+interface EndpointSliceEndpoint {
+    Addresses: string[];
+    Hostname: string;
+    NodeName: string;
+    Zone: string;
+    TargetName: string;
+    TargetKind: string;
+    Ready: boolean;
+    Serving: boolean;
+    Terminating: boolean;
+}
+interface EndpointSlicePort {
+    Name: string;
+    Port: number;
+    Protocol: string;
+}
+interface EndpointSlice {
+    Name: string;
+    Namespace: string;
+    AddressType: string;
+    Age: string;
+    Ports: EndpointSlicePort[];
+    Endpoints: EndpointSliceEndpoint[];
+    CreatedAt: string;
+    ControlledBy: string;
+    ServiceName: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+}
+
+interface Event {
+    Type: string;
+    Message: string;
+    Namespace: string;
+    InvolvedObjectKind: string;
+    InvolvedObjectName: string;
+    Source: string;
+    Count: number;
+    Age: string;
+    LastSeen: string;
+    CreatedAt: number;
+    Name: string;
+    Reason: string;
+    FirstSeen: string;
+    FirstSeenAt: number;
+    LastSeenAt: number;
+    InvolvedObjectFieldPath: string;
+    InvolvedObjectNamespace: string;
+    ManagedFields: ManagedField[];
+}
+
+interface HPA {
+    Name: string;
+    Namespace: string;
+    Metrics: string;
+    MinPods: number;
+    MaxPods: number;
+    Replicas: number;
+    Age: string;
+    Status: string;
+}
+interface HPAMetric {
+    Name: string;
+    Current: string;
+    Target: string;
+}
+interface ScaleTargetRef {
+    Kind: string;
+    Name: string;
+}
+interface HPADetail {
+    Name: string;
+    Namespace: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ScaleTargetRef: ScaleTargetRef;
+    Metrics: HPAMetric[];
+    MinPods: number;
+    MaxPods: number;
+    Replicas: number;
+    Status: string;
+    Age: string;
+}
+
+interface Ingress {
+    Name: string;
+    Namespace: string;
+    LoadBalancers: string;
+    Rules: IngressRule[];
+    Age: string;
+}
+interface IngressPath {
+    Path: string;
+    Backend: string;
+}
+interface IngressRule {
+    Host: string;
+    Paths: IngressPath[];
+}
+interface IngressDetail {
+    Name: string;
+    Namespace: string;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    LoadBalancers: string;
+    Ports: string;
+    Rules: IngressRule[];
+}
+
+interface IngressClass {
+    Name: string;
+    Controller: string;
+    IsDefault: boolean;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+}
+
+interface JobCondition {
+    Type: string;
+    Status: string;
+    Message: string;
+    Reason: string;
+    LastProbeTime: string;
+    LastTransitionTime: string;
+}
+interface Job {
+    Name: string;
+    Namespace: string;
+    Completions: number;
+    Age: string;
+    Conditions: JobCondition[];
+    Resumed: boolean;
+    Status: string;
+    Succeeded: number;
+    Parallelism: number;
+    Duration: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    Selector: string;
+    CompletionMode: string;
+    StartTime: string;
+    StartTimeAge: string;
+    CompletedAt: string;
+    CompletedAtAge: string;
+    PodsStatuses: string;
+    PodStatus: string;
+}
+interface JobSummary {
+    Succeeded: number;
+    Failed: number;
+    Pending: number;
+}
+
+interface Lease {
+    Name: string;
+    Namespace: string;
+    HolderIdentity: string;
+    LeaseDurationSeconds: number;
+    RenewTime: string;
+    AcquireTime: string;
+    LeaseTransitions: number;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+}
+
+interface LimitRange {
+    Name: string;
+    Namespace: string;
+    Age: string;
+}
+interface LimitRangeDetail {
+    Name: string;
+    Namespace: string;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    Limits: Record<string, Record<string, Record<string, string>>>;
+}
+
+interface SharedNamespaceContext {
+    Name: string;
+}
+interface Namespace extends SharedNamespaceContext {
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    Age: string;
+    CreatedAt: string;
+    Status: string;
+    ManagedFields: ManagedField[];
+    ResourceQuotas: string[];
+    LimitRanges: string[];
+}
+
+interface NetworkPolicy {
+    Name: string;
+    Namespace: string;
+    PolicyTypes: string;
+    Age: string;
+}
+interface NetworkPolicyDetail {
+    Name: string;
+    Namespace: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    PodSelector: Record<string, string>;
+    IngressRules: NetworkPolicyIngressRule[];
+    EgressRules: NetworkPolicyEgressRule[];
+}
+interface NetworkPolicyIngressRule {
+    Ports: string[];
+    From: NetworkPolicyPeer[];
+}
+interface NetworkPolicyEgressRule {
+    Ports: string[];
+    To: NetworkPolicyPeer[];
+}
+interface NetworkPolicyPeer {
+    PodSelector: Record<string, string>;
+    NamespaceSelector: Record<string, string>;
+    IPBlock: string;
+}
+
+interface NodeAddress {
+    Type: string;
+    Address: string;
+}
+interface NodeCondition {
+    Type: string;
+    Status: string;
+    Reason: string;
+    Message: string;
+    LastHeartbeatTime: string;
+    LastTransitionTime: string;
+}
+interface Node {
+    Name: string;
+    Roles: string;
+    Version: string;
+    Age: string;
+    Taints: number;
+    Unschedulable: boolean;
+    CPU: string;
+    CPUPercent: number;
+    Memory: string;
+    MemPercent: number;
+    Disk: string;
+    DiskPercent: number;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    Addresses: NodeAddress[];
+    OS: string;
+    OSImage: string;
+    KernelVersion: string;
+    ContainerRuntime: string;
+    Conditions: NodeCondition[];
+    Capacity: Record<string, string>;
+    Allocatable: Record<string, string>;
+}
+
+interface PodDisruptionBudget {
+    Name: string;
+    Namespace: string;
+    MinAvailable: string;
+    MaxUnavailable: string;
+    CurrentHealthy: number;
+    DesiredHealthy: number;
+    Age: string;
+}
+interface PodDisruptionBudgetDetail {
+    Name: string;
+    Namespace: string;
+    MinAvailable: string;
+    MaxUnavailable: string;
+    CurrentHealthy: number;
+    DesiredHealthy: number;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    Selector: Record<string, string>;
+}
+
+interface PortForward {
+    ID: string;
+    Name: string;
+    Namespace: string;
+    Kind: string;
+    PodPort: string;
+    TargetPort: string;
+    ServicePort: string;
+    LocalPort: string;
+    Scheme: string;
+    Protocol: string;
+    Address: string;
+    Status: string;
+}
+
+interface PriorityClass {
+    Name: string;
+    Value: number;
+    GlobalDefault: boolean;
+    Description: string;
+    PreemptionPolicy: string;
+    Age: string;
+    CreatedAt: string;
+    ManagedFields: ManagedField[];
+}
+
+interface PersistentVolume {
+    Name: string;
+    StorageClass: string;
+    Capacity: string;
+    Claim: string;
+    Age: string;
+    Status: string;
+}
+interface PersistentVolumeDetail {
+    Name: string;
+    Capacity: string;
+    AccessModes: string[];
+    ReclaimPolicy: string;
+    Status: string;
+    StorageClass: string;
+    Claim: string;
+    VolumeMode: string;
+    MountOptions: string[];
+    NodeAffinitySummary: string;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+}
+
+interface PersistentVolumeClaim {
+    Name: string;
+    Namespace: string;
+    StorageClass: string;
+    Size: string;
+    Pods: string;
+    Age: string;
+    Status: string;
+}
+interface PersistentVolumeClaimDetail {
+    Name: string;
+    Namespace: string;
+    StorageClass: string;
+    Size: string;
+    Pods: string[];
+    Age: string;
+    CreatedAt: string;
+    Status: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    Finalizers: string[];
+    AccessModes: string[];
+    MatchLabels: Record<string, string>;
+    MatchExprs: string[];
+}
+
+interface ReplicaSet {
+    Name: string;
+    Namespace: string;
+    Desired: number;
+    Current: number;
+    Ready: number;
+    Age: string;
+    OwnerName: string;
+    CreatedAt: string;
+    OwnerKind: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    Selector: string;
+    NodeSelector: string;
+    Images: string[];
+    ReplicasDetail: string;
+    Tolerations: number;
+    Affinities: number;
+    PodStatus: string;
+}
+interface ReplicaSetSummary {
+    Running: number;
+    Pending: number;
+}
+
+interface ResourceQuota {
+    Name: string;
+    Namespace: string;
+    Age: string;
+}
+interface ResourceQuotaDetail {
+    Name: string;
+    Namespace: string;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    Hard: Record<string, string>;
+    Used: Record<string, string>;
+}
+
+interface Role {
+    Name: string;
+    Namespace: string;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    Rules: PolicyRule[];
+}
+
+interface RBSubject {
+    Kind: string;
+    Name: string;
+    Namespace: string;
+}
+interface RoleBinding {
+    Name: string;
+    Namespace: string;
+    Bindings: string;
+    Age: string;
+    RoleRefName: string;
+    Types: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    RoleRefKind: string;
+    RoleRefGroup: string;
+    Subjects: RBSubject[];
+}
+
+interface Secret {
+    Name: string;
+    Namespace: string;
+    Labels: string[];
+    Keys: string[];
+    Type: string;
+    Age: string;
+}
+interface SecretDetail {
+    Name: string;
+    Namespace: string;
+    Type: string;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    Data: Record<string, string>;
+}
+
+interface ServicePort {
+    Name: string;
+    Port: number;
+    TargetPort: string;
+    Protocol: string;
+    NodePort: number;
+}
+interface Service {
+    Name: string;
+    Namespace: string;
+    Type: string;
+    ClusterIP: string;
+    Ports: string;
+    ExternalIP: string;
+    Selector: string;
+    Age: string;
+    Status: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    SessionAffinity: string;
+    InternalTrafficPolicy: string;
+    ClusterIPs: string[];
+    IPFamilyPolicy: string;
+    IPFamilies: string[];
+    ServicePorts: ServicePort[];
+}
+
+interface ServiceAccount {
+    Name: string;
+    Namespace: string;
+    Age: string;
+    CreatedAt: string;
+    Secrets: string[];
+}
+
+interface StatefulSet {
+    Name: string;
+    Namespace: string;
+    Pods: string;
+    Replicas: number;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    Selector: string;
+    Images: string[];
+    Affinities: number;
+    PodStatus: string;
+}
+interface StatefulSetSummary {
+    Running: number;
+    Pending: number;
+}
+
+interface StorageClass {
+    Name: string;
+    Provisioner: string;
+    ReclaimPolicy: string;
+    Default: boolean;
+    Age: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    ManagedFields: ManagedField[];
+    VolumeBindingMode: string;
+    MountOptions: string[];
+    Parameters: Record<string, string>;
+}
+
+interface ValidatingWebhookConfig {
+    Name: string;
+    Webhooks: number;
+    Age: string;
+}
+interface ValidatingWebhookConfigDetail {
+    Name: string;
+    APIVersion: string;
+    CreatedAt: string;
+    Labels: Record<string, string>;
+    Annotations: Record<string, string>;
+    Webhooks: WebhookDetail[];
+}
+interface WebhookDetail {
+    Name: string;
+    ClientConfigServiceName: string;
+    ClientConfigServiceNamespace: string;
+    MatchPolicy: string;
+    FailurePolicy: string;
+    AdmissionReviewVersions: string[];
+    SideEffects: string;
+    TimeoutSeconds: number;
+    NamespaceSelectorExpressions: string;
+    ObjectSelectorExpressions: string;
+    RulesAPIGroups: string[];
+    RulesAPIVersions: string[];
+    RulesOperations: string[];
+    RulesResources: string[];
+    RulesScope: string;
+}
+
+type UnifiedTrayCoreFamily = "modification" | "pod";
+type UnifiedTrayAllFamily = UnifiedTrayCoreFamily | (string & {});
+interface SharedUnifiedTrayOpenParams {
+    label: string;
+    icon?: ReactNode;
+    dedupeKey: string;
+    [key: string]: unknown;
+}
+interface SharedUnifiedTrayTab {
+    family: string;
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    params: Record<string, unknown>;
+}
+interface SharedUnifiedTrayContentProps {
+    tab: SharedUnifiedTrayTab;
+    collapsed: boolean;
+    onClose: () => void;
+}
+interface SharedUnifiedTrayContext {
+    openTab: (family: UnifiedTrayAllFamily, params: any) => void;
+}
+
+/**
+ * @litelens/core — React hooks for litelens plugin development
+ *
+ * This package exports hooks that plugin frontends can consume. The implementations
+ * are provided by the host at runtime via import injection.
+ */
+/**
+ * Hook to access cluster-scoped APIs exposed to plugins. Returns a collection
+ * of capabilities valid only within the single-cluster view — i.e. inside
+ * MainLayout's subtree (MainLayoutProvider → DetailDrawerProvider). Calling
+ * this from a component rendered outside that subtree (e.g. Settings,
+ * Marketplace, or any future app-wide screen) will throw, because the
+ * underlying host state (DetailDrawerContext) has no provider there. A future
+ * useAppWideAPI() will cover capabilities that don't have this constraint.
+ *
+ * Example:
+ *   const { activeContext, activeNamespaces, activeResource, availableNamespaces, onNavigateToView, resourceLinks, unifiedTray, useRegisterClusterWideEvents, useRegisterNavEntry, useRegisterTrayFamilies } = useClusterWideAPI();
+ *   resourceLinks.pod(namespace, podName);  // Opens pod detail drawer
+ *   unifiedTray.openTab("my-plugin-family", { pluginId: "my-plugin", label: "...", dedupeKey: "..." });
+ *   useRegisterClusterWideEvents({
+ *     "helm:release-updated": (payload) => { console.log("Release updated:", payload); },
+ *   });
+ *   useRegisterNavEntry("helm", "Helm", HELM_NAV_ENTRY);
+ *   useRegisterTrayFamilies("helm", HELM_TRAY_FAMILIES);
+ *
+ * This signature is duplicated from the host's real implementation at
+ * frontend/src/expose/hooks/useClusterWideAPI.ts (which this package can't
+ * import directly — see main.tsx's vendor injection). If that hook's return
+ * type changes, update this signature to match.
+ */
+declare function useClusterWideAPI(): {
+    activeContext: string;
+    activeNamespaces: string[];
+    activeResource: string;
+    availableNamespaces: Array<{
+        Name: string;
+    }>;
+    onNavigateToView: (view: string) => void;
+    resourceLinks: Record<string, (namespace: string, name: string) => void>;
+    unifiedTray: {
+        openTab: (family: string, params: unknown) => void;
+    } | null;
+    useRegisterClusterWideEvents: (handlers: Record<string, (payload: unknown) => void>) => void;
+    useRegisterNavEntry: (pluginId: string, pluginName: string, navEntry: NavEntry<string> | undefined) => void;
+    useRegisterTrayFamilies: (pluginId: string, families: Record<string, ComponentType<SharedUnifiedTrayContentProps>> | undefined) => void;
+};
+
+export { type CRBSubject, type ClusterRole, type ClusterRoleBinding, type ConfigMap, type CronJob, type CronJobSummary, type DaemonSet, type DaemonSetSummary, type Deployment, type DeploymentCondition, type DeploymentSummary, type Endpoint, type EndpointAddress, type EndpointPort, type EndpointSlice, type EndpointSliceEndpoint, type EndpointSlicePort, type EndpointSubset, type Event, type HPA, type HPADetail, type HPAMetric, type Ingress, type IngressClass, type IngressDetail, type IngressPath, type IngressRule, type Job, type JobCondition, type JobSummary, type Lease, type LimitRange, type LimitRangeDetail, type ManagedField, type Namespace, type NavEntry, type NavGroup, type NavItem, type NetworkPolicy, type NetworkPolicyDetail, type NetworkPolicyEgressRule, type NetworkPolicyIngressRule, type NetworkPolicyPeer, type Node, type NodeAddress, type NodeCondition, type PersistentVolume, type PersistentVolumeClaim, type PersistentVolumeClaimDetail, type PersistentVolumeDetail, type Pod, type PodCondition, type PodContainerDetail, type PodContainerLastStatus, type PodContainerMount, type PodContainerPort, type PodDisruptionBudget, type PodDisruptionBudgetDetail, type PodSummary, type PodVolume, type PodVolumeSource, type PolicyRule, type PortForward, type PriorityClass, type RBSubject, type ReplicaSet, type ReplicaSetSummary, type ResourceQuota, type ResourceQuotaDetail, type Role, type RoleBinding, type ScaleTargetRef, type Secret, type SecretDetail, type Service, type ServiceAccount, type ServicePort, type SharedNamespaceContext, type SharedUnifiedTrayContentProps, type SharedUnifiedTrayContext, type SharedUnifiedTrayOpenParams, type SharedUnifiedTrayTab, type StatefulSet, type StatefulSetSummary, type StorageClass, type TolerationDetail, type UnifiedTrayAllFamily, type UnifiedTrayCoreFamily, type UseQueryCallback, type ValidatingWebhookConfig, type ValidatingWebhookConfigDetail, type WebhookDetail, useClusterWideAPI };

package/dist/index.js

@@ -0,0 +1,8 @@
+// src/index.ts
+function useClusterWideAPI() {
+  throw new Error(
+    "useClusterWideAPI is not available. This hook must be imported from '@litelens/core' within a plugin bundle loaded by the litelens host."
+  );
+}
+
+export { useClusterWideAPI };

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@litelens/core",
+  "version": "1.0.0",
+  "description": "React hooks and utilities for litelens plugin development",
+  "private": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/litelensapp/litelens.git",
+    "directory": "packages/core/frontend"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "@types/react": "catalog:",
+    "@types/react-dom": "catalog:",
+    "@vitejs/plugin-react": "catalog:",
+    "@vitest/coverage-v8": "catalog:",
+    "jsdom": "catalog:",
+    "tsup": "^8.5.1",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  }
+}