devonthesofa_obsidian-note-.../components/SettingsUI/UISettings.tsx
2025-11-23 18:17:17 +01:00

470 lines
13 KiB
TypeScript

import React from "react";
import { PluginSettings } from "@/types/pluginSettings";
import { Input } from "../atoms/Input";
import { Select } from "../atoms/Select";
import { SettingItem } from "./SettingItem";
import { IconSelectionField } from "./IconSelectionField";
export type Props = {
settings: PluginSettings;
onChange: (key: keyof PluginSettings, value: unknown) => void;
};
export const StatusBarSettings: React.FC<Props> = ({ settings, onChange }) => {
const handleCheckbox =
(key: keyof PluginSettings) =>
(e: React.ChangeEvent<HTMLInputElement>) =>
onChange(key, e.target.checked);
return (
<div className="ui-settings__group">
<h3>Status Bar</h3>
<SettingItem
name="Show status icon in status bar"
description="Display a status icon in the status bar with the current note status."
>
<input
type="checkbox"
checked={settings.showStatusBar}
onChange={handleCheckbox("showStatusBar")}
/>
</SettingItem>
<SettingItem
name="Hide icon when note has no status"
description="Automatically hide the status icon whenever the current note does not have a status."
>
<input
type="checkbox"
checked={settings.autoHideStatusBar}
onChange={handleCheckbox("autoHideStatusBar")}
/>
</SettingItem>
<SettingItem
name="Show status overview popup"
description="Show a popup listing statuses when hovering or interacting with the status icon."
>
<input
type="checkbox"
checked={settings.enableStatusOverviewPopup ?? true}
onChange={handleCheckbox("enableStatusOverviewPopup")}
/>
</SettingItem>
<SettingItem
name="Show template names next to status"
description="Control how the template name is shown alongside the current status."
>
<Select
options={[
{
value: "never",
display: "Never show template names",
},
{
value: "auto",
display: "Show only when status names conflict",
},
{
value: "always",
display: "Always show template names",
},
]}
defaultValue={settings.statusBarShowTemplateName || "auto"}
onChange={(value) =>
onChange("statusBarShowTemplateName", value)
}
/>
</SettingItem>
<SettingItem
name="Status bar badge style"
description="Match the file explorer visuals: accent stripe, solid fill, or dot marker."
>
<Select
options={[
{ value: "accent", display: "Accent stripe (default)" },
{ value: "filled", display: "Solid background" },
{ value: "dot", display: "Dot marker" },
]}
defaultValue={settings.statusBarBadgeStyle || "accent"}
onChange={(value) => onChange("statusBarBadgeStyle", value)}
/>
</SettingItem>
<SettingItem
name="Status bar badge content"
description="Choose whether the badge shows icon, text, both, or an empty accent."
>
<Select
options={[
{
value: "icon-text",
display: "Icon + text (default)",
},
{ value: "icon", display: "Icon only" },
{ value: "text", display: "Text only" },
{ value: "none", display: "Empty badge (accent only)" },
]}
defaultValue={
settings.statusBarBadgeContentMode || "icon-text"
}
onChange={(value) =>
onChange("statusBarBadgeContentMode", value)
}
/>
</SettingItem>
<h4>No Status Display</h4>
<SettingItem
name="Custom text when note has no status"
description="Pick what text should be shown in the status bar when a note does not have a status."
>
<Input
variant="text"
value={settings.statusBarNoStatusText}
onChange={(value) =>
onChange("statusBarNoStatusText", value)
}
className="ui-settings__no-status-input"
placeholder="No status"
/>
</SettingItem>
<SettingItem
name="Show icon when note has no status"
description="Display the unknown status icon in the status bar next to the custom text."
>
<input
type="checkbox"
checked={settings.statusBarShowNoStatusIcon || false}
onChange={handleCheckbox("statusBarShowNoStatusIcon")}
/>
</SettingItem>
<SettingItem
name="Show text when note has no status"
description="Display the custom text in the status bar whenever no status is set."
>
<input
type="checkbox"
checked={settings.statusBarShowNoStatusText ?? true}
onChange={handleCheckbox("statusBarShowNoStatusText")}
/>
</SettingItem>
</div>
);
};
export const EditorToolbarSettings: React.FC<Props> = ({
settings,
onChange,
}) => {
const handleCheckbox =
(key: keyof PluginSettings) =>
(e: React.ChangeEvent<HTMLInputElement>) =>
onChange(key, e.target.checked);
return (
<div className="ui-settings__group">
<h3>Editor Toolbar</h3>
<SettingItem
name="Show editor toolbar button"
description="Add a button to the editor toolbar to change the note status."
>
<input
type="checkbox"
checked={settings.showEditorToolbarButton ?? true}
onChange={handleCheckbox("showEditorToolbarButton")}
/>
</SettingItem>
<SettingItem
name="Editor toolbar button position"
description="Choose where the status button should appear in the editor toolbar."
>
<Select
options={[
{ value: "left", display: "Left side of toolbar" },
{
value: "right",
display: "Right side (after all buttons)",
},
{
value: "right-before",
display: "Right side (before action buttons)",
},
]}
defaultValue={
settings.editorToolbarButtonPosition || "right"
}
onChange={(value) =>
onChange("editorToolbarButtonPosition", value)
}
/>
</SettingItem>
<SettingItem
name="Show toolbar button for"
description="Control which editors should display the toolbar button."
>
<Select
options={[
{ value: "all-notes", display: "All open notes" },
{ value: "active-only", display: "Active note only" },
]}
defaultValue={
settings.editorToolbarButtonDisplay || "all-notes"
}
onChange={(value) =>
onChange("editorToolbarButtonDisplay", value)
}
/>
</SettingItem>
</div>
);
};
export const FileExplorerSettings: React.FC<Props> = ({
settings,
onChange,
}) => {
const handleCheckbox =
(key: keyof PluginSettings) =>
(e: React.ChangeEvent<HTMLInputElement>) =>
onChange(key, e.target.checked);
return (
<div className="ui-settings__group">
<h3>File Explorer</h3>
<SettingItem
name="Show status icons in file explorer"
description="Display a status icon for each file inside the file explorer."
>
<input
type="checkbox"
checked={settings.showStatusIconsInExplorer}
onChange={handleCheckbox("showStatusIconsInExplorer")}
/>
</SettingItem>
<SettingItem
name="Status icon position in file explorer"
description="Choose where the icon should be rendered next to the file name."
>
<Select
options={[
{ display: "Filename left", value: "file-name-left" },
{ display: "Filename right", value: "file-name-right" },
{ display: "Absolute right", value: "absolute-right" },
]}
defaultValue={settings.fileExplorerIconPosition}
onChange={(value) =>
onChange("fileExplorerIconPosition", value)
}
/>
</SettingItem>
<SettingItem
name="Hide icon when file status is unknown"
description="Do not render a status icon in the explorer when a note status cannot be determined."
>
<input
type="checkbox"
checked={settings.hideUnknownStatusInExplorer || false}
onChange={handleCheckbox("hideUnknownStatusInExplorer")}
/>
</SettingItem>
<SettingItem
name="Color filename text using status color"
description="Apply the active status color to the filename text inside the file explorer."
>
<input
type="checkbox"
checked={settings.fileExplorerColorFileName || false}
onChange={handleCheckbox("fileExplorerColorFileName")}
/>
</SettingItem>
<SettingItem
name="Color the file explorer block based on status"
description="Tint the entire file explorer list item with the active status color."
>
<input
type="checkbox"
checked={settings.fileExplorerColorBlock || false}
onChange={handleCheckbox("fileExplorerColorBlock")}
/>
</SettingItem>
<h4>Additional status visualization in file explorer</h4>
<SettingItem
name="Show colored left border"
description="Render a subtle colored strip on the left edge of the file explorer item."
>
<input
type="checkbox"
checked={settings.fileExplorerLeftBorder || false}
onChange={handleCheckbox("fileExplorerLeftBorder")}
/>
</SettingItem>
<SettingItem
name="Show colored status dot"
description="Append a compact colored dot next to the filename as an extra status indicator."
>
<input
type="checkbox"
checked={settings.fileExplorerStatusDot || false}
onChange={handleCheckbox("fileExplorerStatusDot")}
/>
</SettingItem>
<SettingItem
name="Underline filename with status color"
description="Adds a colored underline below the filename without changing the text color."
>
<input
type="checkbox"
checked={settings.fileExplorerUnderlineFileName || false}
onChange={handleCheckbox("fileExplorerUnderlineFileName")}
/>
</SettingItem>
<SettingItem
name="Status icon frame"
description="Choose whether to display a frame around the status icon inside the file explorer."
>
<Select
options={[
{ value: "never", display: "Never show a frame" },
{ value: "always", display: "Always show a frame" },
]}
defaultValue={settings.fileExplorerIconFrame || "never"}
onChange={(value) =>
onChange("fileExplorerIconFrame", value)
}
/>
</SettingItem>
<SettingItem
name="Status icon color"
description="Decide whether icons use their configured status colors or inherit the theme default."
>
<Select
options={[
{
value: "status",
display: "Use custom status colors",
},
{ value: "theme", display: "Use theme default colors" },
]}
defaultValue={
settings.fileExplorerIconColorMode || "status"
}
onChange={(value) =>
onChange("fileExplorerIconColorMode", value)
}
/>
</SettingItem>
</div>
);
};
export const UnknownStatusAppearanceSettings: React.FC<Props> = ({
settings,
onChange,
}) => (
<div className="ui-settings__group">
<h3>Unknown / No-Status Appearance</h3>
<SettingItem
name="Icon for unknown status"
description="Emoji or Lucide icon name displayed whenever a note does not have a status."
vertical
>
<IconSelectionField
emojiValue={settings.unknownStatusIcon}
onEmojiChange={(value) => onChange("unknownStatusIcon", value)}
emojiPlaceholder="❓"
emojiHint="Type any emoji or text fallback."
lucideValue={settings.unknownStatusLucideIcon || ""}
onLucideChange={(value) =>
onChange("unknownStatusLucideIcon", value)
}
lucidePlaceholder="Choose Lucide icon"
lucideHint="Matches the Obsidian toolbar style."
/>
</SettingItem>
<SettingItem
name="Color for unknown status"
description="Hex color used for unknown statuses (e.g., #8b949e)."
>
<Input
variant="color"
value={settings.unknownStatusColor || "#8b949e"}
onChange={(value) => onChange("unknownStatusColor", value)}
placeholder="No status"
/>
</SettingItem>
</div>
);
export const ExperimentalSettings: React.FC<Props> = ({
settings,
onChange,
}) => {
const handleCheckbox =
(key: keyof PluginSettings) =>
(e: React.ChangeEvent<HTMLInputElement>) =>
onChange(key, e.target.checked);
return (
<div className="ui-settings__group">
<h3>Experimental features</h3>
<SettingItem
name="Enable experimental features"
description="Unlock beta views that are still under development."
>
<input
type="checkbox"
checked={settings.enableExperimentalFeatures || false}
onChange={handleCheckbox("enableExperimentalFeatures")}
/>
</SettingItem>
<SettingItem
name="Enable status dashboard"
description="Show the ribbon shortcut to open the status dashboard view."
>
<input
type="checkbox"
disabled={!settings.enableExperimentalFeatures}
checked={settings.enableStatusDashboard || false}
onChange={handleCheckbox("enableStatusDashboard")}
/>
</SettingItem>
<SettingItem
name="Enable grouped status view"
description="Show the ribbon shortcut to open the grouped status view."
>
<input
type="checkbox"
disabled={!settings.enableExperimentalFeatures}
checked={settings.enableGroupedStatusView || false}
onChange={handleCheckbox("enableGroupedStatusView")}
/>
</SettingItem>
</div>
);
};