@huanlin/dsh-plugin-preface-context 0.1.0

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":["clsx","IconChevronDownOutline14","en: Record<PrefaceLocaleKey, string>","zh: Record<PrefaceLocaleKey, string>"],"sources":["../node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs","../src/client/preface-card.css.ts","../src/client/preface-card.tsx","../src/client/preface-card-controller.ts","../src/client/locales.ts","../src/client/index.ts"],"sourcesContent":["function r(e){var t,f,n=\"\";if(\"string\"==typeof e||\"number\"==typeof e)n+=e;else if(\"object\"==typeof e)if(Array.isArray(e)){var o=e.length;for(t=0;t<o;t++)e[t]&&(f=r(e[t]))&&(n&&(n+=\" \"),n+=f)}else for(f in e)e[f]&&(n&&(n+=\" \"),n+=f);return n}export function clsx(){for(var e,t,f=0,n=\"\",o=arguments.length;f<o;f++)(e=arguments[f])&&(t=r(e))&&(n&&(n+=\" \"),n+=t);return n}export default clsx;","/**\n * Card styles + runtime style injection for the preface-context settings\n * card.\n *\n * The DSH client loader never serves `.css` artifacts — every style must be\n * injected inside the bundle's factory closure (the same contract the\n * upstream tsdown.client preset implements with lightningcss). A plain\n * template-string stylesheet installed once at plugin activation is the slim\n * equivalent for a hand-rolled bundle: static, prefixed class names\n * (`dsh-pfc-*`, unique in the document) replace the hashed CSS-modules map,\n * and the `<style data-plugin-css>` tag is removed when the plugin unloads.\n *\n * Colors resolve through `--dsw-alias-*` tokens so the card adapts to the\n * light/dark theme.\n *\n * @module @huanlin/dsh-plugin-preface-context/client/preface-card.css\n */\n\n/** Class-name map consumed by the card component (CSS-modules replacement). */\nexport const css = {\n  card: 'dsh-pfc-card',\n  cardOpen: 'dsh-pfc-card--open',\n  header: 'dsh-pfc-header',\n  headText: 'dsh-pfc-head-text',\n  name: 'dsh-pfc-name',\n  description: 'dsh-pfc-description',\n  pending: 'dsh-pfc-pending',\n  chevron: 'dsh-pfc-chevron',\n  chevronOpen: 'dsh-pfc-chevron--open',\n  body: 'dsh-pfc-body',\n  readOnly: 'dsh-pfc-readonly',\n  field: 'dsh-pfc-field',\n  head: 'dsh-pfc-field-head',\n  label: 'dsh-pfc-label',\n  badges: 'dsh-pfc-badges',\n  badge: 'dsh-pfc-badge',\n  reset: 'dsh-pfc-reset',\n  textarea: 'dsh-pfc-textarea',\n  toggleRow: 'dsh-pfc-toggle-row',\n  toggle: 'dsh-pfc-toggle',\n  toggleOn: 'dsh-pfc-toggle--on',\n  knob: 'dsh-pfc-knob',\n  knobOn: 'dsh-pfc-knob--on',\n  hint: 'dsh-pfc-hint',\n  footer: 'dsh-pfc-footer',\n  failed: 'dsh-pfc-failed',\n  discard: 'dsh-pfc-discard',\n  save: 'dsh-pfc-save',\n} as const\n\n/** `data-plugin-css` tag id of the injected stylesheet. */\nconst STYLE_TAG_ID = '@huanlin/dsh-plugin-preface-context/preface-card.css'\n\n/** The card stylesheet (injected as one tagged `<style>` at activation). */\nconst CSS = `\n.dsh-pfc-card {\n  list-style: none;\n  border: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.22));\n  background: var(--dsw-alias-bg-layer-3, transparent);\n  border-radius: 12px;\n  transition: border-color 0.16s, background 0.16s;\n  overflow: hidden;\n}\n\n.dsh-pfc-card--open {\n  border-color: var(--dsw-alias-border-l3, rgba(128, 128, 128, 0.35));\n}\n\n.dsh-pfc-header {\n  display: flex;\n  width: 100%;\n  align-items: center;\n  gap: 12px;\n  padding: 14px 16px;\n  font: inherit;\n  color: inherit;\n  text-align: left;\n  background: transparent;\n  border: 0;\n  cursor: pointer;\n}\n\n.dsh-pfc-head-text {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  gap: 4px;\n  min-width: 0;\n}\n\n.dsh-pfc-name {\n  font-size: 15px;\n  font-weight: 600;\n  line-height: 1.4;\n  color: var(--dsw-alias-label-primary, inherit);\n}\n\n.dsh-pfc-description {\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary, rgba(128, 128, 128, 0.7));\n}\n\n.dsh-pfc-pending {\n  flex: none;\n  white-space: nowrap;\n  font-size: 11px;\n  font-weight: 500;\n  line-height: 17px;\n  padding: 1px 8px;\n  border-radius: 999px;\n  color: var(--dsw-alias-label-secondary, inherit);\n  background: var(--dsw-alias-bg-module-platform, rgba(128, 128, 128, 0.12));\n}\n\n.dsh-pfc-chevron {\n  flex: none;\n  display: inline-flex;\n  align-items: center;\n  color: var(--dsw-alias-label-tertiary, inherit);\n  transition: transform 0.16s;\n}\n\n.dsh-pfc-chevron--open {\n  transform: rotate(180deg);\n}\n\n.dsh-pfc-body {\n  margin: 0 16px;\n  padding: 12px 0 4px;\n  border-top: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.22));\n}\n\n.dsh-pfc-readonly {\n  margin: 0 0 8px;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary, rgba(128, 128, 128, 0.7));\n}\n\n.dsh-pfc-field {\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n  margin: 0 0 12px;\n}\n\n.dsh-pfc-field-head {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n}\n\n.dsh-pfc-label {\n  font-size: 13px;\n  font-weight: 500;\n  color: var(--dsw-alias-label-primary, inherit);\n}\n\n.dsh-pfc-badges {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  margin-left: auto;\n}\n\n.dsh-pfc-badge {\n  font-size: 11px;\n  font-weight: 500;\n  line-height: 17px;\n  padding: 1px 8px;\n  border-radius: 999px;\n  color: var(--dsw-alias-label-secondary, inherit);\n  background: var(--dsw-alias-bg-module-platform, rgba(128, 128, 128, 0.12));\n}\n\n.dsh-pfc-reset {\n  appearance: none;\n  font: inherit;\n  font-size: 12px;\n  padding: 0;\n  border: 0;\n  background: transparent;\n  cursor: pointer;\n  color: var(--dsw-alias-brand-primary, #0a84ff);\n}\n\n.dsh-pfc-reset:disabled {\n  cursor: not-allowed;\n  opacity: 0.5;\n}\n\n.dsh-pfc-textarea {\n  width: 100%;\n  box-sizing: border-box;\n  min-height: 96px;\n  resize: vertical;\n  padding: 6px 10px;\n  font-family: var(--dsw-font-mono, ui-monospace, monospace);\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary, inherit);\n  background: var(--dsw-alias-bg-layer-3, transparent);\n  border: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.3));\n  border-radius: 8px;\n}\n\n.dsh-pfc-textarea:focus {\n  outline: none;\n  border-color: var(--dsw-alias-brand-primary, #0a84ff);\n}\n\n.dsh-pfc-textarea:disabled {\n  opacity: 0.6;\n  cursor: not-allowed;\n}\n\n.dsh-pfc-toggle-row {\n  display: flex;\n  align-items: center;\n  gap: 10px;\n}\n\n.dsh-pfc-toggle {\n  position: relative;\n  width: 40px;\n  height: 22px;\n  flex: none;\n  padding: 0;\n  background: var(--dsw-alias-bg-module-platform, rgba(128, 128, 128, 0.12));\n  border: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.3));\n  border-radius: 999px;\n  cursor: pointer;\n  transition: background 0.16s, border-color 0.16s;\n}\n\n.dsh-pfc-toggle--on {\n  background: var(--dsw-alias-brand-primary, #0a84ff);\n  border-color: var(--dsw-alias-brand-primary, #0a84ff);\n}\n\n.dsh-pfc-knob {\n  position: absolute;\n  top: 2px;\n  left: 2px;\n  width: 16px;\n  height: 16px;\n  background: var(--dsw-alias-bg-layer-1, #fff);\n  border-radius: 50%;\n  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.2);\n  transition: transform 0.16s;\n}\n\n.dsh-pfc-knob--on {\n  transform: translateX(18px);\n}\n\n.dsh-pfc-toggle:disabled {\n  cursor: not-allowed;\n  opacity: 0.5;\n}\n\n.dsh-pfc-hint {\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary, rgba(128, 128, 128, 0.6));\n}\n\n.dsh-pfc-footer {\n  display: flex;\n  align-items: center;\n  justify-content: flex-end;\n  gap: 8px;\n  padding: 12px 0 4px;\n  border-top: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.22));\n}\n\n.dsh-pfc-failed {\n  flex: 1 1 auto;\n  min-width: 0;\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-error, #ff453a);\n}\n\n.dsh-pfc-discard,\n.dsh-pfc-save {\n  appearance: none;\n  font: inherit;\n  font-size: 13px;\n  font-weight: 500;\n  line-height: 20px;\n  padding: 5px 14px;\n  border: 1px solid transparent;\n  border-radius: 8px;\n  cursor: pointer;\n  color: var(--dsw-alias-label-primary, inherit);\n  background: var(--dsw-alias-bg-module-platform, rgba(128, 128, 128, 0.12));\n  transition: background 0.16s, opacity 0.16s;\n}\n\n.dsh-pfc-save {\n  background: var(--dsw-alias-brand-primary, #0a84ff);\n  color: var(--dsw-alias-bg-layer-1, #fff);\n}\n\n.dsh-pfc-discard:disabled,\n.dsh-pfc-save:disabled {\n  cursor: not-allowed;\n  opacity: 0.5;\n}\n`\n\n/**\n * Install the card stylesheet as one tagged `<style>` element.\n * @returns the disposer removing the tag (idempotent outside a document).\n */\nexport function installPrefaceCardStyles(): () => void {\n  if (typeof document === 'undefined') return () => {}\n  if (document.querySelector(`style[data-plugin-css='${STYLE_TAG_ID}']`) !== null) return () => {}\n  const style = document.createElement('style')\n  style.dataset.plugin = '@huanlin/dsh-plugin-preface-context'\n  style.dataset.pluginCss = STYLE_TAG_ID\n  style.textContent = CSS\n  document.head.appendChild(style)\n  return () => { style.remove() }\n}\n","/**\n * The preface-context settings card: a collapsible card on the \"插件配置\"\n * settings page. Renders an enable toggle and a multiline textarea for the\n * context text. Stages edits locally and writes them on save through the\n * bound {@link PrefaceCardController}.\n *\n * The chrome mirrors the upstream `PluginCard` shape (a header button\n * stacking name over description, a dirty pill, a rotating chevron; a body\n * with the form controls and a footer with Discard/Save) because the\n * upstream client value face exports no reusable card. Styles come from the\n * statically injected `preface-card.css` stylesheet (the loader never serves\n * `.css` artifacts); every color resolves through a `--dsw-alias-*` token so\n * the card adapts to the light/dark theme.\n */\n\nimport { useState, type ReactNode } from 'react'\nimport clsx from 'clsx'\nimport { IconChevronDownOutline14 } from '@deepseek-ai/dsh-client-ui-primitives'\nimport type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'\nimport { css } from './preface-card.css.ts'\nimport type { PrefaceCardFace, PrefaceCardActions } from './preface-card-controller.ts'\n\n/** Injected dependencies of the card (slot `inject`). */\nexport type PrefaceCardInjected = PrefaceCardFace & PrefaceCardActions\n\n/** Props the renderer binds for the card. */\nexport type PrefaceCardProps =\n  PropsRuntime<'settings.plugin.item'>\n  & PropsLocale<'settings.preface-context'>\n  & InjectFace<PrefaceCardInjected>\n\n/**\n * Render the preface-context card.\n * @param props - locale copy, the card snapshot, and its form actions.\n * @returns the card, or nothing when the namespace is unavailable.\n */\nexport function PrefaceCard(props: PrefaceCardProps): ReactNode {\n  const [open, setOpen] = useState(false)\n  const { t } = props\n  const state = props.usePrefaceCard(snapshot => snapshot)\n  if (!state.available) return null\n  const title = t('title')\n  const blocked = !state.dirty || state.saving\n  const enabledOn = state.enabled.text === 'true'\n  return (\n    <li className={clsx(css.card, open && css.cardOpen)}>\n      <button\n        type=\"button\"\n        className={css.header}\n        aria-expanded={open}\n        aria-label={`${t(open ? 'collapse' : 'expand')}: ${title}`}\n        onClick={() => { setOpen(!open) }}\n      >\n        <span className={css.headText}>\n          <span className={css.name}>{title}</span>\n          <span className={css.description}>{t('description')}</span>\n        </span>\n        {state.dirty ? <span className={css.pending}>{t('unsaved')}</span> : null}\n        <IconChevronDownOutline14 className={clsx(css.chevron, open && css.chevronOpen)} />\n      </button>\n      {open\n        ? (\n          <div className={css.body}>\n            {!state.writable ? <p className={css.readOnly} role=\"status\">{t('readOnly')}</p> : null}\n            <div className={css.field}>\n              <div className={css.head}>\n                <label className={css.label}>{t('enabled')}</label>\n                {state.enabled.overridden\n                  ? (\n                    <span className={css.badges}>\n                      <span className={css.badge}>{t('overridden')}</span>\n                      <button\n                        type=\"button\"\n                        className={css.reset}\n                        disabled={!state.writable}\n                        onClick={() => { props.resetField('enabled') }}\n                      >\n                        {t('reset')}\n                      </button>\n                    </span>\n                  )\n                  : null}\n              </div>\n              <div className={css.toggleRow}>\n                <button\n                  type=\"button\"\n                  role=\"switch\"\n                  aria-checked={enabledOn}\n                  className={clsx(css.toggle, enabledOn && css.toggleOn)}\n                  disabled={!state.writable}\n                  onClick={() => { props.edit('enabled', enabledOn ? 'false' : 'true') }}\n                >\n                  <span className={clsx(css.knob, enabledOn && css.knobOn)} />\n                </button>\n              </div>\n              <p className={css.hint}>{t('enabledHint')}</p>\n            </div>\n            <div className={css.field}>\n              <div className={css.head}>\n                <label className={css.label}>{t('contextText')}</label>\n                {state.contextText.overridden\n                  ? (\n                    <span className={css.badges}>\n                      <span className={css.badge}>{t('overridden')}</span>\n                      <button\n                        type=\"button\"\n                        className={css.reset}\n                        disabled={!state.writable}\n                        onClick={() => { props.resetField('contextText') }}\n                      >\n                        {t('reset')}\n                      </button>\n                    </span>\n                  )\n                  : null}\n              </div>\n              <textarea\n                id=\"plugin-config-preface-context-text\"\n                className={css.textarea}\n                value={state.contextText.text}\n                placeholder={t('contextTextPlaceholder')}\n                disabled={!state.writable}\n                onChange={(event) => { props.edit('contextText', event.target.value) }}\n              />\n              <p className={css.hint}>{t('contextTextHint')}</p>\n            </div>\n            <div className={css.footer}>\n              {state.failed ? <p className={css.failed} role=\"status\">{t('saveFailed')}</p> : null}\n              <button\n                type=\"button\"\n                className={css.discard}\n                disabled={!state.dirty || state.saving}\n                onClick={props.discard}\n              >\n                {t('discard')}\n              </button>\n              <button\n                type=\"button\"\n                className={css.save}\n                disabled={blocked}\n                onClick={props.save}\n              >\n                {t(state.saving ? 'saving' : 'save')}\n              </button>\n            </div>\n          </div>\n        )\n        : null}\n    </li>\n  )\n}\n","/**\n * The preface-context card's staged form over the `preface-context` settings\n * namespace.\n *\n * The upstream `ui-settings-plugins` package owns a `CardForm` helper, but it\n * is an internal module (not re-exported from the package's `/client` public\n * face), so an external plugin cannot reuse it. This controller is a slim\n * equivalent: it stages the two fields (`enabled` boolean, `contextText`\n * multiline string) and writes them through the bound {@link SettingsScope}\n * on save, re-deriving its projection whenever the scope or a draft changes.\n *\n * Unlike the upstream `CardForm`, the `contextText` field is a multiline\n * textarea: its draft preserves internal whitespace and newlines (the\n * upstream `textField` helper trims, which would collapse a multi-paragraph\n * preface into one line).\n */\n\nimport type { SnapshotStore } from '@deepseek-ai/dsh-client-store'\nimport type { SettingsScope, SettingsScopeSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client'\n\n/** A minimal snapshot store: a value + a listener set. Self-contained so the\n * controller does not pull `createSnapshotStore` (a browser-bundle symbol)\n * into its unit-test graph. */\nclass MiniSnapshotStore<T> implements SnapshotStore<T> {\n  private snapshot: T\n  private readonly listeners = new Set<() => void>()\n\n  constructor(initial: T) {\n    this.snapshot = initial\n  }\n\n  getSnapshot(): T {\n    return this.snapshot\n  }\n\n  set(value: T): void {\n    this.snapshot = value\n    for (const listener of [...this.listeners]) listener()\n  }\n\n  update(mutator: (draft: T) => void): void {\n    // Shallow-clone then mutate (the projections here are plain objects with\n    // no nested mutation, so a deep immer draft is unnecessary).\n    const draft = Array.isArray(this.snapshot) ? [...this.snapshot] as unknown as T : { ...this.snapshot as object } as T\n    mutator(draft)\n    this.set(draft)\n  }\n\n  subscribe(listener: () => void): () => void {\n    this.listeners.add(listener)\n    return () => { this.listeners.delete(listener) }\n  }\n}\nimport type { PrefaceConfig } from '../config.ts'\n\n/** The two fields this card edits, as draft text. */\nexport interface PrefaceDraft {\n  /** `enabled` draft — 'true' or 'false'. */\n  enabled: string\n  /** `contextText` draft — the raw textarea value, whitespace preserved. */\n  contextText: string\n}\n\n/** One field's render state. */\nexport interface PrefaceFieldState {\n  /** Draft text the control renders. */\n  text: string\n  /** Whether saving would leave a user-layer entry for this field. */\n  overridden: boolean\n}\n\n/** Card-level state shared with the component. */\nexport interface PrefaceCardState {\n  /** False while the namespace is not served to this client. */\n  available: boolean\n  /** Whether the Host document accepts writes. */\n  writable: boolean\n  /** Whether the form holds edits that a save would write. */\n  dirty: boolean\n  /** Whether a save is crossing the wire. */\n  saving: boolean\n  /** Whether the last save did not land as staged. */\n  failed: boolean\n  /** The `enabled` field state. */\n  enabled: PrefaceFieldState\n  /** The `contextText` field state. */\n  contextText: PrefaceFieldState\n}\n\n/** The write actions the card's slot entry injects. */\nexport interface PrefaceCardActions {\n  /** Stage draft text for one field. */\n  edit: (field: keyof PrefaceDraft, text: string) => void\n  /** Stage a clear, so saving lets the field re-inherit the composition layer. */\n  resetField: (field: keyof PrefaceDraft) => void\n  /** Write every staged edit, then re-seed from what the Host accepted. */\n  save: () => void\n  /** Drop every staged edit. */\n  discard: () => void\n}\n\n/** The registration-side face the card's slot entry injects. */\nexport interface PrefaceCardFace {\n  hooks: {\n    /** Card snapshot bound by the renderer as usePrefaceCard. */\n    prefaceCard: SnapshotStore<PrefaceCardState>\n  }\n}\n\n/** Field names this card edits, keyed for the staged-edit map. */\ntype FieldName = keyof PrefaceDraft\n\n/** One staged edit. */\ninterface StagedEdit {\n  /** Draft text the control renders. */\n  text: string\n  /** True when this edit clears the field. */\n  clear: boolean\n}\n\n/** The default value for a field when the user-layer carries none. */\nfunction baseValue(snapshot: SettingsScopeSnapshot<PrefaceConfig>, field: FieldName): unknown {\n  return (snapshot.base as Record<string, unknown> | undefined)?.[field]\n}\n\n/** The current resolved value of a field. */\nfunction sectionValue(snapshot: SettingsScopeSnapshot<PrefaceConfig>, field: FieldName): unknown {\n  return (snapshot.value as Record<string, unknown> | undefined)?.[field]\n}\n\n/** Whether the user layer carries an entry for a field. */\nfunction stored(snapshot: SettingsScopeSnapshot<PrefaceConfig>, field: FieldName): boolean {\n  const user = snapshot.user as Record<string, unknown> | undefined\n  return user !== undefined && Object.hasOwn(user, field)\n}\n\n/** Format a stored value as draft text for a field. */\nfunction format(field: FieldName, value: unknown): string {\n  if (field === 'enabled') return value === true ? 'true' : 'false'\n  if (field === 'contextText') return typeof value === 'string' ? value : ''\n  return ''\n}\n\n/** Parse draft text into a write value, or undefined when invalid. */\nfunction parse(field: FieldName, text: string): { value: unknown } | { clear: true } | undefined {\n  if (field === 'enabled') {\n    // The toggle is a boolean; the textarea is not used for this field.\n    return { value: text === 'true' }\n  }\n  // contextText: empty draft clears the field; otherwise the raw text is the\n  // value. Internal whitespace and newlines are preserved.\n  const trimmed = text.trim()\n  return trimmed === '' ? { clear: true } : { value: text }\n}\n\n/**\n * Bridges the `preface-context` scope onto the card's staged form.\n *\n * Publishes through a snapshot store because slot components read through a\n * snapshot selector, while both the scope and the local drafts change\n * underneath; every projection is rebuilt from the two together.\n */\nexport class PrefaceCardController {\n  private readonly scope: SettingsScope<PrefaceConfig>\n  private readonly store: SnapshotStore<PrefaceCardState>\n  private readonly staged = new Map<FieldName, StagedEdit>()\n  private saving = false\n  private failed = false\n\n  /** @param scope - the bound settings scope for the `preface-context` namespace. */\n  constructor(scope: SettingsScope<PrefaceConfig>) {\n    this.scope = scope\n    this.store = new MiniSnapshotStore<PrefaceCardState>(this.project())\n    scope.subscribe(() => { this.publish() })\n  }\n\n  /** @returns the store the card's component reads through its bound selector. */\n  get snapshot(): SnapshotStore<PrefaceCardState> {\n    return this.store\n  }\n\n  private project(): PrefaceCardState {\n    const snapshot = this.scope.getSnapshot()\n    const dirty = this.staged.size > 0\n    return {\n      available: snapshot.status === 'ready',\n      writable: snapshot.writable,\n      dirty,\n      saving: this.saving,\n      failed: this.failed,\n      enabled: this.fieldState(snapshot, 'enabled'),\n      contextText: this.fieldState(snapshot, 'contextText'),\n    }\n  }\n\n  private fieldState(snapshot: SettingsScopeSnapshot<PrefaceConfig>, field: FieldName): PrefaceFieldState {\n    const staged = this.staged.get(field)\n    if (staged === undefined) {\n      return { text: format(field, sectionValue(snapshot, field)), overridden: stored(snapshot, field) }\n    }\n    const write = staged.clear ? { clear: true as const } : parse(field, staged.text)\n    return {\n      text: staged.text,\n      overridden: write !== undefined && 'value' in write,\n    }\n  }\n\n  /** Build the face the card's slot registration injects. */\n  inject(): PrefaceCardFace & PrefaceCardActions {\n    return {\n      hooks: { prefaceCard: this.store },\n      edit: (field, text) => { this.stage(field, { text, clear: false }) },\n      resetField: (field) => {\n        this.stage(field, { text: format(field, baseValue(this.scope.getSnapshot(), field)), clear: true })\n      },\n      save: () => { void this.save() },\n      discard: () => {\n        if (this.staged.size === 0 && !this.failed) return\n        this.staged.clear()\n        this.failed = false\n        this.publish()\n      },\n    }\n  }\n\n  private stage(field: FieldName, edit: StagedEdit): void {\n    this.staged.set(field, edit)\n    this.failed = false\n    this.publish()\n  }\n\n  private publish(): void {\n    this.store.set(this.project())\n  }\n\n  /** Write every staged edit, then re-seed from what the Host accepted. */\n  private async save(): Promise<void> {\n    if (this.staged.size === 0 || this.saving) return\n    this.saving = true\n    this.failed = false\n    this.publish()\n    let landed = true\n    for (const [field, staged] of this.staged) {\n      const write = staged.clear ? { clear: true as const } : parse(field, staged.text)\n      if (write === undefined) continue\n      try {\n        if ('clear' in write) {\n          await this.scope.unset(field)\n        } else {\n          await this.scope.set(field, write.value)\n        }\n      } catch {\n        landed = false\n      }\n    }\n    if (landed) this.staged.clear()\n    this.saving = false\n    this.failed = !landed\n    this.publish()\n  }\n}\n","/** Locale bundles for the preface-context settings card. */\n\n/** Locale keys the preface-context card renders. */\nexport type PrefaceLocaleKey =\n  | 'title' | 'description'\n  | 'enabled' | 'enabledHint'\n  | 'contextText' | 'contextTextHint' | 'contextTextPlaceholder'\n  | 'overridden' | 'reset'\n  | 'save' | 'saving' | 'discard' | 'unsaved' | 'saveFailed'\n  | 'readOnly' | 'expand' | 'collapse'\n\n/** English copy. */\nexport const en: Record<PrefaceLocaleKey, string> = {\n  title: 'Preface context',\n  description: 'Inject a text block as model-visible instructions at the start of every session.',\n  enabled: 'Enabled',\n  enabledHint: 'When off, no context is injected at session start.',\n  contextText: 'Context text',\n  contextTextHint: 'Injected once per session as instructions context, closest to the model\\u2019s first answer. Empty text injects nothing.',\n  contextTextPlaceholder: 'Enter the text to inject at the start of every session\\u2026',\n  overridden: 'Overridden',\n  reset: 'Reset to default',\n  save: 'Save',\n  saving: 'Saving\\u2026',\n  discard: 'Discard',\n  unsaved: 'Unsaved',\n  saveFailed: 'The deployment did not accept these values; they were left for you to correct.',\n  readOnly: 'This deployment stores settings read-only.',\n  expand: 'Show settings',\n  collapse: 'Hide settings',\n}\n\n/** Simplified Chinese copy. */\nexport const zh: Record<PrefaceLocaleKey, string> = {\n  title: '前言上下文',\n  description: '在每次会话开头注入一段文本作为模型可见的指令上下文。',\n  enabled: '启用',\n  enabledHint: '关闭后，会话开始时不注入任何上下文。',\n  contextText: '上下文文本',\n  contextTextHint: '每次会话注入一次，作为指令上下文最贴近模型的首个回答。文本为空则不注入。',\n  contextTextPlaceholder: '输入要在每次会话开头注入的文本\\u2026',\n  overridden: '已覆盖',\n  reset: '恢复默认',\n  save: '保存',\n  saving: '保存中\\u2026',\n  discard: '放弃修改',\n  unsaved: '未保存',\n  saveFailed: '本部署没有接受这些值，已保留供你修改。',\n  readOnly: '本部署的设置为只读。',\n  expand: '展开设置',\n  collapse: '收起设置',\n}\n","/**\n * Preface-context settings plugin, browser half. Registers the\n * `preface-context` card into the shell-declared `settings.plugin.item` slot\n * (the \"插件配置\" settings page), keyed by the `preface-context` settings\n * namespace. The card's controller binds the namespace through\n * `ctx.settingsScope.bind()`, which reads/writes through the standard\n * `settings.describe` / `settings.mutate` RPCs (the apiproxy accepts any\n * registered namespace — no allowlist gate on current upstream dsh).\n *\n * Export discipline: value-imports ONLY the frozen platform module table\n * (React / cordis / ui-primitives); every other `@deepseek-ai/*` import is\n * type-only (erased at build) — values arrive via cordis injection\n * (`ctx.settingsScope` is the read/write channel).\n */\n\nimport type { Context } from '@deepseek-ai/cordis'\n// Type-only: pulls the locale plugin's Context merge (ctx.locale).\nimport type {} from '@deepseek-ai/dsh-client-locale/client'\n// Type-only: pulls the settings domain's ctx.settingsScope Context merge.\nimport type {} from '@deepseek-ai/dsh-client-ui-settings/client'\n// Type-only: pulls the plugin-config card slot's SlotMap merge (the\n// 'settings.plugin.item' keyed entry — this half's registration target).\nimport type {} from '@deepseek-ai/dsh-client-ui-settings-plugins/client'\n// Type-only: pulls the renderer's ctx.slots Context merge (the composition\n// root service; moved here from the deleted dsh-client-runtime).\nimport type {} from '@deepseek-ai/dsh-client-ui-renderer/client'\nimport { PrefaceCard } from './preface-card.tsx'\nimport type { PrefaceCardInjected } from './preface-card.tsx'\nimport { installPrefaceCardStyles } from './preface-card.css.ts'\nimport { PrefaceCardController } from './preface-card-controller.ts'\nimport { en, zh, type PrefaceLocaleKey } from './locales.ts'\n\nexport type { PrefaceCardProps } from './preface-card.tsx'\nexport type { PrefaceLocaleKey } from './locales.ts'\n\ndeclare module '@deepseek-ai/dsh-client-ui-slots' {\n  interface LocaleNamespaceMap {\n    /** The preface-context settings card copy. */\n    'settings.preface-context': PrefaceLocaleKey\n  }\n}\n\n/** Dictionary namespace owned by this plugin. */\nconst NS = 'settings.preface-context'\n\n/** Settings namespace the host half registers (must match the host constant). */\nconst SETTINGS_NAMESPACE = 'preface-context'\n\n/**\n * Required services (cordis fiber inject). `settingsScope` is provided by the\n * ui-settings base plugin; `locale` by the locale plugin; `slots` is the\n * composition root. The target slot is declared by ui-settings-plugins'\n * `configurable` tab, whose activation order relative to this one is\n * unconstrained; registration depends on the slot through `slots.inject()`.\n */\nexport const inject = ['slots', 'locale', 'settingsScope']\n\n/**\n * Register the preface-context card once the `settings.plugin.item`\n * declaration is on the ledger, wire its controller to the settings scope,\n * and keep it fresh on every pushed invalidation.\n * @param ctx - client root context.\n */\nexport function apply(ctx: Context): void {\n  ctx.effect(installPrefaceCardStyles, 'preface-context: card styles')\n\n  ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'preface-context: copy dictionaries')\n\n  const settingsScope = ctx.settingsScope\n  const controller = new PrefaceCardController(\n    settingsScope.bind({ namespace: SETTINGS_NAMESPACE }),\n  )\n\n  ctx.slots.inject('settings.plugin.item', function* () {\n    yield ctx.slots.register({\n      name: 'settings.plugin.item',\n      key: SETTINGS_NAMESPACE,\n      locale: NS,\n      inject: (): PrefaceCardInjected => controller.inject(),\n    }, PrefaceCard)\n  })\n}\n"],"x_google_ignoreList":[0],"mappings":"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"}

package/lib/index.js

@@ -0,0 +1,127 @@
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
+import z from "schemastery";
+
+//#region src/config.ts
+/**
+* Schemastery schema for the `preface-context` settings namespace.
+*
+* Strict by construction: unknown keys fail validation here, even though the
+* settings service itself is non-strict and would otherwise accept them.
+*/
+const Config = z.object({
+	enabled: z.boolean().default(true),
+	contextText: z.string().default("")
+});
+
+//#endregion
+//#region src/settings.ts
+/** The `preface-context` settings namespace (registered when a settings service exists). */
+const PREFACE_SETTINGS_NAMESPACE = "preface-context";
+/**
+* Mirror of @deepseek-ai/dsh-settings' `isUnloading` guard (its
+* `installSettingsSection` skips source/listener work while the plugin fiber
+* is unloading or disposed). The library compares `ctx.fiber.state` against
+* `FiberState.DISPOSED` / `FiberState.UNLOADING`; the const enum is erased at
+* runtime, so the vendored numeric values (4 / 5) are mirrored here.
+*/
+function isUnloading(ctx) {
+	const state = ctx.fiber?.state;
+	return state === 4 || state === 5;
+}
+/**
+* Install the `preface-context` settings namespace and wire the live source.
+*
+* Mirrors the dsh `installSettingsSection` pattern. The registration rides a
+* conditional `ctx.inject(['settings'], ...)` child, so with no settings
+* service the source stays the entry config. Multi-fiber dedupe: the host
+* may compose several preface-context fibers, and `settings.register` fails
+* loud on a duplicate namespace — the catch lets the first registration own
+* the live namespace while later instances fall back to the entry source.
+* @param ctx - consumer plugin context owning the wiring.
+* @param entry - the composition entry config, used as `base`.
+* @returns the bridge the runtime and gateway read through.
+*/
+function installPrefaceSettings(ctx, entry) {
+	const listeners = /* @__PURE__ */ new Set();
+	let source = () => entry;
+	const notify = () => {
+		for (const listener of [...listeners]) listener();
+	};
+	ctx.inject(["settings"], (sctx) => {
+		let scope;
+		try {
+			scope = sctx.settings.register(PREFACE_SETTINGS_NAMESPACE, Config, { base: entry });
+		} catch (error) {
+			if (!(error instanceof Error) || !error.message.includes("already registered")) throw error;
+			ctx.logger("preface-context").debug("settings namespace already registered — entry-source fallback (multi-fiber dedupe)");
+			return;
+		}
+		source = () => scope.get();
+		sctx.effect(() => () => {
+			if (isUnloading(ctx)) return;
+			source = () => entry;
+			notify();
+		});
+		notify();
+		scope.watch(() => {
+			if (isUnloading(ctx)) return;
+			notify();
+		});
+	});
+	return {
+		source: () => source(),
+		onChange: (callback) => {
+			listeners.add(callback);
+		}
+	};
+}
+
+//#endregion
+//#region src/index.ts
+const name = "dsh-plugin-preface-context";
+/** Services the plugin consumes; the row loads once all are available. */
+const inject = ["agents", "llm"];
+/** Plugin source tag carried by every injected message. */
+const PLUGIN_SOURCE = {
+	kind: "plugin",
+	plugin: "dsh-plugin-preface-context",
+	form: "instructions"
+};
+/**
+* Build the user-message to inject for one session start.
+*
+* The message carries the context text as a single text block and is tagged
+* `source.kind: 'plugin'` with `form: 'instructions'` so the model and UI
+* can present it as workspace instructions rather than a user prompt.
+* @param config - the live composed config.
+* @returns the message to inject, or `undefined` when injection is disabled
+*   or the text is empty/whitespace.
+*/
+function buildPrefaceMessage(config) {
+	if (!config.enabled) return void 0;
+	if (config.contextText.trim() === "") return void 0;
+	return createUserMessage({
+		content: [{
+			type: "text",
+			text: config.contextText
+		}],
+		source: PLUGIN_SOURCE
+	});
+}
+/**
+* Plugin entry: install the settings bridge, then inject the preface text on
+* every session start.
+* @param ctx - the plugin's cordis context.
+* @param config - the composition entry config (base layer of the settings namespace).
+*/
+function apply(ctx, config) {
+	const bridge = installPrefaceSettings(ctx, config);
+	ctx.on("agent/session-start", ({ agent }) => {
+		const message = buildPrefaceMessage(bridge.source());
+		if (message === void 0) return;
+		agent.inject(message);
+	});
+}
+
+//#endregion
+export { Config, apply, buildPrefaceMessage, inject, name };

package/lib/types/client/bind-snapshot-selector.d.ts

@@ -0,0 +1,7 @@
+import type { HostObservable, SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+/**
+ * Bind a bare observable source to a typed uSES selector hook.
+ * @param w - snapshot source (engine store, controller store instance).
+ * @returns the selector hook.
+ */
+export declare function bindSnapshotSelector<T>(w: HostObservable<T>): SnapshotSelectorHook<T>;

package/lib/types/client/bind-snapshot-selector.js

@@ -0,0 +1,19 @@
+/**
+ * uSES bridge: turns any bare observable snapshot source into a typed
+ * selector hook. Inlined here because `@deepseek-ai/dsh-client-ui-renderer`
+ * does not re-export `bindSnapshotSelector` from its public `/client` face
+ * (rc.8+); business plugins must provide their own copy.
+ */
+import { useSyncExternalStoreWithSelector } from 'use-sync-external-store/shim/with-selector';
+/**
+ * Bind a bare observable source to a typed uSES selector hook.
+ * @param w - snapshot source (engine store, controller store instance).
+ * @returns the selector hook.
+ */
+export function bindSnapshotSelector(w) {
+    const subscribe = (fn) => w.subscribe(fn);
+    const getSnapshot = () => w.getSnapshot();
+    return function useSelector(sel, eq) {
+        return useSyncExternalStoreWithSelector(subscribe, getSnapshot, undefined, sel, eq);
+    };
+}

package/lib/types/client/client/bind-snapshot-selector.d.ts

@@ -0,0 +1,7 @@
+import type { HostObservable, SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+/**
+ * Bind a bare observable source to a typed uSES selector hook.
+ * @param w - snapshot source (engine store, controller store instance).
+ * @returns the selector hook.
+ */
+export declare function bindSnapshotSelector<T>(w: HostObservable<T>): SnapshotSelectorHook<T>;

package/lib/types/client/client/bind-snapshot-selector.js

@@ -0,0 +1,19 @@
+/**
+ * uSES bridge: turns any bare observable snapshot source into a typed
+ * selector hook. Inlined here because `@deepseek-ai/dsh-client-ui-renderer`
+ * does not re-export `bindSnapshotSelector` from its public `/client` face
+ * (rc.8+); business plugins must provide their own copy.
+ */
+import { useSyncExternalStoreWithSelector } from 'use-sync-external-store/shim/with-selector';
+/**
+ * Bind a bare observable source to a typed uSES selector hook.
+ * @param w - snapshot source (engine store, controller store instance).
+ * @returns the selector hook.
+ */
+export function bindSnapshotSelector(w) {
+    const subscribe = (fn) => w.subscribe(fn);
+    const getSnapshot = () => w.getSnapshot();
+    return function useSelector(sel, eq) {
+        return useSyncExternalStoreWithSelector(subscribe, getSnapshot, undefined, sel, eq);
+    };
+}

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

@@ -0,0 +1,39 @@
+/**
+ * Preface-context settings plugin, browser half. Registers the
+ * `preface-context` card into the shell-declared `settings.plugin.item` slot
+ * (the "插件配置" settings page), keyed by the `preface-context` settings
+ * namespace. The card's controller binds the namespace through
+ * `ctx.settingsScope.bind()`, which reads/writes through the standard
+ * `settings.describe` / `settings.mutate` RPCs (the apiproxy accepts any
+ * registered namespace — no allowlist gate on current upstream dsh).
+ *
+ * Export discipline: value-imports ONLY the frozen platform module table
+ * (React / cordis / ui-primitives); every other `@deepseek-ai/*` import is
+ * type-only (erased at build) — values arrive via cordis injection
+ * (`ctx.settingsScope` is the read/write channel).
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type PrefaceLocaleKey } from './locales.ts';
+export type { PrefaceCardProps } from './preface-card.tsx';
+export type { PrefaceLocaleKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The preface-context settings card copy. */
+        'settings.preface-context': PrefaceLocaleKey;
+    }
+}
+/**
+ * Required services (cordis fiber inject). `settingsScope` is provided by the
+ * ui-settings base plugin; `locale` by the locale plugin; `slots` is the
+ * composition root. The target slot is declared by ui-settings-plugins'
+ * `configurable` tab, whose activation order relative to this one is
+ * unconstrained; registration depends on the slot through `slots.inject()`.
+ */
+export declare const inject: string[];
+/**
+ * Register the preface-context card once the `settings.plugin.item`
+ * declaration is on the ledger, wire its controller to the settings scope,
+ * and keep it fresh on every pushed invalidation.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: Context): void;

package/lib/types/client/client/index.js

@@ -0,0 +1,50 @@
+/**
+ * Preface-context settings plugin, browser half. Registers the
+ * `preface-context` card into the shell-declared `settings.plugin.item` slot
+ * (the "插件配置" settings page), keyed by the `preface-context` settings
+ * namespace. The card's controller binds the namespace through
+ * `ctx.settingsScope.bind()`, which reads/writes through the standard
+ * `settings.describe` / `settings.mutate` RPCs (the apiproxy accepts any
+ * registered namespace — no allowlist gate on current upstream dsh).
+ *
+ * Export discipline: value-imports ONLY the frozen platform module table
+ * (React / cordis / ui-primitives); every other `@deepseek-ai/*` import is
+ * type-only (erased at build) — values arrive via cordis injection
+ * (`ctx.settingsScope` is the read/write channel).
+ */
+import { PrefaceCard } from "./preface-card.js";
+import { installPrefaceCardStyles } from "./preface-card.css.js";
+import { PrefaceCardController } from "./preface-card-controller.js";
+import { en, zh } from "./locales.js";
+/** Dictionary namespace owned by this plugin. */
+const NS = 'settings.preface-context';
+/** Settings namespace the host half registers (must match the host constant). */
+const SETTINGS_NAMESPACE = 'preface-context';
+/**
+ * Required services (cordis fiber inject). `settingsScope` is provided by the
+ * ui-settings base plugin; `locale` by the locale plugin; `slots` is the
+ * composition root. The target slot is declared by ui-settings-plugins'
+ * `configurable` tab, whose activation order relative to this one is
+ * unconstrained; registration depends on the slot through `slots.inject()`.
+ */
+export const inject = ['slots', 'locale', 'settingsScope'];
+/**
+ * Register the preface-context card once the `settings.plugin.item`
+ * declaration is on the ledger, wire its controller to the settings scope,
+ * and keep it fresh on every pushed invalidation.
+ * @param ctx - client root context.
+ */
+export function apply(ctx) {
+    ctx.effect(installPrefaceCardStyles, 'preface-context: card styles');
+    ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'preface-context: copy dictionaries');
+    const settingsScope = ctx.settingsScope;
+    const controller = new PrefaceCardController(settingsScope.bind({ namespace: SETTINGS_NAMESPACE }));
+    ctx.slots.inject('settings.plugin.item', function* () {
+        yield ctx.slots.register({
+            name: 'settings.plugin.item',
+            key: SETTINGS_NAMESPACE,
+            locale: NS,
+            inject: () => controller.inject(),
+        }, PrefaceCard);
+    });
+}

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

@@ -0,0 +1,7 @@
+/** Locale bundles for the preface-context settings card. */
+/** Locale keys the preface-context card renders. */
+export type PrefaceLocaleKey = 'title' | 'description' | 'enabled' | 'enabledHint' | 'contextText' | 'contextTextHint' | 'contextTextPlaceholder' | 'overridden' | 'reset' | 'save' | 'saving' | 'discard' | 'unsaved' | 'saveFailed' | 'readOnly' | 'expand' | 'collapse';
+/** English copy. */
+export declare const en: Record<PrefaceLocaleKey, string>;
+/** Simplified Chinese copy. */
+export declare const zh: Record<PrefaceLocaleKey, string>;

package/lib/types/client/client/locales.js

@@ -0,0 +1,41 @@
+/** Locale bundles for the preface-context settings card. */
+/** English copy. */
+export const en = {
+    title: 'Preface context',
+    description: 'Inject a text block as model-visible instructions at the start of every session.',
+    enabled: 'Enabled',
+    enabledHint: 'When off, no context is injected at session start.',
+    contextText: 'Context text',
+    contextTextHint: 'Injected once per session as instructions context, closest to the model\u2019s first answer. Empty text injects nothing.',
+    contextTextPlaceholder: 'Enter the text to inject at the start of every session\u2026',
+    overridden: 'Overridden',
+    reset: 'Reset to default',
+    save: 'Save',
+    saving: 'Saving\u2026',
+    discard: 'Discard',
+    unsaved: 'Unsaved',
+    saveFailed: 'The deployment did not accept these values; they were left for you to correct.',
+    readOnly: 'This deployment stores settings read-only.',
+    expand: 'Show settings',
+    collapse: 'Hide settings',
+};
+/** Simplified Chinese copy. */
+export const zh = {
+    title: '前言上下文',
+    description: '在每次会话开头注入一段文本作为模型可见的指令上下文。',
+    enabled: '启用',
+    enabledHint: '关闭后，会话开始时不注入任何上下文。',
+    contextText: '上下文文本',
+    contextTextHint: '每次会话注入一次，作为指令上下文最贴近模型的首个回答。文本为空则不注入。',
+    contextTextPlaceholder: '输入要在每次会话开头注入的文本\u2026',
+    overridden: '已覆盖',
+    reset: '恢复默认',
+    save: '保存',
+    saving: '保存中\u2026',
+    discard: '放弃修改',
+    unsaved: '未保存',
+    saveFailed: '本部署没有接受这些值，已保留供你修改。',
+    readOnly: '本部署的设置为只读。',
+    expand: '展开设置',
+    collapse: '收起设置',
+};

package/lib/types/client/client/preface-card-controller.d.ts

@@ -0,0 +1,94 @@
+/**
+ * The preface-context card's staged form over the `preface-context` settings
+ * namespace.
+ *
+ * The upstream `ui-settings-plugins` package owns a `CardForm` helper, but it
+ * is an internal module (not re-exported from the package's `/client` public
+ * face), so an external plugin cannot reuse it. This controller is a slim
+ * equivalent: it stages the two fields (`enabled` boolean, `contextText`
+ * multiline string) and writes them through the bound {@link SettingsScope}
+ * on save, re-deriving its projection whenever the scope or a draft changes.
+ *
+ * Unlike the upstream `CardForm`, the `contextText` field is a multiline
+ * textarea: its draft preserves internal whitespace and newlines (the
+ * upstream `textField` helper trims, which would collapse a multi-paragraph
+ * preface into one line).
+ */
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { PrefaceConfig } from '../config.ts';
+/** The two fields this card edits, as draft text. */
+export interface PrefaceDraft {
+    /** `enabled` draft — 'true' or 'false'. */
+    enabled: string;
+    /** `contextText` draft — the raw textarea value, whitespace preserved. */
+    contextText: string;
+}
+/** One field's render state. */
+export interface PrefaceFieldState {
+    /** Draft text the control renders. */
+    text: string;
+    /** Whether saving would leave a user-layer entry for this field. */
+    overridden: boolean;
+}
+/** Card-level state shared with the component. */
+export interface PrefaceCardState {
+    /** False while the namespace is not served to this client. */
+    available: boolean;
+    /** Whether the Host document accepts writes. */
+    writable: boolean;
+    /** Whether the form holds edits that a save would write. */
+    dirty: boolean;
+    /** Whether a save is crossing the wire. */
+    saving: boolean;
+    /** Whether the last save did not land as staged. */
+    failed: boolean;
+    /** The `enabled` field state. */
+    enabled: PrefaceFieldState;
+    /** The `contextText` field state. */
+    contextText: PrefaceFieldState;
+}
+/** The write actions the card's slot entry injects. */
+export interface PrefaceCardActions {
+    /** Stage draft text for one field. */
+    edit: (field: keyof PrefaceDraft, text: string) => void;
+    /** Stage a clear, so saving lets the field re-inherit the composition layer. */
+    resetField: (field: keyof PrefaceDraft) => void;
+    /** Write every staged edit, then re-seed from what the Host accepted. */
+    save: () => void;
+    /** Drop every staged edit. */
+    discard: () => void;
+}
+/** The registration-side face the card's slot entry injects. */
+export interface PrefaceCardFace {
+    hooks: {
+        /** Card snapshot bound by the renderer as usePrefaceCard. */
+        prefaceCard: SnapshotStore<PrefaceCardState>;
+    };
+}
+/**
+ * Bridges the `preface-context` scope onto the card's staged form.
+ *
+ * Publishes through a snapshot store because slot components read through a
+ * snapshot selector, while both the scope and the local drafts change
+ * underneath; every projection is rebuilt from the two together.
+ */
+export declare class PrefaceCardController {
+    private readonly scope;
+    private readonly store;
+    private readonly staged;
+    private saving;
+    private failed;
+    /** @param scope - the bound settings scope for the `preface-context` namespace. */
+    constructor(scope: SettingsScope<PrefaceConfig>);
+    /** @returns the store the card's component reads through its bound selector. */
+    get snapshot(): SnapshotStore<PrefaceCardState>;
+    private project;
+    private fieldState;
+    /** Build the face the card's slot registration injects. */
+    inject(): PrefaceCardFace & PrefaceCardActions;
+    private stage;
+    private publish;
+    /** Write every staged edit, then re-seed from what the Host accepted. */
+    private save;
+}