featuredrop 1.2.0 → 1.4.0

package/README.md

@@ -109,6 +109,10 @@ const storage = new LocalStorageAdapter({
 })
 ```
 
+For offline-heavy apps, use `IndexedDBAdapter` to persist the same state with IndexedDB + local fallback.
+It also supports queued dismiss sync (`flushQueue`) + remote state reconciliation (`syncFromRemote`) for offline-first flows.
+For remote/state sync, `RemoteAdapter` now includes retry + circuit-breaker protection and a monitoring-friendly `isHealthy()` check.
+
 **3. Check what's new:**
 
 ```ts
@@ -218,6 +222,40 @@ Use built-in locale packs or supply partial overrides:
 ```
 
 Built-in locales: `en`, `es`, `fr`, `de`, `pt`, `zh-cn`, `ja`, `ko`, `ar`, `hi`.
+Locale helpers include locale-aware date formatting, pluralized count copy, and RTL direction support for Arabic.
+Use `formatRelativeTimeForLocale()` for localized "x days ago" labels, or set `dateFormat="relative"` on `ChangelogWidget` / `ChangelogPage`.
+
+## Animation Presets
+
+Choose built-in motion levels globally:
+
+```tsx
+<FeatureDropProvider manifest={FEATURES} storage={storage} animation="subtle">
+  <App />
+</FeatureDropProvider>
+```
+
+Available presets: `none`, `subtle`, `normal`, `playful`.  
+Reduced-motion users automatically receive `none`.
+Built-in `ChangelogWidget`, `AnnouncementModal`, and `Toast` include enter/exit animations, and `Tour`, `Survey`, `FeedbackWidget`, `Spotlight`, `SpotlightChain`, and `Hotspot` follow the same preset for enter/pulse motion.
+
+## Custom Renderer Protocol
+
+Need full UI control? Use a UI-agnostic renderer with state/actions/computed helpers:
+
+```ts
+import { createChangelogRenderer } from 'featuredrop'
+
+const renderer = createChangelogRenderer({ manifest: FEATURES, storage })
+renderer.subscribe((state) => console.log(state.newCount))
+renderer.actions.dismiss('ai-journal')
+```
+
+## Accessibility
+
+featuredrop components include keyboard navigation, focus trapping/return for dialogs, ARIA live regions, and reduced-motion support.
+
+Automated accessibility regression checks run in CI via `axe-core` + `vitest-axe` (`src/__tests__/accessibility-axe.test.tsx`).
 
 ## Changelog-as-Code
 
@@ -233,6 +271,10 @@ npx featuredrop doctor --pattern "features/**/*.md"
 npx featuredrop generate-rss --pattern "features/**/*.md" --out featuredrop.rss.xml
 npx featuredrop generate-changelog --pattern "features/**/*.md" --out CHANGELOG.generated.md
 npx featuredrop migrate --from beamer --input beamer-export.json --out featuredrop.manifest.json
+npx featuredrop migrate --from headway --input headway-export.json --out featuredrop.manifest.json
+npx featuredrop migrate --from announcekit --input announcekit-export.json --out featuredrop.manifest.json
+npx featuredrop migrate --from canny --input canny-export.json --out featuredrop.manifest.json
+npx featuredrop migrate --from launchnotes --input launchnotes-export.json --out featuredrop.manifest.json
 ```
 
 Example feature file:
@@ -252,6 +294,114 @@ cta:
 Track decisions and outcomes with AI-powered insights.
 ```
 
+## CMS Adapters
+
+Pull releases from your CMS and map them into `FeatureEntry[]`:
+
+```ts
+import { ContentfulAdapter, SanityAdapter, StrapiAdapter, NotionAdapter, MarkdownAdapter } from 'featuredrop'
+
+const contentful = new ContentfulAdapter({
+  spaceId: process.env.CONTENTFUL_SPACE!,
+  accessToken: process.env.CONTENTFUL_TOKEN!,
+  contentType: 'featureRelease',
+})
+
+const entries = await contentful.load()
+```
+
+Each adapter accepts optional `fieldMapping` overrides so you can map your content model fields without reshaping server responses.
+
+## Notification Bridges
+
+Use framework-agnostic bridge helpers to fan out release notifications:
+
+```ts
+import {
+  SlackBridge,
+  DiscordBridge,
+  EmailDigestGenerator,
+  WebhookBridge,
+  RSSFeedGenerator,
+} from 'featuredrop/bridges'
+
+await SlackBridge.notify(feature, { webhookUrl: process.env.SLACK_WEBHOOK! })
+await DiscordBridge.notify(feature, { webhookUrl: process.env.DISCORD_WEBHOOK! })
+await WebhookBridge.post(feature, { url: 'https://api.example.com/hooks/features' })
+
+const html = EmailDigestGenerator.generate(features, { title: 'Weekly updates' })
+const rss = RSSFeedGenerator.generate(features, { title: 'Product Updates' })
+```
+
+## CI Utilities
+
+Use `featuredrop/ci` for manifest diffing in pull-request checks:
+
+```ts
+import { diffManifest, generateChangelogDiff, validateManifestForCI } from 'featuredrop/ci'
+
+const diff = diffManifest(beforeManifest, afterManifest)
+const summary = generateChangelogDiff(diff, { includeFieldChanges: true })
+const validation = validateManifestForCI(afterManifest)
+```
+
+Run bundle budget checks after `pnpm build`:
+
+```bash
+pnpm size-check
+```
+
+## Feature Flag Bridges
+
+Gate announcement visibility behind flags via `feature.flagKey`:
+
+```ts
+import { createFlagBridge, LaunchDarklyBridge, PostHogBridge } from 'featuredrop/flags'
+
+const bridge = createFlagBridge({
+  isEnabled: (flagKey) => myFlagService.isOn(flagKey),
+})
+
+// Provider + feature entry
+<FeatureDropProvider manifest={FEATURES} storage={storage} flagBridge={bridge} />
+// { id: 'ai-journal', flagKey: 'ai-journal-enabled', ... }
+
+// Or vendor bridges
+const ld = new LaunchDarklyBridge(ldClient)
+const ph = new PostHogBridge(posthog)
+```
+
+## Multi-Product Support
+
+Scope visibility by product using `FeatureDropProvider` + `feature.product`:
+
+```tsx
+<FeatureDropProvider manifest={FEATURES} storage={storage} product="askverdict" />
+// feature.product can be "askverdict", "other-product", or "*" for shared entries
+```
+
+## Admin Components
+
+Use optional admin UI primitives via `featuredrop/admin`:
+
+```tsx
+import {
+  ManifestEditor,
+  ScheduleCalendar,
+  PreviewPanel,
+  AudienceBuilder,
+} from 'featuredrop/admin'
+
+<ManifestEditor features={features} onSave={saveManifest} />
+<ScheduleCalendar features={features} onSchedule={scheduleFeature} />
+<PreviewPanel feature={selectedFeature} components={['badge', 'changelog', 'toast']} />
+<AudienceBuilder segments={['free', 'pro']} roles={['admin', 'viewer']} onSave={saveAudience} />
+```
+
+## Resilience
+
+Built-in React exports are wrapped in internal error boundaries. If a featuredrop component throws, it unmounts itself (no host app crash) and optionally reports through provider `onError`.
+
 ## Schema Validation
 
 Validate manifest JSON in CI or tooling pipelines.
@@ -315,6 +465,18 @@ One-click editable demos:
 - StackBlitz: https://stackblitz.com/github/GLINCKER/featuredrop/tree/main/examples/sandbox-react
 - CodeSandbox: https://codesandbox.io/p/sandbox/github/GLINCKER/featuredrop/tree/main/examples/sandbox-react
 
+## Docs Site (Nextra + Vercel)
+
+The repo now includes a docs app scaffold at `apps/docs` for a fast validation launch on Vercel.
+
+```bash
+pnpm docs:install
+pnpm docs:dev
+pnpm docs:build
+```
+
+The docs app is static-export ready, so it can also deploy on Cloudflare Pages or GitHub Pages.
+
 ## Components
 
 Everything you'd expect from Beamer or Headway — but free, self-hosted, and headless-first.
@@ -710,7 +872,10 @@ Read the full [Architecture doc](docs/ARCHITECTURE.md) for cross-device sync flo
 
 ## Documentation
 
+- [Docs App Source](apps/docs/) — Next.js + Nextra site scaffold (`/`, `/docs`, `/playground`)
+- [Docs Site Guide](docs/DOCS_SITE.md) — Local commands and Vercel deployment setup
 - [API Reference](docs/API.md) — All functions, adapters, hooks, components
+- [Recipes](docs/RECIPES.md) — Copy-paste integration patterns (sidebar badge, tours, migration, A/B tests)
 - [Architecture](docs/ARCHITECTURE.md) — Three-check algorithm, cross-device sync, custom adapters
 - [Next.js Example](examples/nextjs/) — Full App Router integration
 - [Vanilla Example](examples/vanilla/) — Plain HTML, zero build step
@@ -720,6 +885,12 @@ Read the full [Architecture doc](docs/ARCHITECTURE.md) for cross-device sync flo
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, commit conventions, and how releases work.
 
+## Security
+
+- Report vulnerabilities privately via [SECURITY.md](SECURITY.md).
+- CI includes CodeQL static analysis on pull requests and `main`.
+- `pnpm security-check` scans runtime source for unsafe execution/rendering patterns.
+
 ## License
 
 MIT &copy; [Glincker](https://glincker.com)

package/dist/admin.cjs

@@ -0,0 +1,212 @@
+"use client";
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/admin/index.tsx
+var panelStyles = {
+  border: "1px solid #e5e7eb",
+  borderRadius: "10px",
+  padding: "12px",
+  background: "#ffffff"
+};
+var headingStyles = {
+  margin: "0 0 8px",
+  fontSize: "15px",
+  fontWeight: 700
+};
+function ManifestEditor({
+  features,
+  onSave,
+  readOnly = false,
+  children
+}) {
+  const [draft, setDraft] = react.useState(() => JSON.stringify(features, null, 2));
+  const [status, setStatus] = react.useState("idle");
+  const [error, setError] = react.useState("");
+  const parsed = react.useMemo(() => {
+    try {
+      const next = JSON.parse(draft);
+      if (!Array.isArray(next)) throw new Error("Manifest must be an array");
+      return next;
+    } catch {
+      return null;
+    }
+  }, [draft]);
+  const save = async () => {
+    if (readOnly || !parsed) return;
+    setStatus("saving");
+    setError("");
+    try {
+      await onSave(parsed);
+      setStatus("saved");
+    } catch (cause) {
+      setStatus("error");
+      setError(cause instanceof Error ? cause.message : "Failed to save manifest");
+    }
+  };
+  if (children) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
+  return /* @__PURE__ */ jsxRuntime.jsxs("section", { "data-featuredrop-admin-manifest-editor": true, style: panelStyles, children: [
+    /* @__PURE__ */ jsxRuntime.jsx("p", { style: headingStyles, children: "Manifest Editor" }),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "textarea",
+      {
+        "aria-label": "Manifest JSON",
+        value: draft,
+        onChange: (event) => setDraft(event.target.value),
+        readOnly,
+        style: {
+          width: "100%",
+          minHeight: "180px",
+          fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace",
+          fontSize: "12px",
+          lineHeight: 1.45,
+          border: "1px solid #d1d5db",
+          borderRadius: "8px",
+          padding: "10px"
+        }
+      }
+    ),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { style: { display: "flex", alignItems: "center", gap: "8px", marginTop: "8px" }, children: [
+      /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", onClick: save, disabled: readOnly || !parsed, children: "Save" }),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { "aria-live": "polite", children: status }),
+      !parsed && /* @__PURE__ */ jsxRuntime.jsx("span", { style: { color: "#dc2626" }, children: "Invalid JSON" }),
+      error && /* @__PURE__ */ jsxRuntime.jsx("span", { style: { color: "#dc2626" }, children: error })
+    ] })
+  ] });
+}
+function ScheduleCalendar({ features, onSchedule }) {
+  const [values, setValues] = react.useState({});
+  return /* @__PURE__ */ jsxRuntime.jsxs("section", { "data-featuredrop-admin-schedule-calendar": true, style: panelStyles, children: [
+    /* @__PURE__ */ jsxRuntime.jsx("p", { style: headingStyles, children: "Schedule Calendar" }),
+    /* @__PURE__ */ jsxRuntime.jsx("ul", { style: { margin: 0, padding: 0, listStyle: "none", display: "grid", gap: "10px" }, children: features.map((feature) => /* @__PURE__ */ jsxRuntime.jsxs(
+      "li",
+      {
+        style: {
+          border: "1px solid #e5e7eb",
+          borderRadius: "8px",
+          padding: "10px",
+          display: "grid",
+          gap: "6px"
+        },
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsx("strong", { children: feature.label }),
+          /* @__PURE__ */ jsxRuntime.jsxs("label", { style: { display: "grid", gap: "4px" }, children: [
+            "Publish at",
+            /* @__PURE__ */ jsxRuntime.jsx(
+              "input",
+              {
+                type: "datetime-local",
+                value: values[feature.id] ?? "",
+                onChange: (event) => {
+                  const value = event.target.value;
+                  setValues((previous) => ({ ...previous, [feature.id]: value }));
+                }
+              }
+            )
+          ] }),
+          /* @__PURE__ */ jsxRuntime.jsx(
+            "button",
+            {
+              type: "button",
+              onClick: () => {
+                const value = values[feature.id];
+                if (!value) return;
+                void onSchedule(feature.id, new Date(value).toISOString());
+              },
+              children: "Schedule"
+            }
+          )
+        ]
+      },
+      feature.id
+    )) })
+  ] });
+}
+function PreviewPanel({ feature, components = ["badge", "changelog"] }) {
+  return /* @__PURE__ */ jsxRuntime.jsxs("section", { "data-featuredrop-admin-preview-panel": true, style: panelStyles, children: [
+    /* @__PURE__ */ jsxRuntime.jsx("p", { style: headingStyles, children: "Preview Panel" }),
+    !feature ? /* @__PURE__ */ jsxRuntime.jsx("p", { style: { margin: 0, color: "#6b7280" }, children: "Select a feature to preview." }) : /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+      /* @__PURE__ */ jsxRuntime.jsx("p", { style: { margin: "0 0 6px", fontWeight: 600 }, children: feature.label }),
+      /* @__PURE__ */ jsxRuntime.jsx("p", { style: { margin: "0 0 8px", color: "#6b7280" }, children: feature.description ?? "No description" }),
+      /* @__PURE__ */ jsxRuntime.jsx("div", { style: { display: "flex", flexWrap: "wrap", gap: "6px" }, children: components.map((component) => /* @__PURE__ */ jsxRuntime.jsx(
+        "span",
+        {
+          style: {
+            border: "1px solid #d1d5db",
+            borderRadius: "999px",
+            padding: "2px 8px",
+            fontSize: "12px"
+          },
+          children: component
+        },
+        component
+      )) })
+    ] })
+  ] });
+}
+function toggle(list, value) {
+  const items = new Set(list ?? []);
+  if (items.has(value)) items.delete(value);
+  else items.add(value);
+  return Array.from(items);
+}
+function AudienceBuilder({
+  segments = [],
+  roles = [],
+  regions = [],
+  value,
+  onChange,
+  onSave
+}) {
+  const [audience, setAudience] = react.useState({
+    plan: value?.plan ?? [],
+    role: value?.role ?? [],
+    region: value?.region ?? []
+  });
+  const updateAudience = (next) => {
+    setAudience(next);
+    onChange?.(next);
+  };
+  const section = (title, values, selected, onToggle) => /* @__PURE__ */ jsxRuntime.jsxs("fieldset", { style: { border: "none", margin: 0, padding: 0 }, children: [
+    /* @__PURE__ */ jsxRuntime.jsx("legend", { style: { fontWeight: 600, marginBottom: "4px" }, children: title }),
+    /* @__PURE__ */ jsxRuntime.jsx("div", { style: { display: "flex", flexWrap: "wrap", gap: "8px" }, children: values.map((item) => /* @__PURE__ */ jsxRuntime.jsxs("label", { style: { display: "inline-flex", alignItems: "center", gap: "6px" }, children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "input",
+        {
+          type: "checkbox",
+          checked: Boolean(selected?.includes(item)),
+          onChange: () => onToggle(item)
+        }
+      ),
+      item
+    ] }, item)) })
+  ] });
+  return /* @__PURE__ */ jsxRuntime.jsxs("section", { "data-featuredrop-admin-audience-builder": true, style: panelStyles, children: [
+    /* @__PURE__ */ jsxRuntime.jsx("p", { style: headingStyles, children: "Audience Builder" }),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { style: { display: "grid", gap: "10px" }, children: [
+      section("Plans", segments, audience.plan, (item) => updateAudience({ ...audience, plan: toggle(audience.plan, item) })),
+      section("Roles", roles, audience.role, (item) => updateAudience({ ...audience, role: toggle(audience.role, item) })),
+      section("Regions", regions, audience.region, (item) => updateAudience({ ...audience, region: toggle(audience.region, item) }))
+    ] }),
+    onSave && /* @__PURE__ */ jsxRuntime.jsx(
+      "button",
+      {
+        type: "button",
+        style: { marginTop: "10px" },
+        onClick: () => {
+          void onSave(audience);
+        },
+        children: "Save audience"
+      }
+    )
+  ] });
+}
+
+exports.AudienceBuilder = AudienceBuilder;
+exports.ManifestEditor = ManifestEditor;
+exports.PreviewPanel = PreviewPanel;
+exports.ScheduleCalendar = ScheduleCalendar;
+//# sourceMappingURL=admin.cjs.map
+//# sourceMappingURL=admin.cjs.map

package/dist/admin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/admin/index.tsx"],"names":["useState","useMemo","jsx","Fragment","jsxs"],"mappings":";;;;;;AAGA,IAAM,WAAA,GAA6B;AAAA,EACjC,MAAA,EAAQ,mBAAA;AAAA,EACR,YAAA,EAAc,MAAA;AAAA,EACd,OAAA,EAAS,MAAA;AAAA,EACT,UAAA,EAAY;AACd,CAAA;AAEA,IAAM,aAAA,GAA+B;AAAA,EACnC,MAAA,EAAQ,SAAA;AAAA,EACR,QAAA,EAAU,MAAA;AAAA,EACV,UAAA,EAAY;AACd,CAAA;AASO,SAAS,cAAA,CAAe;AAAA,EAC7B,QAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA,GAAW,KAAA;AAAA,EACX;AACF,CAAA,EAAwB;AACtB,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,cAAA,CAAS,MAAM,IAAA,CAAK,SAAA,CAAU,QAAA,EAAU,IAAA,EAAM,CAAC,CAAC,CAAA;AAC1E,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAIA,eAAiB,MAAM,CAAA;AACnD,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAAiB,EAAE,CAAA;AAE7C,EAAA,MAAM,MAAA,GAASC,cAAQ,MAAM;AAC3B,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,KAAK,CAAA;AAC7B,MAAA,IAAI,CAAC,MAAM,OAAA,CAAQ,IAAI,GAAG,MAAM,IAAI,MAAM,2BAA2B,CAAA;AACrE,MAAA,OAAO,IAAA;AAAA,IACT,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,MAAM,OAAO,YAAY;AACvB,IAAA,IAAI,QAAA,IAAY,CAAC,MAAA,EAAQ;AACzB,IAAA,SAAA,CAAU,QAAQ,CAAA;AAClB,IAAA,QAAA,CAAS,EAAE,CAAA;AACX,IAAA,IAAI;AACF,MAAA,MAAM,OAAO,MAAM,CAAA;AACnB,MAAA,SAAA,CAAU,OAAO,CAAA;AAAA,IACnB,SAAS,KAAA,EAAO;AACd,MAAA,SAAA,CAAU,OAAO,CAAA;AACjB,MAAA,QAAA,CAAS,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,yBAAyB,CAAA;AAAA,IAC7E;AAAA,EACF,CAAA;AAEA,EAAA,IAAI,QAAA,EAAU,uBAAOC,cAAA,CAAAC,mBAAA,EAAA,EAAG,QAAA,EAAS,CAAA;AAEjC,EAAA,uBACEC,eAAA,CAAC,SAAA,EAAA,EAAQ,wCAAA,EAAsC,IAAA,EAAC,OAAO,WAAA,EACrD,QAAA,EAAA;AAAA,oBAAAF,cAAA,CAAC,GAAA,EAAA,EAAE,KAAA,EAAO,aAAA,EAAe,QAAA,EAAA,iBAAA,EAAe,CAAA;AAAA,oBACxCA,cAAA;AAAA,MAAC,UAAA;AAAA,MAAA;AAAA,QACC,YAAA,EAAW,eAAA;AAAA,QACX,KAAA,EAAO,KAAA;AAAA,QACP,UAAU,CAAC,KAAA,KAAU,QAAA,CAAS,KAAA,CAAM,OAAO,KAAK,CAAA;AAAA,QAChD,QAAA;AAAA,QACA,KAAA,EAAO;AAAA,UACL,KAAA,EAAO,MAAA;AAAA,UACP,SAAA,EAAW,OAAA;AAAA,UACX,UAAA,EAAY,gDAAA;AAAA,UACZ,QAAA,EAAU,MAAA;AAAA,UACV,UAAA,EAAY,IAAA;AAAA,UACZ,MAAA,EAAQ,mBAAA;AAAA,UACR,YAAA,EAAc,KAAA;AAAA,UACd,OAAA,EAAS;AAAA;AACX;AAAA,KACF;AAAA,oBACAE,eAAA,CAAC,KAAA,EAAA,EAAI,KAAA,EAAO,EAAE,OAAA,EAAS,MAAA,EAAQ,UAAA,EAAY,QAAA,EAAU,GAAA,EAAK,KAAA,EAAO,SAAA,EAAW,KAAA,EAAM,EAChF,QAAA,EAAA;AAAA,sBAAAF,cAAA,CAAC,QAAA,EAAA,EAAO,MAAK,QAAA,EAAS,OAAA,EAAS,MAAM,QAAA,EAAU,QAAA,IAAY,CAAC,MAAA,EAAQ,QAAA,EAAA,MAAA,EAEpE,CAAA;AAAA,sBACAA,cAAA,CAAC,MAAA,EAAA,EAAK,WAAA,EAAU,QAAA,EAAU,QAAA,EAAA,MAAA,EAAO,CAAA;AAAA,MAChC,CAAC,0BAAUA,cAAA,CAAC,MAAA,EAAA,EAAK,OAAO,EAAE,KAAA,EAAO,SAAA,EAAU,EAAG,QAAA,EAAA,cAAA,EAAY,CAAA;AAAA,MAC1D,KAAA,mCAAU,MAAA,EAAA,EAAK,KAAA,EAAO,EAAE,KAAA,EAAO,SAAA,IAAc,QAAA,EAAA,KAAA,EAAM;AAAA,KAAA,EACtD;AAAA,GAAA,EACF,CAAA;AAEJ;AAOO,SAAS,gBAAA,CAAiB,EAAE,QAAA,EAAU,UAAA,EAAW,EAA0B;AAChF,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAIF,cAAA,CAAiC,EAAE,CAAA;AAE/D,EAAA,uBACEI,eAAA,CAAC,SAAA,EAAA,EAAQ,0CAAA,EAAwC,IAAA,EAAC,OAAO,WAAA,EACvD,QAAA,EAAA;AAAA,oBAAAF,cAAA,CAAC,GAAA,EAAA,EAAE,KAAA,EAAO,aAAA,EAAe,QAAA,EAAA,mBAAA,EAAiB,CAAA;AAAA,mCACzC,IAAA,EAAA,EAAG,KAAA,EAAO,EAAE,MAAA,EAAQ,CAAA,EAAG,SAAS,CAAA,EAAG,SAAA,EAAW,MAAA,EAAQ,OAAA,EAAS,QAAQ,GAAA,EAAK,MAAA,IAC1E,QAAA,EAAA,QAAA,CAAS,GAAA,CAAI,CAAC,OAAA,qBACbE,eAAA;AAAA,MAAC,IAAA;AAAA,MAAA;AAAA,QAEC,KAAA,EAAO;AAAA,UACL,MAAA,EAAQ,mBAAA;AAAA,UACR,YAAA,EAAc,KAAA;AAAA,UACd,OAAA,EAAS,MAAA;AAAA,UACT,OAAA,EAAS,MAAA;AAAA,UACT,GAAA,EAAK;AAAA,SACP;AAAA,QAEA,QAAA,EAAA;AAAA,0BAAAF,cAAA,CAAC,QAAA,EAAA,EAAQ,kBAAQ,KAAA,EAAM,CAAA;AAAA,0BACvBE,eAAA,CAAC,WAAM,KAAA,EAAO,EAAE,SAAS,MAAA,EAAQ,GAAA,EAAK,OAAM,EAAG,QAAA,EAAA;AAAA,YAAA,YAAA;AAAA,4BAE7CF,cAAA;AAAA,cAAC,OAAA;AAAA,cAAA;AAAA,gBACC,IAAA,EAAK,gBAAA;AAAA,gBACL,KAAA,EAAO,MAAA,CAAO,OAAA,CAAQ,EAAE,CAAA,IAAK,EAAA;AAAA,gBAC7B,QAAA,EAAU,CAAC,KAAA,KAAU;AACnB,kBAAA,MAAM,KAAA,GAAQ,MAAM,MAAA,CAAO,KAAA;AAC3B,kBAAA,SAAA,CAAU,CAAC,QAAA,MAAc,EAAE,GAAG,QAAA,EAAU,CAAC,OAAA,CAAQ,EAAE,GAAG,KAAA,EAAM,CAAE,CAAA;AAAA,gBAChE;AAAA;AAAA;AACF,WAAA,EACF,CAAA;AAAA,0BACAA,cAAA;AAAA,YAAC,QAAA;AAAA,YAAA;AAAA,cACC,IAAA,EAAK,QAAA;AAAA,cACL,SAAS,MAAM;AACb,gBAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,OAAA,CAAQ,EAAE,CAAA;AAC/B,gBAAA,IAAI,CAAC,KAAA,EAAO;AACZ,gBAAA,KAAK,UAAA,CAAW,QAAQ,EAAA,EAAI,IAAI,KAAK,KAAK,CAAA,CAAE,aAAa,CAAA;AAAA,cAC3D,CAAA;AAAA,cACD,QAAA,EAAA;AAAA;AAAA;AAED;AAAA,OAAA;AAAA,MA9BK,OAAA,CAAQ;AAAA,KAgChB,CAAA,EACH;AAAA,GAAA,EACF,CAAA;AAEJ;AAOO,SAAS,YAAA,CAAa,EAAE,OAAA,EAAS,UAAA,GAAa,CAAC,OAAA,EAAS,WAAW,GAAE,EAAsB;AAChG,EAAA,uBACEE,eAAA,CAAC,SAAA,EAAA,EAAQ,sCAAA,EAAoC,IAAA,EAAC,OAAO,WAAA,EACnD,QAAA,EAAA;AAAA,oBAAAF,cAAA,CAAC,GAAA,EAAA,EAAE,KAAA,EAAO,aAAA,EAAe,QAAA,EAAA,eAAA,EAAa,CAAA;AAAA,IACrC,CAAC,OAAA,mBACAA,cAAA,CAAC,GAAA,EAAA,EAAE,KAAA,EAAO,EAAE,MAAA,EAAQ,CAAA,EAAG,KAAA,EAAO,SAAA,EAAU,EAAG,QAAA,EAAA,8BAAA,EAA4B,oBAEvEE,eAAA,CAAAD,mBAAA,EAAA,EACE,QAAA,EAAA;AAAA,sBAAAD,cAAA,CAAC,GAAA,EAAA,EAAE,OAAO,EAAE,MAAA,EAAQ,WAAW,UAAA,EAAY,GAAA,EAAI,EAAI,QAAA,EAAA,OAAA,CAAQ,KAAA,EAAM,CAAA;AAAA,sBACjEA,cAAA,CAAC,GAAA,EAAA,EAAE,KAAA,EAAO,EAAE,MAAA,EAAQ,SAAA,EAAW,KAAA,EAAO,SAAA,EAAU,EAAI,QAAA,EAAA,OAAA,CAAQ,WAAA,IAAe,gBAAA,EAAiB,CAAA;AAAA,sBAC5FA,cAAA,CAAC,KAAA,EAAA,EAAI,KAAA,EAAO,EAAE,SAAS,MAAA,EAAQ,QAAA,EAAU,MAAA,EAAQ,GAAA,EAAK,KAAA,EAAM,EACzD,QAAA,EAAA,UAAA,CAAW,GAAA,CAAI,CAAC,SAAA,qBACfA,cAAA;AAAA,QAAC,MAAA;AAAA,QAAA;AAAA,UAEC,KAAA,EAAO;AAAA,YACL,MAAA,EAAQ,mBAAA;AAAA,YACR,YAAA,EAAc,OAAA;AAAA,YACd,OAAA,EAAS,SAAA;AAAA,YACT,QAAA,EAAU;AAAA,WACZ;AAAA,UAEC,QAAA,EAAA;AAAA,SAAA;AAAA,QARI;AAAA,OAUR,CAAA,EACH;AAAA,KAAA,EACF;AAAA,GAAA,EAEJ,CAAA;AAEJ;AAWA,SAAS,MAAA,CAAO,MAA4B,KAAA,EAAyB;AACnE,EAAA,MAAM,KAAA,GAAQ,IAAI,GAAA,CAAI,IAAA,IAAQ,EAAE,CAAA;AAChC,EAAA,IAAI,MAAM,GAAA,CAAI,KAAK,CAAA,EAAG,KAAA,CAAM,OAAO,KAAK,CAAA;AAAA,OACnC,KAAA,CAAM,IAAI,KAAK,CAAA;AACpB,EAAA,OAAO,KAAA,CAAM,KAAK,KAAK,CAAA;AACzB;AAEO,SAAS,eAAA,CAAgB;AAAA,EAC9B,WAAW,EAAC;AAAA,EACZ,QAAQ,EAAC;AAAA,EACT,UAAU,EAAC;AAAA,EACX,KAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF,CAAA,EAAyB;AACvB,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAIF,cAAA,CAAuB;AAAA,IACrD,IAAA,EAAM,KAAA,EAAO,IAAA,IAAQ,EAAC;AAAA,IACtB,IAAA,EAAM,KAAA,EAAO,IAAA,IAAQ,EAAC;AAAA,IACtB,MAAA,EAAQ,KAAA,EAAO,MAAA,IAAU;AAAC,GAC3B,CAAA;AAED,EAAA,MAAM,cAAA,GAAiB,CAAC,IAAA,KAAuB;AAC7C,IAAA,WAAA,CAAY,IAAI,CAAA;AAChB,IAAA,QAAA,GAAW,IAAI,CAAA;AAAA,EACjB,CAAA;AAEA,EAAA,MAAM,UAAU,CACd,KAAA,EACA,MAAA,EACA,QAAA,EACA,6BAEAI,eAAA,CAAC,UAAA,EAAA,EAAS,KAAA,EAAO,EAAE,QAAQ,MAAA,EAAQ,MAAA,EAAQ,CAAA,EAAG,OAAA,EAAS,GAAE,EACvD,QAAA,EAAA;AAAA,oBAAAF,cAAA,CAAC,QAAA,EAAA,EAAO,OAAO,EAAE,UAAA,EAAY,KAAK,YAAA,EAAc,KAAA,IAAU,QAAA,EAAA,KAAA,EAAM,CAAA;AAAA,oBAChEA,cAAA,CAAC,KAAA,EAAA,EAAI,KAAA,EAAO,EAAE,OAAA,EAAS,QAAQ,QAAA,EAAU,MAAA,EAAQ,GAAA,EAAK,KAAA,EAAM,EACzD,QAAA,EAAA,MAAA,CAAO,IAAI,CAAC,IAAA,qBACXE,eAAA,CAAC,OAAA,EAAA,EAAiB,KAAA,EAAO,EAAE,OAAA,EAAS,aAAA,EAAe,UAAA,EAAY,QAAA,EAAU,GAAA,EAAK,KAAA,EAAM,EAClF,QAAA,EAAA;AAAA,sBAAAF,cAAA;AAAA,QAAC,OAAA;AAAA,QAAA;AAAA,UACC,IAAA,EAAK,UAAA;AAAA,UACL,OAAA,EAAS,OAAA,CAAQ,QAAA,EAAU,QAAA,CAAS,IAAI,CAAC,CAAA;AAAA,UACzC,QAAA,EAAU,MAAM,QAAA,CAAS,IAAI;AAAA;AAAA,OAC/B;AAAA,MACC;AAAA,KAAA,EAAA,EANS,IAOZ,CACD,CAAA,EACH;AAAA,GAAA,EACF,CAAA;AAGF,EAAA,uBACEE,eAAA,CAAC,SAAA,EAAA,EAAQ,yCAAA,EAAuC,IAAA,EAAC,OAAO,WAAA,EACtD,QAAA,EAAA;AAAA,oBAAAF,cAAA,CAAC,GAAA,EAAA,EAAE,KAAA,EAAO,aAAA,EAAe,QAAA,EAAA,kBAAA,EAAgB,CAAA;AAAA,oBACzCE,eAAA,CAAC,SAAI,KAAA,EAAO,EAAE,SAAS,MAAA,EAAQ,GAAA,EAAK,QAAO,EACxC,QAAA,EAAA;AAAA,MAAA,OAAA,CAAQ,SAAS,QAAA,EAAU,QAAA,CAAS,IAAA,EAAM,CAAC,SAC1C,cAAA,CAAe,EAAE,GAAG,QAAA,EAAU,MAAM,MAAA,CAAO,QAAA,CAAS,MAAM,IAAI,CAAA,EAAG,CAAC,CAAA;AAAA,MACnE,QAAQ,OAAA,EAAS,KAAA,EAAO,SAAS,IAAA,EAAM,CAAC,SACvC,cAAA,CAAe,EAAE,GAAG,QAAA,EAAU,MAAM,MAAA,CAAO,QAAA,CAAS,MAAM,IAAI,CAAA,EAAG,CAAC,CAAA;AAAA,MACnE,QAAQ,SAAA,EAAW,OAAA,EAAS,SAAS,MAAA,EAAQ,CAAC,SAC7C,cAAA,CAAe,EAAE,GAAG,QAAA,EAAU,QAAQ,MAAA,CAAO,QAAA,CAAS,QAAQ,IAAI,CAAA,EAAG,CAAC;AAAA,KAAA,EAC1E,CAAA;AAAA,IACC,MAAA,oBACCF,cAAA;AAAA,MAAC,QAAA;AAAA,MAAA;AAAA,QACC,IAAA,EAAK,QAAA;AAAA,QACL,KAAA,EAAO,EAAE,SAAA,EAAW,MAAA,EAAO;AAAA,QAC3B,SAAS,MAAM;AACb,UAAA,KAAK,OAAO,QAAQ,CAAA;AAAA,QACtB,CAAA;AAAA,QACD,QAAA,EAAA;AAAA;AAAA;AAED,GAAA,EAEJ,CAAA;AAEJ","file":"admin.cjs","sourcesContent":["import { useMemo, useState, type CSSProperties, type ReactNode } from \"react\";\nimport type { AudienceRule, FeatureEntry } from \"../types\";\n\nconst panelStyles: CSSProperties = {\n  border: \"1px solid #e5e7eb\",\n  borderRadius: \"10px\",\n  padding: \"12px\",\n  background: \"#ffffff\",\n};\n\nconst headingStyles: CSSProperties = {\n  margin: \"0 0 8px\",\n  fontSize: \"15px\",\n  fontWeight: 700,\n};\n\nexport interface ManifestEditorProps {\n  features: readonly FeatureEntry[];\n  onSave: (updated: FeatureEntry[]) => Promise<void> | void;\n  readOnly?: boolean;\n  children?: ReactNode;\n}\n\nexport function ManifestEditor({\n  features,\n  onSave,\n  readOnly = false,\n  children,\n}: ManifestEditorProps) {\n  const [draft, setDraft] = useState(() => JSON.stringify(features, null, 2));\n  const [status, setStatus] = useState<string>(\"idle\");\n  const [error, setError] = useState<string>(\"\");\n\n  const parsed = useMemo(() => {\n    try {\n      const next = JSON.parse(draft) as unknown;\n      if (!Array.isArray(next)) throw new Error(\"Manifest must be an array\");\n      return next as FeatureEntry[];\n    } catch {\n      return null;\n    }\n  }, [draft]);\n\n  const save = async () => {\n    if (readOnly || !parsed) return;\n    setStatus(\"saving\");\n    setError(\"\");\n    try {\n      await onSave(parsed);\n      setStatus(\"saved\");\n    } catch (cause) {\n      setStatus(\"error\");\n      setError(cause instanceof Error ? cause.message : \"Failed to save manifest\");\n    }\n  };\n\n  if (children) return <>{children}</>;\n\n  return (\n    <section data-featuredrop-admin-manifest-editor style={panelStyles}>\n      <p style={headingStyles}>Manifest Editor</p>\n      <textarea\n        aria-label=\"Manifest JSON\"\n        value={draft}\n        onChange={(event) => setDraft(event.target.value)}\n        readOnly={readOnly}\n        style={{\n          width: \"100%\",\n          minHeight: \"180px\",\n          fontFamily: \"ui-monospace, SFMono-Regular, Menlo, monospace\",\n          fontSize: \"12px\",\n          lineHeight: 1.45,\n          border: \"1px solid #d1d5db\",\n          borderRadius: \"8px\",\n          padding: \"10px\",\n        }}\n      />\n      <div style={{ display: \"flex\", alignItems: \"center\", gap: \"8px\", marginTop: \"8px\" }}>\n        <button type=\"button\" onClick={save} disabled={readOnly || !parsed}>\n          Save\n        </button>\n        <span aria-live=\"polite\">{status}</span>\n        {!parsed && <span style={{ color: \"#dc2626\" }}>Invalid JSON</span>}\n        {error && <span style={{ color: \"#dc2626\" }}>{error}</span>}\n      </div>\n    </section>\n  );\n}\n\nexport interface ScheduleCalendarProps {\n  features: readonly FeatureEntry[];\n  onSchedule: (featureId: string, publishAt: string) => Promise<void> | void;\n}\n\nexport function ScheduleCalendar({ features, onSchedule }: ScheduleCalendarProps) {\n  const [values, setValues] = useState<Record<string, string>>({});\n\n  return (\n    <section data-featuredrop-admin-schedule-calendar style={panelStyles}>\n      <p style={headingStyles}>Schedule Calendar</p>\n      <ul style={{ margin: 0, padding: 0, listStyle: \"none\", display: \"grid\", gap: \"10px\" }}>\n        {features.map((feature) => (\n          <li\n            key={feature.id}\n            style={{\n              border: \"1px solid #e5e7eb\",\n              borderRadius: \"8px\",\n              padding: \"10px\",\n              display: \"grid\",\n              gap: \"6px\",\n            }}\n          >\n            <strong>{feature.label}</strong>\n            <label style={{ display: \"grid\", gap: \"4px\" }}>\n              Publish at\n              <input\n                type=\"datetime-local\"\n                value={values[feature.id] ?? \"\"}\n                onChange={(event) => {\n                  const value = event.target.value;\n                  setValues((previous) => ({ ...previous, [feature.id]: value }));\n                }}\n              />\n            </label>\n            <button\n              type=\"button\"\n              onClick={() => {\n                const value = values[feature.id];\n                if (!value) return;\n                void onSchedule(feature.id, new Date(value).toISOString());\n              }}\n            >\n              Schedule\n            </button>\n          </li>\n        ))}\n      </ul>\n    </section>\n  );\n}\n\nexport interface PreviewPanelProps {\n  feature?: FeatureEntry | null;\n  components?: Array<\"badge\" | \"changelog\" | \"spotlight\" | \"banner\" | \"toast\">;\n}\n\nexport function PreviewPanel({ feature, components = [\"badge\", \"changelog\"] }: PreviewPanelProps) {\n  return (\n    <section data-featuredrop-admin-preview-panel style={panelStyles}>\n      <p style={headingStyles}>Preview Panel</p>\n      {!feature ? (\n        <p style={{ margin: 0, color: \"#6b7280\" }}>Select a feature to preview.</p>\n      ) : (\n        <>\n          <p style={{ margin: \"0 0 6px\", fontWeight: 600 }}>{feature.label}</p>\n          <p style={{ margin: \"0 0 8px\", color: \"#6b7280\" }}>{feature.description ?? \"No description\"}</p>\n          <div style={{ display: \"flex\", flexWrap: \"wrap\", gap: \"6px\" }}>\n            {components.map((component) => (\n              <span\n                key={component}\n                style={{\n                  border: \"1px solid #d1d5db\",\n                  borderRadius: \"999px\",\n                  padding: \"2px 8px\",\n                  fontSize: \"12px\",\n                }}\n              >\n                {component}\n              </span>\n            ))}\n          </div>\n        </>\n      )}\n    </section>\n  );\n}\n\nexport interface AudienceBuilderProps {\n  segments?: string[];\n  roles?: string[];\n  regions?: string[];\n  value?: AudienceRule;\n  onChange?: (audience: AudienceRule) => void;\n  onSave?: (audience: AudienceRule) => Promise<void> | void;\n}\n\nfunction toggle(list: string[] | undefined, value: string): string[] {\n  const items = new Set(list ?? []);\n  if (items.has(value)) items.delete(value);\n  else items.add(value);\n  return Array.from(items);\n}\n\nexport function AudienceBuilder({\n  segments = [],\n  roles = [],\n  regions = [],\n  value,\n  onChange,\n  onSave,\n}: AudienceBuilderProps) {\n  const [audience, setAudience] = useState<AudienceRule>({\n    plan: value?.plan ?? [],\n    role: value?.role ?? [],\n    region: value?.region ?? [],\n  });\n\n  const updateAudience = (next: AudienceRule) => {\n    setAudience(next);\n    onChange?.(next);\n  };\n\n  const section = (\n    title: string,\n    values: string[],\n    selected: string[] | undefined,\n    onToggle: (value: string) => void,\n  ) => (\n    <fieldset style={{ border: \"none\", margin: 0, padding: 0 }}>\n      <legend style={{ fontWeight: 600, marginBottom: \"4px\" }}>{title}</legend>\n      <div style={{ display: \"flex\", flexWrap: \"wrap\", gap: \"8px\" }}>\n        {values.map((item) => (\n          <label key={item} style={{ display: \"inline-flex\", alignItems: \"center\", gap: \"6px\" }}>\n            <input\n              type=\"checkbox\"\n              checked={Boolean(selected?.includes(item))}\n              onChange={() => onToggle(item)}\n            />\n            {item}\n          </label>\n        ))}\n      </div>\n    </fieldset>\n  );\n\n  return (\n    <section data-featuredrop-admin-audience-builder style={panelStyles}>\n      <p style={headingStyles}>Audience Builder</p>\n      <div style={{ display: \"grid\", gap: \"10px\" }}>\n        {section(\"Plans\", segments, audience.plan, (item) =>\n          updateAudience({ ...audience, plan: toggle(audience.plan, item) }))}\n        {section(\"Roles\", roles, audience.role, (item) =>\n          updateAudience({ ...audience, role: toggle(audience.role, item) }))}\n        {section(\"Regions\", regions, audience.region, (item) =>\n          updateAudience({ ...audience, region: toggle(audience.region, item) }))}\n      </div>\n      {onSave && (\n        <button\n          type=\"button\"\n          style={{ marginTop: \"10px\" }}\n          onClick={() => {\n            void onSave(audience);\n          }}\n        >\n          Save audience\n        </button>\n      )}\n    </section>\n  );\n}\n"]}

package/dist/admin.d.cts

@@ -0,0 +1,176 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+/** Entry type label — determines default icon/color in UI */
+type FeatureType = "feature" | "improvement" | "fix" | "breaking";
+/** Priority level for announcements */
+type FeaturePriority = "critical" | "normal" | "low";
+/** Call-to-action for a feature entry */
+interface FeatureCTA {
+    /** Button/link label */
+    label: string;
+    /** URL to navigate to */
+    url: string;
+}
+/** Variant-level overrides for A/B announcement testing */
+interface FeatureVariant {
+    /** Optional variant-specific label override */
+    label?: string;
+    /** Optional variant-specific description override */
+    description?: string;
+    /** Optional variant-specific image override */
+    image?: string;
+    /** Optional variant-specific CTA override */
+    cta?: FeatureCTA;
+    /** Optional variant-specific metadata overrides */
+    meta?: Record<string, unknown>;
+}
+/** Audience targeting rule — determines which user segments see a feature */
+interface AudienceRule {
+    /** Plans that should see this feature (e.g. ["pro", "enterprise"]) */
+    plan?: string[];
+    /** Roles that should see this feature (e.g. ["admin", "editor"]) */
+    role?: string[];
+    /** Regions that should see this feature (e.g. ["us", "eu"]) */
+    region?: string[];
+    /** Arbitrary key-value pairs for custom matching logic */
+    custom?: Record<string, unknown>;
+}
+/** Dependency gates for progressive feature discovery */
+interface FeatureDependencies {
+    /** Features the user must have seen before this one can surface */
+    seen?: string[];
+    /** Features the user must have clicked before this one can surface */
+    clicked?: string[];
+    /** Features the user must have dismissed before this one can surface */
+    dismissed?: string[];
+}
+/** Runtime context used by trigger evaluation */
+interface TriggerContext {
+    /** Current app route/path */
+    path?: string;
+    /** Named events observed in this session */
+    events?: ReadonlySet<string>;
+    /** Named milestone flags reached in this session */
+    milestones?: ReadonlySet<string>;
+    /** Usage counters keyed by event/pattern name */
+    usage?: Record<string, number>;
+    /** Session elapsed time in milliseconds */
+    elapsedMs?: number;
+    /** Scroll completion percentage (0-100) */
+    scrollPercent?: number;
+    /** Optional additional trigger context */
+    metadata?: Record<string, unknown>;
+}
+type FeatureTrigger = {
+    type: "page";
+    match: string | RegExp;
+} | {
+    type: "usage";
+    event: string;
+    minActions?: number;
+} | {
+    type: "time";
+    minSeconds: number;
+} | {
+    type: "milestone";
+    event: string;
+} | {
+    type: "frustration";
+    pattern: string;
+    threshold?: number;
+} | {
+    type: "scroll";
+    minPercent?: number;
+} | {
+    type: "custom";
+    evaluate: (context: TriggerContext) => boolean;
+};
+/** A single feature entry in the manifest */
+interface FeatureEntry {
+    /** Unique identifier for the feature */
+    id: string;
+    /** Human-readable label (e.g. "Decision Journal") */
+    label: string;
+    /** Optional longer description (supports markdown in UI components) */
+    description?: string;
+    /**
+     * Semantic version targeting.
+     * If provided as an object, requires `appVersion` to be supplied to the provider/helpers.
+     * - introduced: earliest app version that includes this feature
+     * - showNewUntil: stop showing "new" once appVersion reaches this
+     * - deprecatedAt: hide feature for app versions at or above this (optional safety)
+     * - showIn: range string, e.g. ">=2.5.0 <3.0.0"
+     */
+    version?: string | {
+        introduced?: string;
+        showNewUntil?: string;
+        deprecatedAt?: string;
+        showIn?: string;
+    };
+    /** ISO date when this feature was released */
+    releasedAt: string;
+    /** ISO date after which the "new" badge should stop showing */
+    showNewUntil: string;
+    /** Optional key to match navigation items (e.g. "/journal", "settings") */
+    sidebarKey?: string;
+    /** Optional grouping category (e.g. "ai", "billing", "core") */
+    category?: string;
+    /** Optional product scope (`"*"`, `"askverdict"`, etc.) for multi-product manifests */
+    product?: string;
+    /** Optional URL to link to (e.g. docs page, changelog entry) */
+    url?: string;
+    /** Optional feature flag key; requires a flag bridge to evaluate */
+    flagKey?: string;
+    /** Entry type — determines default icon/color in UI components */
+    type?: FeatureType;
+    /** Priority level — critical entries get special treatment in UI */
+    priority?: FeaturePriority;
+    /** Optional image/screenshot URL */
+    image?: string;
+    /** Optional call-to-action button */
+    cta?: FeatureCTA;
+    /** ISO date — entry is hidden until this date (scheduled publishing) */
+    publishAt?: string;
+    /** Optional arbitrary metadata */
+    meta?: Record<string, unknown>;
+    /** A/B variants keyed by variant name (e.g. control, treatment_a) */
+    variants?: Record<string, FeatureVariant>;
+    /** Percentage split per variant (same order as variants object keys) */
+    variantSplit?: number[];
+    /** Audience targeting — if set, only matching users see this feature */
+    audience?: AudienceRule;
+    /** Dependency requirements (progressive disclosure sequencing) */
+    dependsOn?: FeatureDependencies;
+    /** Contextual trigger rule */
+    trigger?: FeatureTrigger;
+}
+
+interface ManifestEditorProps {
+    features: readonly FeatureEntry[];
+    onSave: (updated: FeatureEntry[]) => Promise<void> | void;
+    readOnly?: boolean;
+    children?: ReactNode;
+}
+declare function ManifestEditor({ features, onSave, readOnly, children, }: ManifestEditorProps): react_jsx_runtime.JSX.Element;
+interface ScheduleCalendarProps {
+    features: readonly FeatureEntry[];
+    onSchedule: (featureId: string, publishAt: string) => Promise<void> | void;
+}
+declare function ScheduleCalendar({ features, onSchedule }: ScheduleCalendarProps): react_jsx_runtime.JSX.Element;
+interface PreviewPanelProps {
+    feature?: FeatureEntry | null;
+    components?: Array<"badge" | "changelog" | "spotlight" | "banner" | "toast">;
+}
+declare function PreviewPanel({ feature, components }: PreviewPanelProps): react_jsx_runtime.JSX.Element;
+interface AudienceBuilderProps {
+    segments?: string[];
+    roles?: string[];
+    regions?: string[];
+    value?: AudienceRule;
+    onChange?: (audience: AudienceRule) => void;
+    onSave?: (audience: AudienceRule) => Promise<void> | void;
+}
+declare function AudienceBuilder({ segments, roles, regions, value, onChange, onSave, }: AudienceBuilderProps): react_jsx_runtime.JSX.Element;
+
+export { AudienceBuilder, type AudienceBuilderProps, ManifestEditor, type ManifestEditorProps, PreviewPanel, type PreviewPanelProps, ScheduleCalendar, type ScheduleCalendarProps };