@maykonpaulo/maestro-admin 0.4.0-next.0 → 0.4.0-next.1

package/README.md

@@ -636,6 +636,26 @@ The header carries a palette picker, a light/dark toggle (system → light → d
 
 `tokens` is applied inline on the admin root, so it wins over the preset in both light and dark. The full token list is at the top of `src/styles.css`; the ones you will reach for most are `--maestro-brand`, `--maestro-shell`, `--maestro-bg`, `--maestro-surface`, `--maestro-border`, `--maestro-fg` and `--maestro-radius`.
 
+### The mark
+
+`MaestroMark` and `MaestroSeal` are exported, drawn inline in `currentColor`, and carry no colour of their own — set `color` on them and they follow whatever palette is active. That is why the sidebar logo changes with the theme without shipping one asset per palette:
+
+```tsx
+<MaestroMark size={30} style={{ color: 'var(--maestro-brand)' }} title="Maestro" />
+```
+
+Use `MaestroMark` where there is horizontal room and `MaestroSeal` where the shape is square by obligation or below 16px, where the mark's slices close up. The geometry, the spacing rules and the source SVGs live in [`brand/`](../../brand) at the repo root.
+
+### Favicon
+
+A favicon is a separate document: it cannot read the admin's theme attribute, so following the palette means swapping the file. That is the host page's asset, so it is opt-in:
+
+```tsx
+<MaestroAdmin theme={{ favicon: (name) => `/favicon-${name}.svg` }} />
+```
+
+The admin then updates an existing `<link rel="icon">` whenever the operator switches palette. It never injects one, and without the option the tab icon stays exactly as the host set it. `brand/` ships a ready favicon per palette, each already switching between light and dark via `prefers-color-scheme`.
+
 ### The admin never scrolls sideways
 
 Every screen scrolls vertically only. The hub uses fluid card tracks, the sidebar collapses to icons under 900px, and list tables have fixed column widths with truncation — so an entity with thirty fields does not become thirty columns. Which columns are on screen is the operator's call, from **Columns** in the list toolbar, remembered per entity; the default selection comes from `primaryListFields()` and **Reset columns** hands the decision back to it.

package/dist/index.d.ts

@@ -275,6 +275,20 @@ interface MaestroThemeConfig {
     picker?: boolean;
     /** Remember the operator's choices in `localStorage`. Defaults to `true`. */
     remember?: boolean;
+    /**
+     * Keeps the page's `<link rel="icon">` in step with the active palette. Given the palette name,
+     * return the URL of the matching icon:
+     *
+     * ```ts
+     * favicon: (theme) => `/favicon-${theme}.svg`
+     * ```
+     *
+     * Opt-in, and deliberately a function rather than a built-in path: a favicon is a document-level
+     * asset the host page owns, and an embedded admin has no business guessing that
+     * `/favicon-latao.svg` is served. Without it the tab icon simply stays as the host set it. Only an
+     * existing `<link rel="icon">` is updated — the admin never injects one.
+     */
+    favicon?: (preset: MaestroThemeName) => string | undefined;
 }
 /** `theme="cobalto"` is shorthand for `theme={{ preset: 'cobalto' }}`. */
 type MaestroThemeInput = MaestroThemeName | MaestroThemeConfig;
@@ -475,7 +489,6 @@ declare function Sidebar({ entities, activeId, onSelect, title, labels, recents,
  */
 declare const PATHS: {
     readonly hub: react.JSX.Element;
-    readonly baton: react.JSX.Element;
     readonly search: react.JSX.Element;
     readonly chevronRight: react.JSX.Element;
     readonly chevronLeft: react.JSX.Element;
@@ -589,6 +602,27 @@ declare function CommandPalette({ sections, onClose }: {
     onClose: () => void;
 }): react.ReactPortal;
 
+/**
+ * The mark: an M sliced into three horizontal bands — a stave and a table in the same shape. Use it
+ * wherever there is horizontal room (sidebar, header, docs). Below 16px of height the slices close
+ * up; use `<MaestroSeal>` there instead.
+ */
+declare function MaestroMark({ size, className, title, }: {
+    size?: number;
+    className?: string;
+    title?: string;
+}): ReactElement;
+/**
+ * The seal: the same M knocked out of a solid container, keeping only the first slice — the
+ * container holds the form at sizes where the mark's bands would close. Use it where the shape is
+ * square by obligation (app icon, avatar) or below 16px.
+ */
+declare function MaestroSeal({ size, className, title, }: {
+    size?: number;
+    className?: string;
+    title?: string;
+}): ReactElement;
+
 type Variant = 'primary' | 'secondary' | 'danger' | 'ghost';
 declare function Button({ variant, icon, className, children, ...props }: ButtonHTMLAttributes<HTMLButtonElement> & {
     variant?: Variant;
@@ -664,4 +698,4 @@ declare function JsonInput({ field, value, onChange, disabled, }: {
     disabled?: boolean;
 }): react.JSX.Element;
 
-export { AdminClientProvider, type AdminLabels, type AdminLocale, type AdminStrings, type AsyncState, Badge, Button, type ColumnPrefs, CommandPalette, type Crumb, EmptyState, type EntityCapabilities, EntityDetail, EntityForm, type EntityLabelOverride, EntityList, type EntityMetadata, ErrorBanner, FieldInput, type FieldMetadata, FieldValue, type FilterInput, Header, Hub, I18nProvider, Icon, IconButton, type IconName, JsonInput, type ListQuery, type ListResult, MAESTRO_THEMES, MaestroAdmin, type MaestroAdminProps, MaestroApiError, MaestroClient, type MaestroClientConfig, type MaestroDensity, type MaestroMetadata, type MaestroScheme, type MaestroThemeConfig, type MaestroThemeInput, type MaestroThemeName, type MaestroThemeOption, MaestroThemeProvider, type MaestroThemeState, type MenuGroup, ObjectValue, type PaletteCommand, type PaletteSection, Sidebar, type SidebarMenu, Spinner, Toast, applyLabels, buildMenu, detailFields, entityCommands, entityIcon, formFields, listFields, primaryListFields, stringsFor, useAdminRoot, useAsync, useClient, useColumnPrefs, useEntities, useEntity, useEntityList, useEntityRecord, useMetadata, useRecents, useT, useTheme };
+export { AdminClientProvider, type AdminLabels, type AdminLocale, type AdminStrings, type AsyncState, Badge, Button, type ColumnPrefs, CommandPalette, type Crumb, EmptyState, type EntityCapabilities, EntityDetail, EntityForm, type EntityLabelOverride, EntityList, type EntityMetadata, ErrorBanner, FieldInput, type FieldMetadata, FieldValue, type FilterInput, Header, Hub, I18nProvider, Icon, IconButton, type IconName, JsonInput, type ListQuery, type ListResult, MAESTRO_THEMES, MaestroAdmin, type MaestroAdminProps, MaestroApiError, MaestroClient, type MaestroClientConfig, type MaestroDensity, MaestroMark, type MaestroMetadata, type MaestroScheme, MaestroSeal, type MaestroThemeConfig, type MaestroThemeInput, type MaestroThemeName, type MaestroThemeOption, MaestroThemeProvider, type MaestroThemeState, type MenuGroup, ObjectValue, type PaletteCommand, type PaletteSection, Sidebar, type SidebarMenu, Spinner, Toast, applyLabels, buildMenu, detailFields, entityCommands, entityIcon, formFields, listFields, primaryListFields, stringsFor, useAdminRoot, useAsync, useClient, useColumnPrefs, useEntities, useEntity, useEntityList, useEntityRecord, useMetadata, useRecents, useT, useTheme };