@stateglyph/core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1114 @@
+type StateIconCategory = "async" | "media" | "navigation" | "feedback" | "device" | "form" | "commerce" | "notification";
+type StateIconTransition = "crossfade" | "scale-fade" | "rotate" | "slide" | "morph";
+type StateIconLibrary = "lucide" | (string & {});
+interface StateIconStateDefinition {
+    icon: string;
+    label: string;
+    description?: string;
+    continuous?: boolean;
+}
+type StateIconStates = Record<string, StateIconStateDefinition>;
+interface StateIconSource {
+    library: StateIconLibrary;
+    license: string;
+    url: string;
+    icons: readonly string[];
+}
+interface StateIconDefinition<States extends StateIconStates = StateIconStates> {
+    id: string;
+    title: string;
+    description: string;
+    category: StateIconCategory;
+    states: States;
+    initialState: keyof States & string;
+    transition: StateIconTransition;
+    tags: readonly string[];
+    source: StateIconSource;
+}
+
+declare function defineStateIcon<const States extends StateIconStates>(definition: StateIconDefinition<States>): StateIconDefinition<States>;
+
+declare const stateIconCatalog: readonly [StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "upload";
+        readonly label: "Upload";
+        readonly description: "Ready to upload.";
+    };
+    readonly loading: {
+        readonly icon: "loader-circle";
+        readonly label: "Uploading";
+        readonly description: "Uploading is in progress.";
+        readonly continuous: true;
+    };
+    readonly success: {
+        readonly icon: "circle-check";
+        readonly label: "Upload complete";
+        readonly description: "Upload complete successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Upload failed";
+        readonly description: "The upload action failed.";
+    };
+}>, StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "download";
+        readonly label: "Download";
+        readonly description: "Ready to download.";
+    };
+    readonly loading: {
+        readonly icon: "loader-circle";
+        readonly label: "Downloading";
+        readonly description: "Downloading is in progress.";
+        readonly continuous: true;
+    };
+    readonly success: {
+        readonly icon: "circle-check";
+        readonly label: "Download complete";
+        readonly description: "Download complete successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Download failed";
+        readonly description: "The download action failed.";
+    };
+}>, StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "save";
+        readonly label: "Save";
+        readonly description: "Ready to save.";
+    };
+    readonly saving: {
+        readonly icon: "loader-circle";
+        readonly label: "Saving";
+        readonly description: "Saving is in progress.";
+        readonly continuous: true;
+    };
+    readonly saved: {
+        readonly icon: "circle-check";
+        readonly label: "Saved";
+        readonly description: "Saved successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Save failed";
+        readonly description: "The save action failed.";
+    };
+}>, StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "trash-2";
+        readonly label: "Delete";
+        readonly description: "Ready to delete.";
+    };
+    readonly deleting: {
+        readonly icon: "loader-circle";
+        readonly label: "Deleting";
+        readonly description: "Deleting is in progress.";
+        readonly continuous: true;
+    };
+    readonly deleted: {
+        readonly icon: "circle-check";
+        readonly label: "Deleted";
+        readonly description: "Deleted successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Delete failed";
+        readonly description: "The delete action failed.";
+    };
+}>, StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "refresh-cw";
+        readonly label: "Refresh";
+        readonly description: "Ready to refresh.";
+    };
+    readonly refreshing: {
+        readonly icon: "loader-circle";
+        readonly label: "Refreshing";
+        readonly description: "Refreshing is in progress.";
+        readonly continuous: true;
+    };
+    readonly complete: {
+        readonly icon: "circle-check";
+        readonly label: "Refresh complete";
+        readonly description: "Refresh complete successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Refresh failed";
+        readonly description: "The refresh action failed.";
+    };
+}>, StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "refresh-cw";
+        readonly label: "Sync";
+        readonly description: "Ready to sync.";
+    };
+    readonly syncing: {
+        readonly icon: "loader-circle";
+        readonly label: "Syncing";
+        readonly description: "Syncing is in progress.";
+        readonly continuous: true;
+    };
+    readonly synced: {
+        readonly icon: "circle-check";
+        readonly label: "Synced";
+        readonly description: "Synced successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Sync failed";
+        readonly description: "The sync action failed.";
+    };
+}>, StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "send";
+        readonly label: "Send";
+        readonly description: "Ready to send.";
+    };
+    readonly sending: {
+        readonly icon: "loader-circle";
+        readonly label: "Sending";
+        readonly description: "Sending is in progress.";
+        readonly continuous: true;
+    };
+    readonly sent: {
+        readonly icon: "circle-check";
+        readonly label: "Sent";
+        readonly description: "Sent successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Send failed";
+        readonly description: "The send action failed.";
+    };
+}>, StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "credit-card";
+        readonly label: "Payment";
+        readonly description: "Ready to payment.";
+    };
+    readonly processing: {
+        readonly icon: "loader-circle";
+        readonly label: "Processing payment";
+        readonly description: "Processing payment is in progress.";
+        readonly continuous: true;
+    };
+    readonly success: {
+        readonly icon: "circle-check";
+        readonly label: "Payment complete";
+        readonly description: "Payment complete successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Payment failed";
+        readonly description: "The payment action failed.";
+    };
+}>, StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "shopping-cart";
+        readonly label: "Add to cart";
+        readonly description: "Ready to add to cart.";
+    };
+    readonly adding: {
+        readonly icon: "loader-circle";
+        readonly label: "Adding to cart";
+        readonly description: "Adding to cart is in progress.";
+        readonly continuous: true;
+    };
+    readonly added: {
+        readonly icon: "circle-check";
+        readonly label: "Added to cart";
+        readonly description: "Added to cart successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Add to cart failed";
+        readonly description: "The add to cart action failed.";
+    };
+}>, StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "send-horizontal";
+        readonly label: "Submit";
+        readonly description: "Ready to submit.";
+    };
+    readonly submitting: {
+        readonly icon: "loader-circle";
+        readonly label: "Submitting";
+        readonly description: "Submitting is in progress.";
+        readonly continuous: true;
+    };
+    readonly success: {
+        readonly icon: "circle-check";
+        readonly label: "Submission complete";
+        readonly description: "Submission complete successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Submit failed";
+        readonly description: "The submit action failed.";
+    };
+}>, StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "package";
+        readonly label: "Install";
+        readonly description: "Ready to install.";
+    };
+    readonly installing: {
+        readonly icon: "loader-circle";
+        readonly label: "Installing";
+        readonly description: "Installing is in progress.";
+        readonly continuous: true;
+    };
+    readonly installed: {
+        readonly icon: "package-check";
+        readonly label: "Installed";
+        readonly description: "Installed successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Install failed";
+        readonly description: "The install action failed.";
+    };
+}>, StateIconDefinition<{
+    readonly draft: {
+        readonly icon: "file-pen-line";
+        readonly label: "Draft";
+        readonly description: "The content is still a draft.";
+    };
+    readonly publishing: {
+        readonly icon: "loader-circle";
+        readonly label: "Publishing";
+        readonly description: "Publication is in progress.";
+        readonly continuous: true;
+    };
+    readonly published: {
+        readonly icon: "circle-check";
+        readonly label: "Published";
+        readonly description: "The content is published.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Publishing failed";
+        readonly description: "The content could not be published.";
+    };
+}>, StateIconDefinition<{
+    readonly paused: {
+        readonly icon: "play";
+        readonly label: "Play";
+        readonly description: "Media is paused and can be played.";
+    };
+    readonly playing: {
+        readonly icon: "pause";
+        readonly label: "Pause";
+        readonly description: "Media is playing and can be paused.";
+    };
+}>, StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "play";
+        readonly label: "Play";
+        readonly description: "Media is ready to play.";
+    };
+    readonly buffering: {
+        readonly icon: "loader-circle";
+        readonly label: "Buffering";
+        readonly description: "Media is buffering.";
+        readonly continuous: true;
+    };
+    readonly playing: {
+        readonly icon: "pause";
+        readonly label: "Pause";
+        readonly description: "Media is currently playing.";
+    };
+    readonly paused: {
+        readonly icon: "play";
+        readonly label: "Resume";
+        readonly description: "Media is paused.";
+    };
+}>, StateIconDefinition<{
+    readonly audible: {
+        readonly icon: "volume-2";
+        readonly label: "Mute audio";
+        readonly description: "Audio is audible.";
+    };
+    readonly muted: {
+        readonly icon: "volume-x";
+        readonly label: "Unmute audio";
+        readonly description: "Audio is muted.";
+    };
+}>, StateIconDefinition<{
+    readonly active: {
+        readonly icon: "mic";
+        readonly label: "Mute microphone";
+        readonly description: "The microphone is active.";
+    };
+    readonly muted: {
+        readonly icon: "mic-off";
+        readonly label: "Unmute microphone";
+        readonly description: "The microphone is muted.";
+    };
+}>, StateIconDefinition<{
+    readonly active: {
+        readonly icon: "video";
+        readonly label: "Disable camera";
+        readonly description: "The camera is active.";
+    };
+    readonly disabled: {
+        readonly icon: "video-off";
+        readonly label: "Enable camera";
+        readonly description: "The camera is disabled.";
+    };
+}>, StateIconDefinition<{
+    readonly windowed: {
+        readonly icon: "maximize";
+        readonly label: "Enter fullscreen";
+        readonly description: "The view is windowed.";
+    };
+    readonly fullscreen: {
+        readonly icon: "minimize";
+        readonly label: "Exit fullscreen";
+        readonly description: "The view is fullscreen.";
+    };
+}>, StateIconDefinition<{
+    readonly off: {
+        readonly icon: "repeat";
+        readonly label: "Turn repeat on";
+        readonly description: "Repeat is off.";
+    };
+    readonly on: {
+        readonly icon: "repeat-2";
+        readonly label: "Turn repeat off";
+        readonly description: "Repeat is on.";
+    };
+}>, StateIconDefinition<{
+    readonly off: {
+        readonly icon: "list-ordered";
+        readonly label: "Turn shuffle on";
+        readonly description: "Shuffle is off.";
+    };
+    readonly on: {
+        readonly icon: "shuffle";
+        readonly label: "Turn shuffle off";
+        readonly description: "Shuffle is on.";
+    };
+}>, StateIconDefinition<{
+    readonly closed: {
+        readonly icon: "menu";
+        readonly label: "Open menu";
+        readonly description: "The menu is closed.";
+    };
+    readonly open: {
+        readonly icon: "x";
+        readonly label: "Close menu";
+        readonly description: "The menu is open.";
+    };
+}>, StateIconDefinition<{
+    readonly collapsed: {
+        readonly icon: "chevrons-up-down";
+        readonly label: "Expand";
+        readonly description: "The content is collapsed.";
+    };
+    readonly expanded: {
+        readonly icon: "chevrons-down-up";
+        readonly label: "Collapse";
+        readonly description: "The content is expanded.";
+    };
+}>, StateIconDefinition<{
+    readonly open: {
+        readonly icon: "panel-left-close";
+        readonly label: "Close sidebar";
+        readonly description: "The sidebar is open.";
+    };
+    readonly closed: {
+        readonly icon: "panel-left-open";
+        readonly label: "Open sidebar";
+        readonly description: "The sidebar is closed.";
+    };
+}>, StateIconDefinition<{
+    readonly grid: {
+        readonly icon: "layout-grid";
+        readonly label: "Show as list";
+        readonly description: "The collection uses a grid layout.";
+    };
+    readonly list: {
+        readonly icon: "list";
+        readonly label: "Show as grid";
+        readonly description: "The collection uses a list layout.";
+    };
+}>, StateIconDefinition<{
+    readonly up: {
+        readonly icon: "chevron-up";
+        readonly label: "Point up";
+        readonly description: "The chevron points upward.";
+    };
+    readonly down: {
+        readonly icon: "chevron-down";
+        readonly label: "Point down";
+        readonly description: "The chevron points downward.";
+    };
+}>, StateIconDefinition<{
+    readonly left: {
+        readonly icon: "chevron-left";
+        readonly label: "Point left";
+        readonly description: "The chevron points left.";
+    };
+    readonly right: {
+        readonly icon: "chevron-right";
+        readonly label: "Point right";
+        readonly description: "The chevron points right.";
+    };
+}>, StateIconDefinition<{
+    readonly restored: {
+        readonly icon: "maximize-2";
+        readonly label: "Maximize panel";
+        readonly description: "The panel is restored.";
+    };
+    readonly maximized: {
+        readonly icon: "minimize-2";
+        readonly label: "Restore panel";
+        readonly description: "The panel is maximized.";
+    };
+}>, StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "copy";
+        readonly label: "Copy";
+        readonly description: "Content is ready to be copied.";
+    };
+    readonly copied: {
+        readonly icon: "check";
+        readonly label: "Copied";
+        readonly description: "Content was copied.";
+    };
+    readonly reset: {
+        readonly icon: "rotate-ccw";
+        readonly label: "Copy again";
+        readonly description: "Copy feedback has reset.";
+    };
+}>, StateIconDefinition<{
+    readonly unliked: {
+        readonly icon: "heart";
+        readonly label: "Like";
+        readonly description: "The item is not liked.";
+    };
+    readonly liked: {
+        readonly icon: "heart-off";
+        readonly label: "Remove like";
+        readonly description: "The item is liked.";
+    };
+}>, StateIconDefinition<{
+    readonly unbookmarked: {
+        readonly icon: "bookmark";
+        readonly label: "Add bookmark";
+        readonly description: "The item is not bookmarked.";
+    };
+    readonly bookmarked: {
+        readonly icon: "bookmark-check";
+        readonly label: "Remove bookmark";
+        readonly description: "The item is bookmarked.";
+    };
+}>, StateIconDefinition<{
+    readonly off: {
+        readonly icon: "bell-off";
+        readonly label: "Enable notifications";
+        readonly description: "Notifications are off.";
+    };
+    readonly on: {
+        readonly icon: "bell";
+        readonly label: "Notifications on";
+        readonly description: "Notifications are enabled.";
+    };
+    readonly unread: {
+        readonly icon: "bell-ring";
+        readonly label: "Unread notifications";
+        readonly description: "There are unread notifications.";
+    };
+}>];
+
+declare const uploadStateIcon: StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "upload";
+        readonly label: "Upload";
+        readonly description: "Ready to upload.";
+    };
+    readonly loading: {
+        readonly icon: "loader-circle";
+        readonly label: "Uploading";
+        readonly description: "Uploading is in progress.";
+        readonly continuous: true;
+    };
+    readonly success: {
+        readonly icon: "circle-check";
+        readonly label: "Upload complete";
+        readonly description: "Upload complete successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Upload failed";
+        readonly description: "The upload action failed.";
+    };
+}>;
+type UploadState = keyof typeof uploadStateIcon.states;
+
+declare const downloadStateIcon: StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "download";
+        readonly label: "Download";
+        readonly description: "Ready to download.";
+    };
+    readonly loading: {
+        readonly icon: "loader-circle";
+        readonly label: "Downloading";
+        readonly description: "Downloading is in progress.";
+        readonly continuous: true;
+    };
+    readonly success: {
+        readonly icon: "circle-check";
+        readonly label: "Download complete";
+        readonly description: "Download complete successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Download failed";
+        readonly description: "The download action failed.";
+    };
+}>;
+type DownloadState = keyof typeof downloadStateIcon.states;
+
+declare const saveStateIcon: StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "save";
+        readonly label: "Save";
+        readonly description: "Ready to save.";
+    };
+    readonly saving: {
+        readonly icon: "loader-circle";
+        readonly label: "Saving";
+        readonly description: "Saving is in progress.";
+        readonly continuous: true;
+    };
+    readonly saved: {
+        readonly icon: "circle-check";
+        readonly label: "Saved";
+        readonly description: "Saved successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Save failed";
+        readonly description: "The save action failed.";
+    };
+}>;
+type SaveState = keyof typeof saveStateIcon.states;
+
+declare const deleteStateIcon: StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "trash-2";
+        readonly label: "Delete";
+        readonly description: "Ready to delete.";
+    };
+    readonly deleting: {
+        readonly icon: "loader-circle";
+        readonly label: "Deleting";
+        readonly description: "Deleting is in progress.";
+        readonly continuous: true;
+    };
+    readonly deleted: {
+        readonly icon: "circle-check";
+        readonly label: "Deleted";
+        readonly description: "Deleted successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Delete failed";
+        readonly description: "The delete action failed.";
+    };
+}>;
+type DeleteState = keyof typeof deleteStateIcon.states;
+
+declare const refreshStateIcon: StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "refresh-cw";
+        readonly label: "Refresh";
+        readonly description: "Ready to refresh.";
+    };
+    readonly refreshing: {
+        readonly icon: "loader-circle";
+        readonly label: "Refreshing";
+        readonly description: "Refreshing is in progress.";
+        readonly continuous: true;
+    };
+    readonly complete: {
+        readonly icon: "circle-check";
+        readonly label: "Refresh complete";
+        readonly description: "Refresh complete successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Refresh failed";
+        readonly description: "The refresh action failed.";
+    };
+}>;
+type RefreshState = keyof typeof refreshStateIcon.states;
+
+declare const syncStateIcon: StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "refresh-cw";
+        readonly label: "Sync";
+        readonly description: "Ready to sync.";
+    };
+    readonly syncing: {
+        readonly icon: "loader-circle";
+        readonly label: "Syncing";
+        readonly description: "Syncing is in progress.";
+        readonly continuous: true;
+    };
+    readonly synced: {
+        readonly icon: "circle-check";
+        readonly label: "Synced";
+        readonly description: "Synced successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Sync failed";
+        readonly description: "The sync action failed.";
+    };
+}>;
+type SyncState = keyof typeof syncStateIcon.states;
+
+declare const sendStateIcon: StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "send";
+        readonly label: "Send";
+        readonly description: "Ready to send.";
+    };
+    readonly sending: {
+        readonly icon: "loader-circle";
+        readonly label: "Sending";
+        readonly description: "Sending is in progress.";
+        readonly continuous: true;
+    };
+    readonly sent: {
+        readonly icon: "circle-check";
+        readonly label: "Sent";
+        readonly description: "Sent successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Send failed";
+        readonly description: "The send action failed.";
+    };
+}>;
+type SendState = keyof typeof sendStateIcon.states;
+
+declare const paymentStateIcon: StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "credit-card";
+        readonly label: "Payment";
+        readonly description: "Ready to payment.";
+    };
+    readonly processing: {
+        readonly icon: "loader-circle";
+        readonly label: "Processing payment";
+        readonly description: "Processing payment is in progress.";
+        readonly continuous: true;
+    };
+    readonly success: {
+        readonly icon: "circle-check";
+        readonly label: "Payment complete";
+        readonly description: "Payment complete successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Payment failed";
+        readonly description: "The payment action failed.";
+    };
+}>;
+type PaymentState = keyof typeof paymentStateIcon.states;
+
+declare const addToCartStateIcon: StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "shopping-cart";
+        readonly label: "Add to cart";
+        readonly description: "Ready to add to cart.";
+    };
+    readonly adding: {
+        readonly icon: "loader-circle";
+        readonly label: "Adding to cart";
+        readonly description: "Adding to cart is in progress.";
+        readonly continuous: true;
+    };
+    readonly added: {
+        readonly icon: "circle-check";
+        readonly label: "Added to cart";
+        readonly description: "Added to cart successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Add to cart failed";
+        readonly description: "The add to cart action failed.";
+    };
+}>;
+type AddToCartState = keyof typeof addToCartStateIcon.states;
+
+declare const submitStateIcon: StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "send-horizontal";
+        readonly label: "Submit";
+        readonly description: "Ready to submit.";
+    };
+    readonly submitting: {
+        readonly icon: "loader-circle";
+        readonly label: "Submitting";
+        readonly description: "Submitting is in progress.";
+        readonly continuous: true;
+    };
+    readonly success: {
+        readonly icon: "circle-check";
+        readonly label: "Submission complete";
+        readonly description: "Submission complete successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Submit failed";
+        readonly description: "The submit action failed.";
+    };
+}>;
+type SubmitState = keyof typeof submitStateIcon.states;
+
+declare const installStateIcon: StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "package";
+        readonly label: "Install";
+        readonly description: "Ready to install.";
+    };
+    readonly installing: {
+        readonly icon: "loader-circle";
+        readonly label: "Installing";
+        readonly description: "Installing is in progress.";
+        readonly continuous: true;
+    };
+    readonly installed: {
+        readonly icon: "package-check";
+        readonly label: "Installed";
+        readonly description: "Installed successfully.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Install failed";
+        readonly description: "The install action failed.";
+    };
+}>;
+type InstallState = keyof typeof installStateIcon.states;
+
+declare const publishStateIcon: StateIconDefinition<{
+    readonly draft: {
+        readonly icon: "file-pen-line";
+        readonly label: "Draft";
+        readonly description: "The content is still a draft.";
+    };
+    readonly publishing: {
+        readonly icon: "loader-circle";
+        readonly label: "Publishing";
+        readonly description: "Publication is in progress.";
+        readonly continuous: true;
+    };
+    readonly published: {
+        readonly icon: "circle-check";
+        readonly label: "Published";
+        readonly description: "The content is published.";
+    };
+    readonly error: {
+        readonly icon: "circle-alert";
+        readonly label: "Publishing failed";
+        readonly description: "The content could not be published.";
+    };
+}>;
+type PublishState = keyof typeof publishStateIcon.states;
+
+declare const playPauseStateIcon: StateIconDefinition<{
+    readonly paused: {
+        readonly icon: "play";
+        readonly label: "Play";
+        readonly description: "Media is paused and can be played.";
+    };
+    readonly playing: {
+        readonly icon: "pause";
+        readonly label: "Pause";
+        readonly description: "Media is playing and can be paused.";
+    };
+}>;
+type PlayPauseState = keyof typeof playPauseStateIcon.states;
+
+declare const playbackStateIcon: StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "play";
+        readonly label: "Play";
+        readonly description: "Media is ready to play.";
+    };
+    readonly buffering: {
+        readonly icon: "loader-circle";
+        readonly label: "Buffering";
+        readonly description: "Media is buffering.";
+        readonly continuous: true;
+    };
+    readonly playing: {
+        readonly icon: "pause";
+        readonly label: "Pause";
+        readonly description: "Media is currently playing.";
+    };
+    readonly paused: {
+        readonly icon: "play";
+        readonly label: "Resume";
+        readonly description: "Media is paused.";
+    };
+}>;
+type PlaybackState = keyof typeof playbackStateIcon.states;
+
+declare const volumeStateIcon: StateIconDefinition<{
+    readonly audible: {
+        readonly icon: "volume-2";
+        readonly label: "Mute audio";
+        readonly description: "Audio is audible.";
+    };
+    readonly muted: {
+        readonly icon: "volume-x";
+        readonly label: "Unmute audio";
+        readonly description: "Audio is muted.";
+    };
+}>;
+type VolumeState = keyof typeof volumeStateIcon.states;
+
+declare const microphoneStateIcon: StateIconDefinition<{
+    readonly active: {
+        readonly icon: "mic";
+        readonly label: "Mute microphone";
+        readonly description: "The microphone is active.";
+    };
+    readonly muted: {
+        readonly icon: "mic-off";
+        readonly label: "Unmute microphone";
+        readonly description: "The microphone is muted.";
+    };
+}>;
+type MicrophoneState = keyof typeof microphoneStateIcon.states;
+
+declare const cameraStateIcon: StateIconDefinition<{
+    readonly active: {
+        readonly icon: "video";
+        readonly label: "Disable camera";
+        readonly description: "The camera is active.";
+    };
+    readonly disabled: {
+        readonly icon: "video-off";
+        readonly label: "Enable camera";
+        readonly description: "The camera is disabled.";
+    };
+}>;
+type CameraState = keyof typeof cameraStateIcon.states;
+
+declare const fullscreenStateIcon: StateIconDefinition<{
+    readonly windowed: {
+        readonly icon: "maximize";
+        readonly label: "Enter fullscreen";
+        readonly description: "The view is windowed.";
+    };
+    readonly fullscreen: {
+        readonly icon: "minimize";
+        readonly label: "Exit fullscreen";
+        readonly description: "The view is fullscreen.";
+    };
+}>;
+type FullscreenState = keyof typeof fullscreenStateIcon.states;
+
+declare const repeatStateIcon: StateIconDefinition<{
+    readonly off: {
+        readonly icon: "repeat";
+        readonly label: "Turn repeat on";
+        readonly description: "Repeat is off.";
+    };
+    readonly on: {
+        readonly icon: "repeat-2";
+        readonly label: "Turn repeat off";
+        readonly description: "Repeat is on.";
+    };
+}>;
+type RepeatState = keyof typeof repeatStateIcon.states;
+
+declare const shuffleStateIcon: StateIconDefinition<{
+    readonly off: {
+        readonly icon: "list-ordered";
+        readonly label: "Turn shuffle on";
+        readonly description: "Shuffle is off.";
+    };
+    readonly on: {
+        readonly icon: "shuffle";
+        readonly label: "Turn shuffle off";
+        readonly description: "Shuffle is on.";
+    };
+}>;
+type ShuffleState = keyof typeof shuffleStateIcon.states;
+
+declare const menuStateIcon: StateIconDefinition<{
+    readonly closed: {
+        readonly icon: "menu";
+        readonly label: "Open menu";
+        readonly description: "The menu is closed.";
+    };
+    readonly open: {
+        readonly icon: "x";
+        readonly label: "Close menu";
+        readonly description: "The menu is open.";
+    };
+}>;
+type MenuState = keyof typeof menuStateIcon.states;
+
+declare const expandStateIcon: StateIconDefinition<{
+    readonly collapsed: {
+        readonly icon: "chevrons-up-down";
+        readonly label: "Expand";
+        readonly description: "The content is collapsed.";
+    };
+    readonly expanded: {
+        readonly icon: "chevrons-down-up";
+        readonly label: "Collapse";
+        readonly description: "The content is expanded.";
+    };
+}>;
+type ExpandState = keyof typeof expandStateIcon.states;
+
+declare const sidebarStateIcon: StateIconDefinition<{
+    readonly open: {
+        readonly icon: "panel-left-close";
+        readonly label: "Close sidebar";
+        readonly description: "The sidebar is open.";
+    };
+    readonly closed: {
+        readonly icon: "panel-left-open";
+        readonly label: "Open sidebar";
+        readonly description: "The sidebar is closed.";
+    };
+}>;
+type SidebarState = keyof typeof sidebarStateIcon.states;
+
+declare const viewStateIcon: StateIconDefinition<{
+    readonly grid: {
+        readonly icon: "layout-grid";
+        readonly label: "Show as list";
+        readonly description: "The collection uses a grid layout.";
+    };
+    readonly list: {
+        readonly icon: "list";
+        readonly label: "Show as grid";
+        readonly description: "The collection uses a list layout.";
+    };
+}>;
+type ViewState = keyof typeof viewStateIcon.states;
+
+declare const chevronVerticalStateIcon: StateIconDefinition<{
+    readonly up: {
+        readonly icon: "chevron-up";
+        readonly label: "Point up";
+        readonly description: "The chevron points upward.";
+    };
+    readonly down: {
+        readonly icon: "chevron-down";
+        readonly label: "Point down";
+        readonly description: "The chevron points downward.";
+    };
+}>;
+type ChevronVerticalState = keyof typeof chevronVerticalStateIcon.states;
+
+declare const chevronHorizontalStateIcon: StateIconDefinition<{
+    readonly left: {
+        readonly icon: "chevron-left";
+        readonly label: "Point left";
+        readonly description: "The chevron points left.";
+    };
+    readonly right: {
+        readonly icon: "chevron-right";
+        readonly label: "Point right";
+        readonly description: "The chevron points right.";
+    };
+}>;
+type ChevronHorizontalState = keyof typeof chevronHorizontalStateIcon.states;
+
+declare const panelStateIcon: StateIconDefinition<{
+    readonly restored: {
+        readonly icon: "maximize-2";
+        readonly label: "Maximize panel";
+        readonly description: "The panel is restored.";
+    };
+    readonly maximized: {
+        readonly icon: "minimize-2";
+        readonly label: "Restore panel";
+        readonly description: "The panel is maximized.";
+    };
+}>;
+type PanelState = keyof typeof panelStateIcon.states;
+
+declare const copyStateIcon: StateIconDefinition<{
+    readonly idle: {
+        readonly icon: "copy";
+        readonly label: "Copy";
+        readonly description: "Content is ready to be copied.";
+    };
+    readonly copied: {
+        readonly icon: "check";
+        readonly label: "Copied";
+        readonly description: "Content was copied.";
+    };
+    readonly reset: {
+        readonly icon: "rotate-ccw";
+        readonly label: "Copy again";
+        readonly description: "Copy feedback has reset.";
+    };
+}>;
+type CopyState = keyof typeof copyStateIcon.states;
+
+declare const likeStateIcon: StateIconDefinition<{
+    readonly unliked: {
+        readonly icon: "heart";
+        readonly label: "Like";
+        readonly description: "The item is not liked.";
+    };
+    readonly liked: {
+        readonly icon: "heart-off";
+        readonly label: "Remove like";
+        readonly description: "The item is liked.";
+    };
+}>;
+type LikeState = keyof typeof likeStateIcon.states;
+
+declare const bookmarkStateIcon: StateIconDefinition<{
+    readonly unbookmarked: {
+        readonly icon: "bookmark";
+        readonly label: "Add bookmark";
+        readonly description: "The item is not bookmarked.";
+    };
+    readonly bookmarked: {
+        readonly icon: "bookmark-check";
+        readonly label: "Remove bookmark";
+        readonly description: "The item is bookmarked.";
+    };
+}>;
+type BookmarkState = keyof typeof bookmarkStateIcon.states;
+
+declare const notificationStateIcon: StateIconDefinition<{
+    readonly off: {
+        readonly icon: "bell-off";
+        readonly label: "Enable notifications";
+        readonly description: "Notifications are off.";
+    };
+    readonly on: {
+        readonly icon: "bell";
+        readonly label: "Notifications on";
+        readonly description: "Notifications are enabled.";
+    };
+    readonly unread: {
+        readonly icon: "bell-ring";
+        readonly label: "Unread notifications";
+        readonly description: "There are unread notifications.";
+    };
+}>;
+type NotificationState = keyof typeof notificationStateIcon.states;
+
+export { type AddToCartState, type BookmarkState, type CameraState, type ChevronHorizontalState, type ChevronVerticalState, type CopyState, type DeleteState, type DownloadState, type ExpandState, type FullscreenState, type InstallState, type LikeState, type MenuState, type MicrophoneState, type NotificationState, type PanelState, type PaymentState, type PlayPauseState, type PlaybackState, type PublishState, type RefreshState, type RepeatState, type SaveState, type SendState, type ShuffleState, type SidebarState, type StateIconCategory, type StateIconDefinition, type StateIconLibrary, type StateIconSource, type StateIconStateDefinition, type StateIconStates, type StateIconTransition, type SubmitState, type SyncState, type UploadState, type ViewState, type VolumeState, addToCartStateIcon, bookmarkStateIcon, cameraStateIcon, chevronHorizontalStateIcon, chevronVerticalStateIcon, copyStateIcon, defineStateIcon, deleteStateIcon, downloadStateIcon, expandStateIcon, fullscreenStateIcon, installStateIcon, likeStateIcon, menuStateIcon, microphoneStateIcon, notificationStateIcon, panelStateIcon, paymentStateIcon, playPauseStateIcon, playbackStateIcon, publishStateIcon, refreshStateIcon, repeatStateIcon, saveStateIcon, sendStateIcon, shuffleStateIcon, sidebarStateIcon, stateIconCatalog, submitStateIcon, syncStateIcon, uploadStateIcon, viewStateIcon, volumeStateIcon };