Files
chaos-api/web/default/src/features/system-settings/components/settings-page.tsx
T
t0ng7u d146e45e2f ⚖️ chore(web/default): add reusable copyright header tooling
Add a Bun script to apply and normalize AGPL copyright headers across the default frontend source files.

The script keeps headers idempotent, upgrades existing headers to the 2023-2026 QuantumNous range, and is exposed through `bun run copyright` for future maintenance.
2026-05-09 11:35:07 +08:00

81 lines
2.5 KiB
TypeScript
Vendored

/*
Copyright (C) 2023-2026 QuantumNous
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
For commercial licensing, please contact support@quantumnous.com
*/
import { useParams } from '@tanstack/react-router'
import { useTranslation } from 'react-i18next'
import { useSystemOptions, getOptionValue } from '../hooks/use-system-options'
type SettingsPageProps<
TSettings extends Record<string, string | number | boolean | unknown[]>,
TSectionId extends string,
> = {
routePath: string
defaultSettings: TSettings
defaultSection: TSectionId
getSectionContent: (
sectionId: TSectionId,
settings: TSettings,
...extraArgs: unknown[]
) => React.ReactNode
extraArgs?: unknown[]
}
/**
* Generic settings page component
* Handles loading state, data fetching, and section rendering
*/
export function SettingsPage<
TSettings extends Record<string, string | number | boolean | unknown[]>,
TSectionId extends string,
>({
routePath,
defaultSettings,
defaultSection,
getSectionContent,
extraArgs = [],
}: SettingsPageProps<TSettings, TSectionId>) {
const { t } = useTranslation()
const { data, isLoading } = useSystemOptions()
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const params = useParams({ from: routePath as any })
if (isLoading) {
return (
<div className='flex items-center justify-center py-12'>
<div className='text-muted-foreground'>{t('Loading settings...')}</div>
</div>
)
}
const settings = getOptionValue(data?.data, defaultSettings) as TSettings
const activeSection = (params?.section ?? defaultSection) as TSectionId
const sectionContent = getSectionContent(
activeSection,
settings,
...extraArgs
)
return (
<div className='flex h-full w-full flex-1 flex-col'>
<div className='faded-bottom h-full w-full overflow-y-auto scroll-smooth pe-4 pb-12'>
<div className='space-y-4'>{sectionContent}</div>
</div>
</div>
)
}