@huaweidevtools/aishell-dsh-brand 0.0.1-beta.2 → 0.0.1-beta.3

package/lib/types/client/Brand.d.ts

@@ -7,14 +7,42 @@
  */
 import type { SidebarBrandMarkOwnerProps } from '@deepseek-ai/dsh-client-ui-sidebar/client';
 import type { HeroBrandMarkOwnerProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+/**
+ * A disposer undoing one module-level installation.
+ *
+ * The three helpers below all reach outside React — a `<style>` tag, event
+ * listeners, inserted nodes — so none of them is unwound by unmounting a
+ * component. They are installed through `ctx.effect` in `index.ts`, which runs
+ * the returned disposer on plugin unload. That matters beyond tidiness: the
+ * client loader tears a module down with `tearDownEntryFiber` (fiber effects)
+ * and `removeOwnedStyles` (only `style[data-plugin]` tags), so a bare
+ * `MutationObserver` on `document.body` is reachable by neither and would
+ * survive every HMR reload, accumulating one per reload.
+ */
+export type BrandDisposer = () => void;
+/** Inject the hero headline patch CSS; the disposer removes the tag. */
+export declare function installHeroPatchCss(target: Document): BrandDisposer;
+/**
+ * JS hover bridge: CSS ~ only matches forward siblings, so hovering the
+ * title text cannot trigger the logo's animation (the logo sits before the
+ * title in DOM order). This adds a mouseenter/mouseleave listener on the
+ * title span that toggles a class on the logo to trigger its bob animation.
+ *
+ * The disposer removes both listeners from every span it bridged, so a reload
+ * does not stack a second pair on the same element (the `data-` marker stops a
+ * *re-install* from adding them, but it also means a later disposer cannot
+ * find them by query alone — hence the bookkeeping below).
+ */
+export declare function installHeroHoverBridge(target: Document): BrandDisposer;
 /**
  * Render the AI Shell mark with the presentation requested by its host surface.
  * Used in both the expanded sidebar brand row and the collapsed rail.
  */
 export declare function AishellBrandMark({ size }: SidebarBrandMarkOwnerProps): import("react").JSX.Element;
 /**
- * Render the AI Shell name with a version badge in the top-right corner,
- * matching DSH's native `.buildVersion` badge style.
+ * Render the AI Shell name in the sidebar brand row. The product name itself
+ * is drawn by the CSS module's `.name::before` (content: 'AI Shell'), so the
+ * markup is a single empty span.
  */
 export declare function AishellBrandName(): import("react").JSX.Element;
 /**
@@ -22,4 +50,13 @@ export declare function AishellBrandName(): import("react").JSX.Element;
  * className for surrounding mark geometry (e.g. centering).
  */
 export declare function AishellHeroBrandMark({ size, className }: HeroBrandMarkOwnerProps): import("react").JSX.Element;
+/**
+ * Insert "Powered by deepseek-harness" below the hero headline, centered
+ * inside .stack. Uses a MutationObserver because the hero mounts/unmounts
+ * as the user navigates between sessions.
+ *
+ * The disposer stops the observer and removes every label this install added,
+ * so unloading the plugin leaves the hero exactly as it found it.
+ */
+export declare function installPoweredBy(target: Document): BrandDisposer;
 //# sourceMappingURL=Brand.d.ts.map

package/lib/types/client/SuggestionCards.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Example-prompt cards for the New-Session hero.
+ *
+ * ## Where this renders, and why it takes a portal to get there
+ *
+ * The entry occupies `conversation.input.dock`, the band between the hero
+ * workspace row and the input card. That is where the strip is MOUNTED — but
+ * not where it is DRAWN: the product wants the cards directly under the hero
+ * headline, and the workspace row sits between the two.
+ *
+ * Measured on the live page (1280×900):
+ *
+ *     hero (headline)              y=288  h=74
+ *     hero workspace row           y=374  h=28
+ *     conversation.input.dock      y=411  h=80
+ *     the input card               y=491
+ *
+ * The row cannot be crossed with a margin — it would be covered — and its DOM
+ * is a sibling subtree, unreachable from the dock. So the strip renders
+ * through `createPortal` into the hero's own content div, the empty `_body`
+ * the official shell leaves for exactly this. See `hero-content.ts` for how
+ * that mount is found and why it fails closed.
+ *
+ * The dock entry is still what supplies the slot props (`useSession`,
+ * `inputActions`, `t`), so the registration is unchanged; the portal only
+ * relocates the output. What the dock band itself renders is nothing.
+ *
+ * ## When it renders
+ *
+ * The dock band renders in BOTH the hero and the docked composer (it only
+ * needs a live input zone), so the gate is `session.blank` — the same
+ * condition the account chip next door uses. `blank` is true from the moment a
+ * New Session opens until the first turn is accepted: exactly the window the
+ * cards exist for. Once the first message is sent the strip renders nothing
+ * and the composer takes over.
+ *
+ * ## Why it does not look like the input card
+ *
+ * The first version read as a second input box, and the reason was measurable
+ * rather than a matter of taste. Both surfaces were built from the same two
+ * ingredients the shell reserves for a composer:
+ *
+ *   - the same neutral one step apart — the card was `bg-module-platform`
+ *     (`#353638` in dark) and the composer `specific-input-major` (`#2c2c2e`),
+ *     both rungs of one ramp, so the two read as siblings;
+ *   - the same box-shadow token. `--dsw-elevation-soft` expands to
+ *     `var(--dsw-elevation-stroke), …`, and that stroke is a
+ *     `0 0 0 .5px` ring — so "no border" had not removed the outline at all,
+ *     it had only moved it into the shadow. Both surfaces carry a hairline.
+ *
+ * The fix is to use the shell's vocabulary for a CHOICE rather than for a
+ * FIELD. Every pickable surface in the product — the option list in the
+ * question card (`border-radius: var(--dsw-radius-md)`, `background: 0 0`),
+ * the command and trigger lists, the portalled menu — draws itself the same
+ * way: a transparent ground, a `radius-md` corner, and a fill that appears
+ * only on hover or selection. A field, by contrast, is an opaque well inset
+ * into the page.
+ *
+ * So a card here is:
+ *
+ *   - TRANSLUCENT, not opaque and not empty. The shell explains this exact
+ *     choice for `SegmentedControl`: a translucent fill "reads as a place
+ *     rather than a second button". Opaque is what made the card a well;
+ *     fully transparent is invisible on a white page, where the light theme
+ *     would leave nothing but floating text. The tint is the shell's own
+ *     interactive pair — `interactive-bg-hover` at rest, `interactive-bg-active`
+ *     on hover — so hovering reads as the same material intensifying;
+ *   - `radius-md` (12px), the choice radius, against the composer's 28px
+ *     `radius-panel`;
+ *   - no shadow at rest. The shell gives an elevated surface a shadow only
+ *     when it FLOATS over other content (a menu, a hovercard, a modal); a
+ *     card sitting inline in the page gets none, so neither does this.
+ *
+ * The icon tile keeps an accent tint — `Tag`'s info tone and the plan
+ * package's chip both paint `color-mix(… business-primary 10%, transparent)`
+ * — on a square with `radius-sm`, matching those chips' geometry.
+ *
+ * ## Auto-rotation
+ *
+ * The strip shows three of four cards, so the fourth would otherwise be
+ * invisible to anyone who does not touch the arrows. It advances one card
+ * every {@link AUTOPLAY_INTERVAL_MS}, pausing on hover, on keyboard focus, in
+ * a background tab, and under `prefers-reduced-motion`. The policy itself
+ * lives in `autoplay.ts`, kept pure so the list of reasons to stop is testable
+ * rather than buried in an effect.
+ *
+ * @module @huaweidevtools/aishell-dsh-brand/client/SuggestionCards
+ */
+import { type ReactNode } from 'react';
+import type { PropsRuntime, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+/** Full component props: the dock band's owner share + the session kit + `t`. */
+export type SuggestionCardsProps = PropsRuntime<'conversation.input.dock'> & PropsLocale<'aishell-brand'>;
+export declare function SuggestionCards(props: SuggestionCardsProps): ReactNode;
+//# sourceMappingURL=SuggestionCards.d.ts.map

package/lib/types/client/aishell-mark.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The AI Shell mark as an inline source, shared by the runtime brand shadows.
+ *
+ * The slot occupants (Brand.tsx) draw the mark through a CSS module whose
+ * url() the build inlines, but the runtime shadows need the bytes as a JS
+ * string: the favicon shadow writes them into a link href, and the running
+ * status mark shadow writes them into injected patch CSS. This module is
+ * that one source, so the asset and the shadows cannot drift apart.
+ * tests/aishell-mark.spec.ts pins the constant against assets/aishell.svg.
+ *
+ * @module @huaweidevtools/aishell-dsh-brand/client/aishell-mark
+ */
+/** The AI Shell mark, verbatim assets/aishell.svg (the spec pins this). */
+export declare const AISHELL_MARK_SVG = "<svg viewBox=\"0 0 44 44\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"44.000000\" height=\"44.000000\" fill=\"none\">\n\t<defs>\n\t\t<linearGradient id=\"paint_linear_0\" x1=\"38.5\" x2=\"2.19999695\" y1=\"1.90734863e-06\" y2=\"39.5999908\" gradientUnits=\"userSpaceOnUse\">\n\t\t\t<stop stop-color=\"rgb(53,137,255)\" offset=\"0\" stop-opacity=\"1\" />\n\t\t\t<stop stop-color=\"rgb(169,38,255)\" offset=\"1\" stop-opacity=\"1\" />\n\t\t</linearGradient>\n\t</defs>\n\t<rect id=\"icon_AIShell\" width=\"44.000000\" height=\"44.000000\" x=\"0.000000\" y=\"0.000000\" fill=\"rgb(255,255,255)\" fill-opacity=\"0\" />\n\t<path id=\"\u5408\u5E76\" d=\"M37.4576 0.299738C37.3775 0.139877 37.2861 0.0428196 37.1832 0.00856393C37.0917 -0.0142732 37.006 0.00856394 36.9259 0.0770754C36.8459 0.145587 36.7887 0.219808 36.7545 0.299738C36.4572 1.86408 35.7369 3.21718 34.5937 4.35904C33.4618 5.48948 32.0956 6.22027 30.495 6.55141C30.3921 6.57424 30.3178 6.64275 30.272 6.75694C30.2377 6.87113 30.2435 6.97389 30.2892 7.06524C30.3464 7.15659 30.415 7.20226 30.495 7.20226C31.2078 7.35296 31.8779 7.58759 32.5055 7.90618L32.5055 7.9062L32.5056 7.90623C33.257 8.28771 33.9473 8.78955 34.5765 9.41176C35.7312 10.5422 36.4572 11.8896 36.7545 13.4539C36.8116 13.591 36.8974 13.6823 37.0117 13.728C37.1146 13.7622 37.2061 13.7565 37.2861 13.7109C37.3775 13.6538 37.4347 13.5681 37.4576 13.4539C37.7891 11.8896 38.5151 10.5422 39.6355 9.41176C40.7674 8.2699 42.1279 7.5334 43.717 7.20226C43.8199 7.17943 43.9 7.12233 43.9571 7.03099C44.0143 6.92822 44.0143 6.83116 43.9571 6.73981C43.9 6.63705 43.8199 6.57424 43.717 6.55141C42.1507 6.22027 40.7959 5.48948 39.6527 4.35904C38.5208 3.21718 37.7891 1.86408 37.4576 0.299738ZM42.625 16.4999L42.625 33C42.625 33.9493 42.4572 34.829 42.1216 35.6392C41.786 36.4495 41.2826 37.1902 40.6114 37.8614C39.9402 38.5326 39.1994 39.036 38.3892 39.3716C37.579 39.7072 36.6992 39.875 35.75 39.875L10.9999 39.875L8.24995 39.875C7.30073 39.875 6.42102 39.7072 5.61081 39.3716C4.80058 39.036 4.05985 38.5326 3.38863 37.8614C2.71742 37.1902 2.21402 36.4494 1.87841 35.6392C1.5428 34.829 1.375 33.9493 1.375 33L1.375 11C1.375 10.0508 1.5428 9.17106 1.8784 8.36083L1.87841 8.36082C2.21402 7.55059 2.71743 6.80987 3.38864 6.13866C4.05985 5.46745 4.80057 4.96404 5.61079 4.62843L5.6108 4.62843C6.42103 4.29282 7.30076 4.12502 8.25 4.12502L27.4999 4.125C28.2699 4.125 28.8749 4.73 28.8749 5.5C28.8749 6.27 28.2699 6.875 27.4999 6.875L8.25 6.87502C7.68045 6.87502 7.15261 6.9757 6.66648 7.17706C6.18034 7.37843 5.73591 7.68047 5.33318 8.0832C4.93046 8.48593 4.62841 8.93036 4.42705 9.41649C4.22568 9.90263 4.125 10.4305 4.125 11L4.125 33C4.125 33.5696 4.22568 34.0974 4.42705 34.5835C4.62841 35.0697 4.93045 35.5141 5.33317 35.9168C5.73588 36.3195 6.18028 36.6216 6.66639 36.8229C7.15256 37.0243 7.68042 37.125 8.24999 37.125L10.9999 37.125L35.75 37.125C36.3195 37.125 36.8474 37.0243 37.3335 36.823C37.8197 36.6216 38.2641 36.3196 38.6668 35.9168C39.0695 35.5141 39.3716 35.0697 39.573 34.5835C39.7743 34.0974 39.875 33.5696 39.875 33L39.875 16.4999C39.875 15.7299 40.48 15.1249 41.25 15.1249C42.02 15.1249 42.625 15.7299 42.625 16.4999ZM10.0277 12.7777C10.5722 12.2333 11.4278 12.2333 11.9723 12.7777L20.2222 21.0277C20.4907 21.2962 20.6249 21.6203 20.6249 22C20.6249 22.3797 20.4907 22.7037 20.2222 22.9722L11.9722 31.2223C11.4277 31.7668 10.5721 31.7668 10.0277 31.2223C9.48318 30.6779 9.48317 29.8223 10.0276 29.2778L17.3054 22L10.0277 14.7223C9.48325 14.1778 9.48326 13.3222 10.0277 12.7777ZM20.625 28.875C20.625 28.105 21.23 27.5 22 27.5L33 27.5C33.77 27.5 34.375 28.105 34.375 28.875C34.375 29.645 33.77 30.25 33 30.25L22 30.25C21.23 30.25 20.625 29.645 20.625 28.875Z\" fill=\"rgb(0,0,0)\" fill-opacity=\"0\" fill-rule=\"evenodd\" />\n\t<path id=\"\u5408\u5E76\" d=\"M37.4576 0.299738C37.3775 0.139877 37.2861 0.0428196 37.1832 0.00856393C37.0917 -0.0142732 37.006 0.00856394 36.9259 0.0770754C36.8459 0.145587 36.7887 0.219808 36.7545 0.299738C36.4572 1.86408 35.7369 3.21718 34.5937 4.35904C33.4618 5.48948 32.0956 6.22027 30.495 6.55141C30.3921 6.57424 30.3178 6.64275 30.272 6.75694C30.2377 6.87113 30.2435 6.97389 30.2892 7.06524C30.3464 7.15659 30.415 7.20226 30.495 7.20226C31.2078 7.35296 31.8779 7.58759 32.5055 7.90618L32.5055 7.9062L32.5056 7.90623C33.257 8.28771 33.9473 8.78955 34.5765 9.41176C35.7312 10.5422 36.4572 11.8896 36.7545 13.4539C36.8116 13.591 36.8974 13.6823 37.0117 13.728C37.1146 13.7622 37.2061 13.7565 37.2861 13.7109C37.3775 13.6538 37.4347 13.5681 37.4576 13.4539C37.7891 11.8896 38.5151 10.5422 39.6355 9.41176C40.7674 8.2699 42.1279 7.5334 43.717 7.20226C43.8199 7.17943 43.9 7.12233 43.9571 7.03099C44.0143 6.92822 44.0143 6.83116 43.9571 6.73981C43.9 6.63705 43.8199 6.57424 43.717 6.55141C42.1507 6.22027 40.7959 5.48948 39.6527 4.35904C38.5208 3.21718 37.7891 1.86408 37.4576 0.299738ZM42.625 16.4999L42.625 33C42.625 33.9493 42.4572 34.829 42.1216 35.6392C41.786 36.4495 41.2826 37.1902 40.6114 37.8614C39.9402 38.5326 39.1994 39.036 38.3892 39.3716C37.579 39.7072 36.6992 39.875 35.75 39.875L10.9999 39.875L8.24995 39.875C7.30073 39.875 6.42102 39.7072 5.61081 39.3716C4.80058 39.036 4.05985 38.5326 3.38863 37.8614C2.71742 37.1902 2.21402 36.4494 1.87841 35.6392C1.5428 34.829 1.375 33.9493 1.375 33L1.375 11C1.375 10.0508 1.5428 9.17106 1.8784 8.36083L1.87841 8.36082C2.21402 7.55059 2.71743 6.80987 3.38864 6.13866C4.05985 5.46745 4.80057 4.96404 5.61079 4.62843L5.6108 4.62843C6.42103 4.29282 7.30076 4.12502 8.25 4.12502L27.4999 4.125C28.2699 4.125 28.8749 4.73 28.8749 5.5C28.8749 6.27 28.2699 6.875 27.4999 6.875L8.25 6.87502C7.68045 6.87502 7.15261 6.9757 6.66648 7.17706C6.18034 7.37843 5.73591 7.68047 5.33318 8.0832C4.93046 8.48593 4.62841 8.93036 4.42705 9.41649C4.22568 9.90263 4.125 10.4305 4.125 11L4.125 33C4.125 33.5696 4.22568 34.0974 4.42705 34.5835C4.62841 35.0697 4.93045 35.5141 5.33317 35.9168C5.73588 36.3195 6.18028 36.6216 6.66639 36.8229C7.15256 37.0243 7.68042 37.125 8.24999 37.125L10.9999 37.125L35.75 37.125C36.3195 37.125 36.8474 37.0243 37.3335 36.823C37.8197 36.6216 38.2641 36.3196 38.6668 35.9168C39.0695 35.5141 39.3716 35.0697 39.573 34.5835C39.7743 34.0974 39.875 33.5696 39.875 33L39.875 16.4999C39.875 15.7299 40.48 15.1249 41.25 15.1249C42.02 15.1249 42.625 15.7299 42.625 16.4999ZM10.0277 12.7777C10.5722 12.2333 11.4278 12.2333 11.9723 12.7777L20.2222 21.0277C20.4907 21.2962 20.6249 21.6203 20.6249 22C20.6249 22.3797 20.4907 22.7037 20.2222 22.9722L11.9722 31.2223C11.4277 31.7668 10.5721 31.7668 10.0277 31.2223C9.48318 30.6779 9.48317 29.8223 10.0276 29.2778L17.3054 22L10.0277 14.7223C9.48325 14.1778 9.48326 13.3222 10.0277 12.7777ZM20.625 28.875C20.625 28.105 21.23 27.5 22 27.5L33 27.5C33.77 27.5 34.375 28.105 34.375 28.875C34.375 29.645 33.77 30.25 33 30.25L22 30.25C21.23 30.25 20.625 29.645 20.625 28.875Z\" fill=\"url(#paint_linear_0)\" fill-rule=\"evenodd\" />\n</svg>";
+/**
+ * The mark as a self-contained data URI.
+ *
+ * URL-encoded rather than base64 (shorter, and the gradient reads on both
+ * light and dark themes, which is what lets one URI serve every surface).
+ */
+export declare const AISHELL_MARK_URI: string;
+//# sourceMappingURL=aishell-mark.d.ts.map

package/lib/types/client/autoplay.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Auto-rotation policy for the example-prompt strip.
+ *
+ * Kept apart from the component and free of DOM, for the same reason
+ * `carousel.ts` is: the DECISION is what needs pinning down, and a decision
+ * buried in an effect can only be checked by watching a browser.
+ *
+ * ## Why the strip advances on its own
+ *
+ * The strip shows three of four cards, so a card is always off screen and a
+ * reader who never touches the arrows never learns it exists. Rotation is what
+ * makes the set self-evident. The cost is that content moves without being
+ * asked to, which is why every reason to stop is collected here rather than
+ * decided piecemeal at the call site.
+ *
+ * ## Every reason to stop
+ *
+ *  - `engaged` — the pointer is over the strip or focus is inside it. Someone
+ *    reaching for a card must not have it slide out from under the cursor;
+ *    this is the pause the feature was asked for, and `focus` is the half of
+ *    it that covers a reader who never uses a pointer.
+ *  - `reducedMotion` — the reader asked the platform for less movement. An
+ *    element that moves by itself for more than five seconds is exactly what
+ *    `prefers-reduced-motion` exists to suppress, and a hover pause cannot help
+ *    the reader who cannot hover. Honouring it is what keeps the feature from
+ *    being motion no one consented to.
+ *  - `visible` — the tab is hidden. A background tab still fires timers, so
+ *    without this the strip would churn through slides nobody can see and land
+ *    somewhere arbitrary on return.
+ *  - `ready` — the ring has not been measured yet. Advancing before the step
+ *    is known would move the track by a wrong distance; see the measurement
+ *    note in `SuggestionCards.tsx`.
+ *  - `ring` — three cards or fewer all fit, so there is nowhere to advance to.
+ *    A strip with nothing to scroll must not appear to scroll.
+ *
+ * @module @huaweidevtools/aishell-dsh-brand/client/autoplay
+ */
+/**
+ * How long each card is shown before the strip advances.
+ *
+ * Fixed rather than configurable: this is a hint at what the product can do,
+ * not a reading surface, and a setting nobody asked for is a setting nobody
+ * finds.
+ */
+export declare const AUTOPLAY_INTERVAL_MS = 1500;
+/** Everything that can hold the strip still. */
+export interface AutoplayInputs {
+    /** More cards than fit, so there is somewhere to advance to. */
+    readonly ring: boolean;
+    /** The ring has been measured and the track can be moved a known distance. */
+    readonly ready: boolean;
+    /** The pointer is over the strip, or focus is inside it. */
+    readonly engaged: boolean;
+    /** The reader asked for reduced motion. */
+    readonly reducedMotion: boolean;
+    /** The tab is on screen. */
+    readonly visible: boolean;
+}
+/**
+ * Whether the strip should be advancing on its own right now.
+ *
+ * Expressed as one predicate rather than a chain of early returns inside the
+ * timer, so that adding a reason to stop is a change to this list and its
+ * test — not a change to the effect that schedules the ticks.
+ */
+export declare function autoplayActive(inputs: AutoplayInputs): boolean;
+//# sourceMappingURL=autoplay.d.ts.map

package/lib/types/client/carousel.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Carousel position maths, kept pure so it can be tested without a DOM.
+ *
+ * The strip is a RING, not a scroll range: the cards form a circle, and an
+ * arrow steps one card around it forever. Clicking next from the last
+ * position lands on the first, and clicking prev from the first lands on the
+ * last — and crucially, every intermediate position exists. A four-card ring
+ * showing three at a time has FOUR positions, not two:
+ *
+ *      cards 1 2 3 4, three visible
+ *      pos 0 → [1 2 3]
+ *      pos 1 → [2 3 4]
+ *      pos 2 → [3 4 1]     ← the wrap is visible, not a jump back
+ *      pos 3 → [4 1 2]
+ *      pos 4 → [1 2 3]     same as pos 0
+ *
+ * A plain scroll container cannot express that: its range is only
+ * `content - viewport` (one step, for four cards), and positions 2 and 3 have
+ * no place to live. So the card list is rendered {@link COPIES} times over
+ * and the window travels through the middle copy, where both neighbours
+ * always have content.
+ *
+ * ## Why the copies, and how the seam stays invisible
+ *
+ * With the list rendered three times, a window at physical position `p` shows
+ * `cards[p .. p+VISIBLE-1]`, and position `2n` shows exactly what position `n`
+ * shows. That equivalence is the seam: once a slide settles at `2n`, the
+ * track can be placed at `n` in the same frame with transitions off, and
+ * nothing on screen changes. The same holds at the other end, where `n-1` and
+ * `2n-1` are the same window.
+ *
+ * The rewind happens only AFTER the slide finishes — never before. Jumping
+ * first would put the destination on screen instantly and then animate away
+ * from it, so a click at the seam would appear to skip a card. This is the
+ * one law in this module that a reader is likely to get backwards.
+ *
+ * @module @huaweidevtools/aishell-dsh-brand/client/carousel
+ */
+/**
+ * How many times the card list is rendered.
+ *
+ * Three is the minimum that works. The window lives in the middle copy, so it
+ * needs one full copy behind it (to show the cards before the start) and one
+ * ahead (to show the cards past the end while a slide is finishing at the
+ * seam, where the position may briefly reach `2n` and read up to
+ * `2n + VISIBLE - 1`).
+ */
+export declare const COPIES = 3;
+/** How many cards to render for a ring of `n`. */
+export declare function ringLength(n: number): number;
+/**
+ * The physical position the ring starts at — the first card of the middle
+ * copy. Starting here rather than at 0 is what makes the very first prev
+ * click land on a real card instead of an empty track.
+ */
+export declare function ringStart(n: number): number;
+/**
+ * Where a settled position should be silently rewound to, or `null` when it
+ * is already inside the working band.
+ *
+ * The band is `[n, 2n-1]`. A slide may finish one past either end — `2n`
+ * going forward, `n-1` going backward — and both have an exact twin inside
+ * the band. See the module note for why this runs after the slide, not
+ * before.
+ */
+export declare function rewindTo(pos: number, n: number): number | null;
+/** One arrow press, resolved into the physical positions involved. */
+export interface RingStep {
+    /**
+     * Where the track must be placed with transitions OFF before the slide.
+     * Equal to the incoming position when no rewind is due; when it differs,
+     * the jump is invisible (both positions show the same window).
+     */
+    readonly from: number;
+    /**
+     * Where the slide ends. May sit one past the band's end, in which case the
+     * next {@link rewindTo} brings it back.
+     */
+    readonly to: number;
+}
+/**
+ * Resolve one arrow press on a ring.
+ *
+ * Any rewind still owed from the previous press is settled first, so a person
+ * clicking faster than the slide animation cannot walk the window off the
+ * rendered copies — the band always absorbs one more step.
+ */
+export declare function ringStep(pos: number, delta: number, n: number): RingStep;
+/**
+ * One arrow press on a plain strip (fewer cards than fit): step by one and
+ * stay inside the scrollable range.
+ *
+ * @param maxPos - the last meaningful position, `0` when nothing scrolls.
+ */
+export declare function clampStep(pos: number, delta: number, maxPos: number): number;
+//# sourceMappingURL=carousel.d.ts.map

package/lib/types/client/favicon-shadow.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Runtime favicon and manifest shadowing for the branded distribution.
+ *
+ * The browser tab icon comes from the dsh-web-frontend dist's
+ * favicon.svg / favicon-dark.svg (a DeepSeek whale, one fixed fill per
+ * theme, selected by the index's `media="(prefers-color-scheme: …)"`
+ * links), and that dist tree is covered by the desktop-runtime digest —
+ * the file-level swap cannot reach it. The plugin side therefore shadows
+ * the links at runtime: every `link[rel~="icon"]` in the head has its
+ * href rewritten to the AI Shell mark data URI. The mark's gradient
+ * reads on both light and dark themes, so the media attribute is dropped
+ * and one icon serves both.
+ *
+ * The web manifest's display names ("DeepSeek Harness" / "DSH") are
+ * shadowed the same way when they can be: the manifest is fetched, the
+ * name/short_name fields rewritten to "AI Shell", and the link pointed
+ * at a Blob URL of the result. A manifest that cannot be fetched or
+ * parsed is left exactly as found — a broken install prompt would cost
+ * more than the name is worth.
+ *
+ * A MutationObserver watches the head, so a re-inserted icon or manifest
+ * link (HMR, later injections) is re-shadowed as it appears.
+ *
+ * Shadowing is a default, not a force (plan §2.2): install() and the
+ * disposer it returns are symmetric, so disabling the plugin restores
+ * the official links exactly.
+ *
+ * @module @huaweidevtools/aishell-dsh-brand/client/favicon-shadow
+ */
+/** The disposer restores the official icon and manifest links; a no-op install returns this. */
+export type FaviconShadowDisposer = () => void;
+/**
+ * Rewrite a manifest document's display names in place.
+ *
+ * Only the two fields the dist actually ships are touched, and only when
+ * they carry their official values — anything else in the document (icons,
+ * start_url, scope, display) passes through untouched, and a manifest the
+ * base customized keeps its customization.
+ */
+export declare function rebrandManifest(manifest: Record<string, unknown>): Record<string, unknown>;
+/** The href every icon link is shadowed with (exposed for the spec). */
+export declare const BRANDED_ICON_HREF: string;
+/**
+ * Install the favicon shadow on a document.
+ *
+ * Rewrites every current icon link's href to the AI Shell mark (dropping
+ * the media attribute so the one gradient serves both themes), shadows the
+ * manifest names when the manifest is reachable, and observes the head so
+ * re-inserted links are covered too. Returns the disposer: every touched
+ * link is restored to its original href and media, the manifest link to
+ * its original href, and the Blob URL is revoked, so an unload leaves the
+ * document exactly as it was found.
+ */
+export declare function installFaviconShadow(target: Document): FaviconShadowDisposer;
+//# sourceMappingURL=favicon-shadow.d.ts.map

package/lib/types/client/hero-content.d.ts

@@ -0,0 +1,70 @@
+/**
+ * The mount point the suggestion strip renders into, inside the hero.
+ *
+ * ## Why a portal, and not CSS placement
+ *
+ * The strip is a `conversation.input.dock` entry, and that band renders BELOW
+ * the hero workspace row in the composer stack. Measured on the live page
+ * (1280×900, DSH 0.2.x):
+ *
+ *     hero (headline)              y=288  h=74
+ *     hero workspace row           y=374  h=28
+ *     conversation.input.dock      y=411  h=80
+ *     the input card               y=491
+ *
+ * The product wants the cards directly under the headline, and the workspace
+ * row sits between. A negative margin cannot cross it — the row would be
+ * covered — and the row's own subtree is not reachable from the dock, since
+ * the two are separate children of the composer stack.
+ *
+ * The hero, however, already renders an empty content div for exactly this
+ * purpose. Its stack is: headline → (the "Powered by" label) → `_body`, where
+ * `_body` is `flex-direction: column` and left empty by the official shell.
+ * That is the hero's content area, and putting the cards there is using the
+ * slot as intended rather than fighting the layout.
+ *
+ * ## How the mount is found
+ *
+ * By the hero's own class suffix, from the headline outward — `[class*="_body"]`
+ * alone is ambiguous (the conversation root has a `_body` too, and the live
+ * page has two). So the search starts at a `[class*="_headline"]`, steps to its
+ * parent (the hero stack), and takes that stack's own `_body` child. The
+ * headline is unique on the page and is what makes the walk unambiguous.
+ *
+ * Children are walked directly rather than with `:scope >`. The two are
+ * equivalent here, and the direct walk keeps these helpers working against the
+ * hand-rolled DOM stub the specs use (which has no selector engine) instead of
+ * leaving the module's real logic untested.
+ *
+ * The classes are CSS-module hashes (`pXSMma_body`), hence the suffix match.
+ * A base bump that renames them fails closed: {@link findHeroContent} returns
+ * null, the portal renders nothing, and the arrows and cards simply do not
+ * appear — the strip is never left in the wrong parent.
+ *
+ * @module @huaweidevtools/aishell-dsh-brand/client/hero-content
+ */
+/**
+ * The hero's content area, or `null` when the hero is not on screen.
+ *
+ * Returns null rather than throwing: a New Session that has not painted its
+ * hero yet is a normal state (and the strip retries on the next frame), not an
+ * error.
+ */
+export declare function findHeroContent(target: Document): HTMLElement | null;
+/**
+ * A container for the strip inside the hero content area.
+ *
+ * The hero body is `display: block` and zero-height, so the strip cannot rely
+ * on it for layout and must not inherit that block context. The wrapper is
+ * created here rather than rendered by React into the official div, because
+ * React does not own that node — it owns only what the portal puts inside.
+ */
+export declare function ensureHeroMount(content: HTMLElement): HTMLElement;
+/**
+ * Remove the mount this module created, if it is still there.
+ *
+ * Only the mount is removed — never the host div, which belongs to the shell
+ * and is reused on the next New Session.
+ */
+export declare function removeHeroMount(content: HTMLElement): void;
+//# sourceMappingURL=hero-content.d.ts.map

package/lib/types/client/index.d.ts

@@ -8,7 +8,7 @@
  * @module @huaweidevtools/aishell-dsh-brand/client
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
-/** Required service: the UI slot registry. */
+/** Required services: the UI slot registry and the locale registry. */
 export declare const inject: string[];
 export declare function apply(ctx: ClientContext): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/client/locales.d.ts

@@ -0,0 +1,66 @@
+/**
+ * aishell brand locale dictionaries.
+ *
+ * The brand plugin owns its own namespace rather than reusing `aishell`
+ * (which `aishell-credentials` registers): a namespace's texts have exactly
+ * one owner, and a duplicate `(ns, locale)` registration throws.
+ *
+ * ## Why content lives in a dictionary
+ *
+ * The suggestion cards are the only strings in this plugin a person reads,
+ * and they are CONTENT rather than interface chrome — a card title, its
+ * one-line gloss, and the prompt a click inserts. They still belong here:
+ * a card that says「云资源查询」to an English reader is worse than no card,
+ * and the prompt it inserts would start an English conversation in Chinese.
+ *
+ * Chinese is the key-set source of truth; English is complete against it and
+ * is also the terminal fallback, so every locale other than `zh` reads
+ * English. That is the framework's own chain (`LOCALE_IDS = ["zh", "en"]`,
+ * with English carrying no fallback) — there is no third dictionary to write.
+ *
+ * @module @huaweidevtools/aishell-dsh-brand/client/locales
+ */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS: "aishell-brand";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    readonly 'suggestion.previous': "上一个示例";
+    readonly 'suggestion.next': "下一个示例";
+    readonly 'suggestion.inventory.title': "云资源查询";
+    readonly 'suggestion.inventory.gloss': "列出当前账号下的云资源";
+    readonly 'suggestion.inventory.prompt': "请列出我的华为云资源清单，按服务分类（计算、存储、网络、数据库等），标出每类资源的数量和所在区域。";
+    readonly 'suggestion.deploy.title': "部署方案推荐";
+    readonly 'suggestion.deploy.gloss': "按访问量和预算给出可落地的部署路径";
+    readonly 'suggestion.deploy.prompt': "我要部署一个轻量级 Web 应用，请对比几种可行的部署方案，说明各自的适用规模、月度成本量级和运维复杂度，并给出你的推荐及理由。";
+    readonly 'suggestion.enterprise.title': "企业上云";
+    readonly 'suggestion.enterprise.gloss': "多账号、网络分区与权限边界的整体设计";
+    readonly 'suggestion.enterprise.prompt': "请为我规划一套云上 Landing Zone 架构，覆盖账号组织结构、网络分区、权限边界与审计要求，并说明各部分的设计取舍。";
+    readonly 'suggestion.billing.title': "账单分析";
+    readonly 'suggestion.billing.gloss': "分析上个月的云资源支出";
+    readonly 'suggestion.billing.prompt': "请分析我上个月的云资源支出构成，找出占比最高的几项服务，指出其中可以优化或降配的部分，并估算调整后能节省多少。";
+};
+/** English dictionary. Complete against {@link zh}; also the terminal fallback. */
+export declare const en: {
+    readonly 'suggestion.previous': "Previous example";
+    readonly 'suggestion.next': "Next example";
+    readonly 'suggestion.inventory.title': "Cloud inventory";
+    readonly 'suggestion.inventory.gloss': "List the resources in this account";
+    readonly 'suggestion.inventory.prompt': string;
+    readonly 'suggestion.deploy.title': "Deployment options";
+    readonly 'suggestion.deploy.gloss': "A workable path for your traffic and budget";
+    readonly 'suggestion.deploy.prompt': string;
+    readonly 'suggestion.enterprise.title': "Landing zone";
+    readonly 'suggestion.enterprise.gloss': "Multi-account structure, network and permission boundaries";
+    readonly 'suggestion.enterprise.prompt': string;
+    readonly 'suggestion.billing.title': "Billing analysis";
+    readonly 'suggestion.billing.gloss': "Break down last month's cloud spend";
+    readonly 'suggestion.billing.prompt': string;
+};
+/** Every key, derived from the zh dictionary (the source of truth). */
+export type AishellBrandLocaleKey = keyof typeof zh;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        'aishell-brand': AishellBrandLocaleKey;
+    }
+}
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/running-mark-shadow.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Running-status whale-tail shadow for the branded distribution.
+ *
+ * ui-chat's RunningWhaleTail renders the DeepSeek whale: an APNG
+ * (running-whale@2x.png) masked over currentColor inside a 14px
+ * runningIcon box, with a static stroke SVG fallback for reduced motion.
+ * All of it is digest-protected in the dsh tree, and there is no slot for
+ * it — the row lives inside ui-chat's ChatView, which a plugin cannot
+ * register into. The shadow therefore works the same way the hero
+ * headline patch does (Brand.tsx): a CSS patch injected into the head,
+ * anchored on the row's stable literal attribute [data-chat-running]
+ * (RunningStatus.tsx writes it directly; the class names around it are
+ * CSS-module hashes, so they are matched by the same [class*="…"]
+ * substring selectors the hero patch already relies on).
+ *
+ * The patch hides both whale layers and repaints the runningIcon box with
+ * the AI Shell mark (a data URI background), adding a gentle bob/pulse
+ * that follows the official whale's degradation: under
+ * prefers-reduced-motion the mark is static, matching the official
+ * whale's own reduced-motion fallback.
+ *
+ * Shadowing is a default, not a force (plan §2.2): install() and the
+ * disposer it returns are symmetric, so disabling the plugin restores
+ * the official whale exactly.
+ *
+ * @module @huaweidevtools/aishell-dsh-brand/client/running-mark-shadow
+ */
+/** The disposer removes the patch style element; a no-op install returns this. */
+export type RunningMarkShadowDisposer = () => void;
+/** Marker attribute the patch style element carries (exposed for the spec). */
+export declare const RUNNING_PATCH_MARKER = "data-aishell-running-mark";
+/**
+ * The patch CSS. The whale layers are hidden unconditionally — the static
+ * fallback too, because the mark replaces both — while the mark's own
+ * animation is guarded so reduced motion keeps it still.
+ */
+export declare const RUNNING_MARK_PATCH_CSS: string;
+/**
+ * Install the running-mark shadow on a document.
+ *
+ * Injects the patch CSS once (guarded by the marker attribute so a second
+ * install is a no-op) and returns the disposer that removes the element.
+ */
+export declare function installRunningMarkShadow(target: Document): RunningMarkShadowDisposer;
+//# sourceMappingURL=running-mark-shadow.d.ts.map

package/lib/types/client/running-text-shadow.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Running-status copy shadow for the branded distribution.
+ *
+ * ui-chat's locale dictionary names the live running line after DeepSeek's
+ * own product language: zh "深度求索中" / "深度求索中，用时 {duration} ···",
+ * en "Deep diving" / "Deep diving for {duration} ···". locale.register
+ * throws on an already-claimed namespace, so the `chat` dictionary cannot
+ * be re-registered — the shadow rewrites the rendered text instead.
+ *
+ * The row re-renders every second while a Turn runs (LIVE_RUN_CLOCK_
+ * INTERVAL_MS = 1000), so a one-shot rewrite would flash the official
+ * copy on every tick. A MutationObserver watches [data-chat-running]
+ * subtrees — characterData for the second ticks, childList for mounts,
+ * and the data-shimmer-text attribute because TextShimmer paints its
+ * highlight layer through CSS `content: attr(data-shimmer-text)`: a text
+ * node rewritten without the attribute would keep showing the old glyphs
+ * every time the highlight sweeps across them.
+ *
+ * One substring replacement covers both keys: the duration form begins
+ * with the same prefix as the bare form, so replacing "深度求索中" →
+ * "思考中" and "Deep diving" → "Thinking" rewrites the long sentences
+ * too. The row's aria-hidden status span carries the same text and sits
+ * inside the same subtree, so it is covered by the same sweep. Duration
+ * units and the "···" tail are the harness's own words, not product
+ * branding, and pass through untouched.
+ *
+ * Shadowing is a default, not a force (plan §2.2): install() and the
+ * disposer it returns are symmetric, so disabling the plugin restores
+ * the official copy exactly.
+ *
+ * @module @huaweidevtools/aishell-dsh-brand/client/running-text-shadow
+ */
+/** The disposer stops the observer and restores the official copy; a no-op install returns this. */
+export type RunningTextShadowDisposer = () => void;
+/**
+ * Rewrite the running-line copy inside a value.
+ *
+ * Every occurrence of either official phrase is replaced; a value without
+ * them is returned as-is — the shadow never invents content.
+ */
+export declare function rebrandRunningText(value: string): string;
+/**
+ * Install the running-text shadow on a document.
+ *
+ * Sweeps every mounted [data-chat-running] row once, then observes the
+ * document body for new rows (childList) and their text/attribute
+ * changes (characterData, data-shimmer-text) so the per-second re-renders
+ * stay covered for as long as the row exists. Returns the disposer: the
+ * observer stops and every live row is restored to its official copy.
+ */
+export declare function installRunningTextShadow(target: Document): RunningTextShadowDisposer;
+//# sourceMappingURL=running-text-shadow.d.ts.map