@tenphi/cookbook 0.30.1 → 0.31.0

package/docs/architecture.md

@@ -97,7 +97,11 @@ continue to compose. CodeGroup collects its code and syntax bridges itself,
 including when rendered outside MarkdownContent.
 
 Optional browser behavior remains in `src/client/` and imports no styling
-modules. Custom elements attach behavior to the server-rendered markup.
+modules. Every Cookbook-owned custom element, including passive wrappers, uses
+the `cookbook-*` prefix. UniAria behaviors follow the same convention through
+`defineElement(definition, { prefix: "cookbook" })` in `client/elements.ts`;
+importing the vendor’s automatically registered `uni-*` entries is unsupported.
+Custom elements attach behavior to the server-rendered markup.
 The ownership checks verify every public style name and sub-element, while
 consumer and browser tests exercise theme overrides and component replacements.
 

package/docs/component-styles.md

@@ -108,9 +108,9 @@ it stays complete when a surface changes.
 * `HeaderLinks`: `Desktop`, `DesktopLink`, `Link`, `HoverLink`, `PrimaryLink`, `HoverPrimaryLink`, `Trigger`, `HoverTrigger`, `Panel`, `OpenPanel`, `PanelNavigation`, `PanelLink`, `FirstPanelLink`, `Close`, `HoverClose`
 * `SearchButton`: `PendingShortcut`, `Label`, `Shortcut`, `NativeIcon`, `Icon`
 * `Button`: None
-* `Sidebar`: `Backdrop`, `OpenBackdrop`, `MobileHeading`, `HomeLink`, `HomeLogo`, `HomeLabel`, `Close`, `HoverClose`, `CloseIcon`, `CurrentLink`, `Content`, `Tree`, `List`, `Item`, `TopLevelSpacing`, `GroupSpacing`, `NestedItem`, `SectionHeading`, `Control`, `Summary`, `GroupLabel`, `GroupLabelText`, `Link`, `LinkLabel`, `InteractiveControl`, `SummaryMarker`, `Caret`, `ExpandedCaret`, `LinkedSummary`, `GroupLink`, `LinkedSectionHeading`, `SectionLink`, `Badge`, `TopLevelLink`
+* `Sidebar`: `Backdrop`, `OpenBackdrop`, `MobileHeader`, `MobileHeading`, `HomeLink`, `HomeLogo`, `HomeLabel`, `Close`, `HoverClose`, `CloseIcon`, `CurrentLink`, `Content`, `Tree`, `MobileFooter`, `List`, `Item`, `TopLevelSpacing`, `GroupSpacing`, `NestedItem`, `SectionHeading`, `Control`, `Summary`, `GroupLabel`, `GroupLabelText`, `Link`, `LinkLabel`, `InteractiveControl`, `SummaryMarker`, `Caret`, `ExpandedCaret`, `LinkedSummary`, `GroupLink`, `LinkedSectionHeading`, `SectionLink`, `Badge`, `TopLevelLink`
 * `MobileMenuToggle`: `Icon`, `Section`, `Page`
-* `MobileNavigationTabs`: `Trigger`, `Marker`, `Caret`, `ExpandedCaret`, `Label`, `List`, `Item`, `Link`, `HoverLink`, `CurrentLink`
+* `MobileNavigationTabs`: `HoverTrigger`, `TriggerLabel`, `Panel`, `OpenPanel`, `PanelTitle`, `Options`, `Checkmark`, `SelectedCheckmark`, `Trigger`, `Marker`, `Caret`, `ExpandedCaret`, `Label`, `List`, `Item`, `Link`, `HoverLink`, `CurrentLink`
 * `MobileMenuFooter`: `Social`
 * `TopNavigation`: `Scrollbar`, `Link`, `HoverLink`, `CurrentLink`, `ActiveIndicator`
 * `TableOfContentsLayout`: `Content`
@@ -469,8 +469,14 @@ Customize the outer bar with `theme.styles.HeaderFrame`, its contents with
 
 Below 50rem, page navigation moves into a header row and opens a left drawer.
 `MobileMenuToggle.Section` and `Page` style its breadcrumb labels. The drawer
-contains the complete active section, a collapsible `MobileNavigationTabs`
-selector, and a close button. The drawer slides in and out over the root
+keeps the logo, title, close button, and `MobileNavigationTabs` Select in a static
+`Sidebar.MobileHeader`, with social links and language selection in a static
+`Sidebar.MobileFooter`. Borders separate both sections from the independently
+scrolling active navigation tree (`Sidebar.Tree`). The section Select uses the
+same popover control as language and version selection. Its `Label`, `List`,
+`Item`, `Link`, `HoverLink`, and `CurrentLink` customization names remain available
+on the Select anatomy; `Marker` is retained as a compatibility hook.
+The drawer slides in and out over the root
 `$sidebar-transition` duration (default `120ms`) and
 disables motion when the reader prefers reduced motion. Its mobile shadow uses
 the Glaze `shadow`-typed `#shadow` token. Customize the movement and shadow through

package/docs/fonts-and-typography.md

@@ -107,12 +107,13 @@ The base [typography presets](./upstream/tasty/docs/styles.md#preset) are
 
 Specialized roles preserve the component sizes while sharing their base typography:
 
-| Preset         | Used for          | Base typography                                     |
-| -------------- | ----------------- | --------------------------------------------------- |
-| `hero-title`   | Hero heading      | `h1`, with a larger responsive size                 |
-| `hero-tagline` | Hero description  | `body`, with a responsive size and 1.55 line height |
-| `prose`        | Markdown content  | `body`, at 1.025rem                                 |
-| `inline-code`  | Code within prose | `code`, at 0.875em                                  |
+| Preset          | Used for                  | Base typography                                            |
+| --------------- | ------------------------- | ---------------------------------------------------------- |
+| `hero-title`    | Hero heading              | `h1`, with a larger responsive size                        |
+| `hero-tagline`  | Hero description          | `body`, with a responsive size and 1.55 line height        |
+| `prose`         | Markdown content          | `body`, at 1.025rem                                        |
+| `inline-code`   | Code within prose         | `code`, at 0.875em                                         |
+| `control-label` | Selector section headings | `small`, at 0.75rem with uppercase text and wider tracking |
 
 Customize these through `theme.presets` as well. Changes to the base font family,
 weight, tracking, and other shared fields continue to flow into the derived roles.

package/docs/migration.md

@@ -41,6 +41,25 @@ upgrade the site's Cookbook runtime or package-manager dependencies. Commit the
 documentation lock separately when intentionally updating imported content.
 Local Markdown needs no lock update.
 
+## Upcoming custom-element naming
+
+All Cookbook-owned custom elements now use the `cookbook-*` prefix, including
+UniAria behaviors and the search wrapper. Built-in components update their markup
+and behavior together. If your own components or browser scripts refer to these
+tags, update them:
+
+| Previous tag  | New tag            |
+| ------------- | ------------------ |
+| `cb-popover`  | `cookbook-popover` |
+| `cb-dialog`   | `cookbook-dialog`  |
+| `site-search` | `cookbook-search`  |
+
+Update tag selectors, `customElements.get()` and `whenDefined()` calls, and
+`HTMLElementTagNameMap` references as applicable. Component override names,
+`theme.styles` names and sub-elements, `data-uni` part markers, CSS classes,
+DOM IDs, and stored reader preferences keep their existing names. Custom
+elements authored by your site can continue using your own prefix.
+
 ## Upcoming Tasty upgrade
 
 Cookbook now uses Tasty 3.14 and the Tasty ESLint plugin 1.12. Built-in themes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tenphi/cookbook",
-  "version": "0.30.1",
+  "version": "0.31.0",
   "description": "Repository-native static documentation for Astro",
   "type": "module",
   "keywords": [
@@ -68,8 +68,8 @@
   "author": "Andrey Yamanov",
   "license": "MIT",
   "dependencies": {
-    "@tenphi/docs": "0.30.1",
-    "@tenphi/renderer": "0.30.1"
+    "@tenphi/docs": "0.31.0",
+    "@tenphi/renderer": "0.31.0"
   },
   "peerDependencies": {
     "astro": "^7.3.2"