shell: the panel, createPanel(site) (moved from wayBetter for X)
packages/shell/src/panel (waybetter/shell/panel): an app's own tab. An app describes itself (PanelSite: brand and the home page's words, its own sections and their order, its theme store, catalog and the preview component a theme document is drawn in, Make's examples and docs, the install controller, its languages, what its native side serves) and createPanel returns the component for ShellSite.panel. It is in the shell package because it is drawn in the frame and shares its stores, native bridge and language. - Panel.tsx (header, settings search over every settings section, navigation, toasts; Accounts and Updates), nav.ts (which built-in sections an app gets: each shows only when the app serves what it needs; the app's sections in its order), Home.tsx (hero, highlights, About from the app's data), controls.tsx + panel.css. - Appearance.tsx, ThemeBuilder.tsx + builderModel.ts + builder.css, fonts/ (FontBrowser, FontRoles, catalog, the offline Google Fonts list; scripts/google-fonts-catalog.mjs regenerates it): the theme documents are the runtime's, the store, catalog, accents, draft palette, file suffix and preview are the app's (PanelSite.themes). - Plugins.tsx (the plugins list and custom CSS over the host's plugins_*/custom_css_*), StoreSection.tsx, MakePanel.tsx + makeModel.ts + MarkdownDoc.tsx + markdown.ts + make.css (the examples, the theme file and the docs are the app's), Settings.tsx (links and session over settings_get/set with `siteLinks`, keyword alerts, the media panel), FeatureToggles.tsx (useFeatures + FeatureGroups over features_get/set: the app names its flags and groups), PowerSettings.tsx (deck defaults from site.deck: its flags and presets; DeckPreset gets `name` and `hint`), BackupPanel.tsx + backup.css, DeveloperPanel.tsx, LanguageSettings.tsx, compare.ts. - frame: language.ts (createLanguage: follow the site / the system / one language, i18n_set; moved from the app), appI18n.ts (createAppI18n: the app's typed i18n instance, useT, dates and numbers; the app passes React's useSyncExternalStore), formatDate in i18n.ts (ShellI18n.date). - tests/panel.test.ts: every panel key has English and is used, sections per app, the builder model, the font catalog, plugin header rules, the UI kit demos, Markdown, compare. - npm package: exports ./shell/panel, ./shell/panel/*, ./shell/panel/*.css; the build is scripts/build.mjs (the shell is compiled with the runtime sources it imports under one root and its imports are pointed at dist/runtime; stylesheets and the font list are copied).
This commit is contained in:
parent
6ef78c0c30
commit
00b193506f
44 changed files with 4864 additions and 2 deletions
38
packages/shell/src/panel/index.ts
Normal file
38
packages/shell/src/panel/index.ts
Normal file
|
|
@ -0,0 +1,38 @@
|
|||
// The wayBetter panel: `createPanel(site)` gives an app its own tab in the shell (settings, themes
|
||||
// and the Theme Builder, plugins and custom CSS, the Store, Make, accounts, Power User, backup and
|
||||
// sync, developer mode, updates, a settings search). The app describes itself (`PanelSite`): its
|
||||
// brand and home page, its theme catalog and the miniature its themes are previewed in, its own
|
||||
// sections (X: Tweaks, Drafts, My Space), Make's examples and docs, its languages. Each built-in
|
||||
// section shows only when the app serves what it needs. Styles come with the components.
|
||||
//
|
||||
// const Panel = createPanel({ brand: { name: 'wayBetter', logo }, home, themes, sections: [...] });
|
||||
// createShell({ ..., panel: { id: 'app', title: 'wayBetter', component: Panel } }, options);
|
||||
//
|
||||
// The panel speaks through the shell frame (its native API, language and site): call `createShell`
|
||||
// before the panel renders.
|
||||
|
||||
import type { ComponentType } from 'react';
|
||||
import Panel from './Panel.tsx';
|
||||
import { configurePanel, type PanelSite } from './site.ts';
|
||||
|
||||
/** The component the shell frame shows as the app's tab (`ShellSite.panel.component`). */
|
||||
export type PanelComponent = ComponentType<{ section?: { name: string; nonce: number } }>;
|
||||
|
||||
/** Sets the panel's site for every panel module and returns the panel's root component. Call once. */
|
||||
export function createPanel(site: PanelSite): PanelComponent {
|
||||
configurePanel(site);
|
||||
return Panel;
|
||||
}
|
||||
|
||||
export type {
|
||||
PanelSite, PanelSection, PanelHome, PanelThemes, PanelMake, PanelLanguage, PanelLanguages, PluginExample, FeatureGroup, SectionProps, Notify, BuiltinSection,
|
||||
} from './site.ts';
|
||||
export { BUILTIN_SECTIONS, panelSite } from './site.ts';
|
||||
export { NAV_ICONS, navEntries } from './nav.ts';
|
||||
// Building blocks for the app's own sections: the panel's controls and the generic pieces.
|
||||
export {
|
||||
Badge, Button, ChipList, ColorField, EmptyState, InputRow, Row, SearchField, SearchProvider, Section, Segmented, Select, Slider, Stepper, Toggle, useSettingsQuery,
|
||||
type Option,
|
||||
} from './controls.tsx';
|
||||
export { FeatureGroups, useFeatures } from './FeatureToggles.tsx';
|
||||
export { compareLines } from './compare.ts';
|
||||
Loading…
Add table
Add a link
Reference in a new issue