@owlmeans/web-consent 0.1.18-rc.15 → 0.1.18-rc.16

package/README.md

@@ -6,7 +6,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.20
+npx @owlmeans/agent-skills@^0.1.18-rc.21
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/web-consent",
-  "version": "0.1.18-rc.15",
-  "generatedAt": "2026-09-12T14:18:54.791Z",
+  "version": "0.1.18-rc.16",
+  "generatedAt": "2026-09-15T12:21:31.925Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/web-consent/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/web-consent
 
 **Layer:** Web (React)
-**Install:** `"@owlmeans/web-consent": "^0.1.18-rc.15"` in `dependencies`
+**Install:** `"@owlmeans/web-consent": "^0.1.18-rc.16"` in `dependencies`
 
 The browser components of the consent set. The model — categories, storage, migration, the store,
 Consent Mode signalling — is `@owlmeans/consent`, and this package re-exports a **named selection**
@@ -35,6 +35,7 @@ components — see below.
 | Export | Description |
 |--------|-------------|
 | `CookieConsent` | The preferences dialog **and** the persistent re-open button |
+| `ConsentMenuWidget` | A plain row a HOST'S OWN menu renders to reopen the dialog, in place of (or beside) `CookieConsent`'s own floating button — see below |
 | `CookiePolicy` | The cookie-policy page, generated from the configuration in force |
 | `ConsentToggle` | One category row — locked and labelled when the category is required |
 | `useConsent(opts?)` | This document's consent state and the actions over it (`UseConsentModel`) — **it also initialises the store on mount**, see below |
@@ -78,6 +79,24 @@ precondition in `@owlmeans/client-iam` raises — it says so and relabels the pr
 twice. Word that path as an acknowledgement, never as "you must consent to essential cookies": a
 required category is disclosure, not a question.
 
+## A menu row for a host that already has one
+
+`ConsentMenuWidget` renders one row — icon, translated label, `onClick` reopening the dialog
+(`openConsent('reopen')` by default, or a caller's own `onSelect`) — for a host whose own
+navigation already carries a settings menu and would rather offer cookie preferences there than as
+a second floating button. It calls `openConsent` directly, never `useConsent()`, for the same
+init-on-mount reason as everywhere else in this document.
+
+**It carries no presence signalling of its own.** A host that wants `CookieConsent`'s floating
+button to hide while this row is reachable needs to know that itself, from something that stays
+mounted for as long as the row is reachable — never from the row's own mount. A row placed inside a
+host menu's lazily-rendered content (Radix's `DropdownMenuContent`, and most headless menu
+primitives, only mount their children while the menu is actually OPEN) reports "present" for a
+fraction of the time the menu itself is on screen, and the floating button reappears the instant
+the menu closes. `@owlmeans/web-panel/consent`'s `useConsentMenuPresence()` is the fix for a
+context-aware host: call it from the menu's own always-mounted shell component, not from inside the
+row. A context-free host (an Astro island with its own menu) owns that judgement itself.
+
 ## Reading the decision
 
 ```tsx

package/build/consent/widget.d.ts

@@ -0,0 +1,18 @@
+import type { FC } from 'react';
+import type { ConsentMenuWidgetProps } from '../types.js';
+/**
+ * One row a HOST'S OWN menu can render to reopen the preferences dialog, in place of (or beside)
+ * the floating button `CookieConsent` renders itself. No outer row padding here — the host's own
+ * menu-row wrapper supplies that, the same way it does for any other widget row it renders.
+ *
+ * Carries no presence signalling of its own: a host whose menu only mounts this row while its
+ * dropdown/menu content is actually open (Radix's `DropdownMenuContent`, for one) would report
+ * "present" only for that brief window. A host that wants to hide `CookieConsent`'s floating
+ * button while this row is reachable announces that from whatever component of its own stays
+ * mounted for the menu's whole lifetime — see `useConsentMenuPresence` in `@owlmeans/web-panel/consent`.
+ *
+ * Uses `openConsent` directly rather than the `useConsent()` hook: that hook's mount itself
+ * triggers `consentStore.init()`, which a row that only needs to trigger a reopen must not do.
+ */
+export declare const ConsentMenuWidget: FC<ConsentMenuWidgetProps>;
+//# sourceMappingURL=widget.d.ts.map

package/build/consent/widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.d.ts","sourceRoot":"","sources":["../../src/consent/widget.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAA;AAI/B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEzD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,EAAE,EAAE,CAAC,sBAAsB,CAqBxD,CAAA"}

package/build/consent/widget.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback } from 'react';
+import { Cookie } from 'lucide-react';
+import { defaultConsentTranslate, openConsent } from '@owlmeans/consent';
+import { cn } from '../lib/utils.js';
+/**
+ * One row a HOST'S OWN menu can render to reopen the preferences dialog, in place of (or beside)
+ * the floating button `CookieConsent` renders itself. No outer row padding here — the host's own
+ * menu-row wrapper supplies that, the same way it does for any other widget row it renders.
+ *
+ * Carries no presence signalling of its own: a host whose menu only mounts this row while its
+ * dropdown/menu content is actually open (Radix's `DropdownMenuContent`, for one) would report
+ * "present" only for that brief window. A host that wants to hide `CookieConsent`'s floating
+ * button while this row is reachable announces that from whatever component of its own stays
+ * mounted for the menu's whole lifetime — see `useConsentMenuPresence` in `@owlmeans/web-panel/consent`.
+ *
+ * Uses `openConsent` directly rather than the `useConsent()` hook: that hook's mount itself
+ * triggers `consentStore.init()`, which a row that only needs to trigger a reopen must not do.
+ */
+export const ConsentMenuWidget = props => {
+    const t = props.translate ?? defaultConsentTranslate(props.locale);
+    const onClick = useCallback(() => {
+        if (props.onSelect != null) {
+            props.onSelect();
+            return;
+        }
+        openConsent('reopen');
+    }, [props.onSelect]);
+    return _jsxs("button", { type: "button", onClick: onClick, "data-consent-menu-widget": true, className: cn('flex w-full min-w-0 items-center gap-2 rounded-md text-left text-sm text-popover-foreground transition-colors hover:bg-accent', props.className), children: [_jsx(Cookie, { className: "h-4 w-4 shrink-0", "aria-hidden": "true" }), _jsx("span", { className: "flex-1 truncate", children: props.label ?? t('openPreferences', 'Cookie preferences') })] });
+};
+//# sourceMappingURL=widget.js.map

package/build/consent/widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.js","sourceRoot":"","sources":["../../src/consent/widget.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAEnC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AAGpC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA+B,KAAK,CAAC,EAAE;IACnE,MAAM,CAAC,GAAG,KAAK,CAAC,SAAS,IAAI,uBAAuB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAElE,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,IAAI,KAAK,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;YAC3B,KAAK,CAAC,QAAQ,EAAE,CAAA;YAChB,OAAM;QACR,CAAC;QACD,WAAW,CAAC,QAAQ,CAAC,CAAA;IACvB,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEpB,OAAO,kBACL,IAAI,EAAC,QAAQ,EAAC,OAAO,EAAE,OAAO,oCAC9B,SAAS,EAAE,EAAE,CACX,+HAA+H,EAC/H,KAAK,CAAC,SAAS,CAChB,aAED,KAAC,MAAM,IAAC,SAAS,EAAC,kBAAkB,iBAAa,MAAM,GAAG,EAC1D,eAAM,SAAS,EAAC,iBAAiB,YAAE,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAQ,IAC7F,CAAA;AACX,CAAC,CAAA"}

package/build/index.d.ts

@@ -1,6 +1,7 @@
 export type * from './types.js';
 export * from './hooks.js';
 export * from './consent/component.js';
+export * from './consent/widget.js';
 export * from './consent/toggle.js';
 export * from './policy/component.js';
 export { consentStore, openConsent, isConsented, readConsent, writeConsent, clearConsent, migrateConsent, applyConsent, pushConsentDefaults, consentBootstrapScript, consentDefaults, consentUpdate, gtagConsent, DEFAULT_CONSENT_CATEGORIES, DEFAULT_CONSENT_MESSAGES, defaultConsentTranslate, interpolate, CONSENT_KEY, CONSENT_COOKIE_DAYS, CONSENT_SCHEMA_VERSION, CONSENT_LOCALES, CONSENT_ESSENTIAL, CONSENT_ANALYTICS, CONSENT_MARKETING, } from '@owlmeans/consent';

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AAErC,OAAO,EACL,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAC/E,cAAc,EAAE,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EACzE,eAAe,EAAE,aAAa,EAAE,WAAW,EAC3C,0BAA0B,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,WAAW,EAC1F,WAAW,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,eAAe,EACzE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,GACxD,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAC1F,YAAY,EAAE,aAAa,GAC5B,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AAErC,OAAO,EACL,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAC/E,cAAc,EAAE,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EACzE,eAAe,EAAE,aAAa,EAAE,WAAW,EAC3C,0BAA0B,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,WAAW,EAC1F,WAAW,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,eAAe,EACzE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,GACxD,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAC1F,YAAY,EAAE,aAAa,GAC5B,MAAM,mBAAmB,CAAA"}

package/build/index.js

@@ -1,5 +1,6 @@
 export * from './hooks.js';
 export * from './consent/component.js';
+export * from './consent/widget.js';
 export * from './consent/toggle.js';
 export * from './policy/component.js';
 export { consentStore, openConsent, isConsented, readConsent, writeConsent, clearConsent, migrateConsent, applyConsent, pushConsentDefaults, consentBootstrapScript, consentDefaults, consentUpdate, gtagConsent, DEFAULT_CONSENT_CATEGORIES, DEFAULT_CONSENT_MESSAGES, defaultConsentTranslate, interpolate, CONSENT_KEY, CONSENT_COOKIE_DAYS, CONSENT_SCHEMA_VERSION, CONSENT_LOCALES, CONSENT_ESSENTIAL, CONSENT_ANALYTICS, CONSENT_MARKETING, } from '@owlmeans/consent';

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AAErC,OAAO,EACL,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAC/E,cAAc,EAAE,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EACzE,eAAe,EAAE,aAAa,EAAE,WAAW,EAC3C,0BAA0B,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,WAAW,EAC1F,WAAW,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,eAAe,EACzE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,GACxD,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AAErC,OAAO,EACL,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAC/E,cAAc,EAAE,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EACzE,eAAe,EAAE,aAAa,EAAE,WAAW,EAC3C,0BAA0B,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,WAAW,EAC1F,WAAW,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,eAAe,EACzE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,GACxD,MAAM,mBAAmB,CAAA"}

package/build/types.d.ts

@@ -36,6 +36,15 @@ export interface CookiePolicyProps {
     cookieDays?: number;
     className?: string;
 }
+export interface ConsentMenuWidgetProps {
+    locale?: string;
+    /** `(key, defaultValue) => string`. Defaults to the built-in seven-language bundle. */
+    translate?: (key: string, defaultValue: string) => string;
+    label?: string;
+    className?: string;
+    /** Defaults to `openConsent('reopen')` — the same call the floating button itself makes. */
+    onSelect?: () => void;
+}
 export interface UseConsentModel {
     record: ConsentRecord | null;
     open: boolean;

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAAE,aAAa,EAAE,aAAa,EAC9C,MAAM,mBAAmB,CAAA;AAE1B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;IAC9B,uFAAuF;IACvF,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,CAAA;IACzD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mEAAmE;IACnE,KAAK,CAAC,EAAE,WAAW,EAAE,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,wFAAwF;IACxF,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,CAAA;IACzD,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;IAC9B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IAC5B,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;IACjC,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAA;IACrC,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,aAAa,KAAK,IAAI,CAAA;IAC5C,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAAE,aAAa,EAAE,aAAa,EAC9C,MAAM,mBAAmB,CAAA;AAE1B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;IAC9B,uFAAuF;IACvF,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,CAAA;IACzD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mEAAmE;IACnE,KAAK,CAAC,EAAE,WAAW,EAAE,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,wFAAwF;IACxF,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,CAAA;IACzD,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;IAC9B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uFAAuF;IACvF,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,CAAA;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IAC5B,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;IACjC,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAA;IACrC,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,aAAa,KAAK,IAAI,CAAA;IAC5C,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/web-consent",
-  "version": "0.1.18-rc.15",
+  "version": "0.1.18-rc.16",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -33,7 +33,7 @@
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@owlmeans/test-ui": "^0.1.18-rc.23",
+    "@owlmeans/test-ui": "^0.1.18-rc.24",
     "@tailwindcss/vite": "^4.0.0",
     "@types/bun": "^1.4.0",
     "@types/react": "^19.2.17",

package/src/consent/widget.tsx

@@ -0,0 +1,43 @@
+import { useCallback } from 'react'
+import type { FC } from 'react'
+import { Cookie } from 'lucide-react'
+import { defaultConsentTranslate, openConsent } from '@owlmeans/consent'
+import { cn } from '../lib/utils.js'
+import type { ConsentMenuWidgetProps } from '../types.js'
+
+/**
+ * One row a HOST'S OWN menu can render to reopen the preferences dialog, in place of (or beside)
+ * the floating button `CookieConsent` renders itself. No outer row padding here — the host's own
+ * menu-row wrapper supplies that, the same way it does for any other widget row it renders.
+ *
+ * Carries no presence signalling of its own: a host whose menu only mounts this row while its
+ * dropdown/menu content is actually open (Radix's `DropdownMenuContent`, for one) would report
+ * "present" only for that brief window. A host that wants to hide `CookieConsent`'s floating
+ * button while this row is reachable announces that from whatever component of its own stays
+ * mounted for the menu's whole lifetime — see `useConsentMenuPresence` in `@owlmeans/web-panel/consent`.
+ *
+ * Uses `openConsent` directly rather than the `useConsent()` hook: that hook's mount itself
+ * triggers `consentStore.init()`, which a row that only needs to trigger a reopen must not do.
+ */
+export const ConsentMenuWidget: FC<ConsentMenuWidgetProps> = props => {
+  const t = props.translate ?? defaultConsentTranslate(props.locale)
+
+  const onClick = useCallback(() => {
+    if (props.onSelect != null) {
+      props.onSelect()
+      return
+    }
+    openConsent('reopen')
+  }, [props.onSelect])
+
+  return <button
+    type="button" onClick={onClick} data-consent-menu-widget
+    className={cn(
+      'flex w-full min-w-0 items-center gap-2 rounded-md text-left text-sm text-popover-foreground transition-colors hover:bg-accent',
+      props.className
+    )}
+  >
+    <Cookie className="h-4 w-4 shrink-0" aria-hidden="true" />
+    <span className="flex-1 truncate">{props.label ?? t('openPreferences', 'Cookie preferences')}</span>
+  </button>
+}

package/src/index.ts

@@ -1,6 +1,7 @@
 export type * from './types.js'
 export * from './hooks.js'
 export * from './consent/component.js'
+export * from './consent/widget.js'
 export * from './consent/toggle.js'
 export * from './policy/component.js'
 

package/src/types.ts

@@ -42,6 +42,16 @@ export interface CookiePolicyProps {
   className?: string
 }
 
+export interface ConsentMenuWidgetProps {
+  locale?: string
+  /** `(key, defaultValue) => string`. Defaults to the built-in seven-language bundle. */
+  translate?: (key: string, defaultValue: string) => string
+  label?: string
+  className?: string
+  /** Defaults to `openConsent('reopen')` — the same call the floating button itself makes. */
+  onSelect?: () => void
+}
+
 export interface UseConsentModel {
   record: ConsentRecord | null
   open: boolean