featuredrop 1.1.0 → 1.2.0

package/dist/angular.cjs

@@ -0,0 +1,286 @@
+'use strict';
+
+// src/semver.ts
+var SEMVER_REGEX = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?/;
+function parseSemver(input) {
+  const match = input.trim().match(SEMVER_REGEX);
+  if (!match) return null;
+  return {
+    major: Number(match[1]),
+    minor: Number(match[2]),
+    patch: Number(match[3]),
+    prerelease: match[4] ? match[4].split(".") : []
+  };
+}
+function compareSemver(a, b) {
+  const pa = parseSemver(a);
+  const pb = parseSemver(b);
+  if (!pa || !pb) return 0;
+  for (const key of ["major", "minor", "patch"]) {
+    if (pa[key] !== pb[key]) return pa[key] - pb[key];
+  }
+  const aPre = pa.prerelease;
+  const bPre = pb.prerelease;
+  if (aPre.length === 0 && bPre.length === 0) return 0;
+  if (aPre.length === 0) return 1;
+  if (bPre.length === 0) return -1;
+  const len = Math.max(aPre.length, bPre.length);
+  for (let i = 0; i < len; i++) {
+    const ai = aPre[i];
+    const bi = bPre[i];
+    if (ai === void 0) return -1;
+    if (bi === void 0) return 1;
+    const aNum = Number(ai);
+    const bNum = Number(bi);
+    const aIsNum = Number.isInteger(aNum);
+    const bIsNum = Number.isInteger(bNum);
+    if (aIsNum && bIsNum && aNum !== bNum) return aNum - bNum;
+    if (aIsNum !== bIsNum) return aIsNum ? -1 : 1;
+    if (ai !== bi) return ai < bi ? -1 : 1;
+  }
+  return 0;
+}
+function parseComparator(comp) {
+  const match = comp.trim().match(/^(>=|<=|>|<|=)?\\s*(.+)$/);
+  if (!match) return null;
+  const op = match[1] || ">=";
+  const version = match[2];
+  if (!parseSemver(version)) return null;
+  return { op, version };
+}
+function satisfiesComparator(version, comp) {
+  const diff = compareSemver(version, comp.version);
+  switch (comp.op) {
+    case ">":
+      return diff > 0;
+    case ">=":
+      return diff >= 0;
+    case "<":
+      return diff < 0;
+    case "<=":
+      return diff <= 0;
+    case "=":
+      return diff === 0;
+    default:
+      return false;
+  }
+}
+function satisfiesRange(version, range) {
+  const parts = range.split(/\s+/).filter(Boolean);
+  if (parts.length === 0) return true;
+  for (const part of parts) {
+    const comp = parseComparator(part);
+    if (!comp) return false;
+    if (!satisfiesComparator(version, comp)) return false;
+  }
+  return true;
+}
+function isTriggerMatch(trigger, context) {
+  if (!trigger) return true;
+  return false;
+}
+
+// src/core.ts
+function matchesAudience(audience, userContext) {
+  if (audience.plan && audience.plan.length > 0) {
+    if (!userContext.plan || !audience.plan.includes(userContext.plan)) {
+      return false;
+    }
+  }
+  if (audience.role && audience.role.length > 0) {
+    if (!userContext.role || !audience.role.includes(userContext.role)) {
+      return false;
+    }
+  }
+  if (audience.region && audience.region.length > 0) {
+    if (!userContext.region || !audience.region.includes(userContext.region)) {
+      return false;
+    }
+  }
+  return true;
+}
+function isAudienceMatch(feature, userContext, matchFn) {
+  if (!feature.audience) return true;
+  const { plan, role, region, custom } = feature.audience;
+  const hasRules = plan && plan.length > 0 || role && role.length > 0 || region && region.length > 0 || custom && Object.keys(custom).length > 0;
+  if (!hasRules) return true;
+  if (!userContext) return false;
+  if (matchFn) return matchFn(feature.audience, userContext);
+  return matchesAudience(feature.audience, userContext);
+}
+function isVersionMatch(feature, appVersion) {
+  const v = feature.version;
+  if (!v || typeof v === "string") return true;
+  if (!appVersion) return false;
+  if (!v.introduced && !v.showNewUntil && !v.deprecatedAt && !v.showIn) return true;
+  if (v.showIn && !satisfiesRange(appVersion, v.showIn)) return false;
+  if (v.introduced && compareSemver(appVersion, v.introduced) < 0) return false;
+  if (v.deprecatedAt && compareSemver(appVersion, v.deprecatedAt) >= 0) return false;
+  if (v.showNewUntil && compareSemver(appVersion, v.showNewUntil) >= 0) return false;
+  return true;
+}
+function isDependencyMatch(feature, dismissedIds, dependencyState) {
+  const dependsOn = feature.dependsOn;
+  if (!dependsOn) return true;
+  const dismissedDependencyIds = dismissedIds;
+  if (dependsOn.seen && dependsOn.seen.length > 0) {
+    for (const id of dependsOn.seen) {
+      if (!dismissedDependencyIds.has(id)) return false;
+    }
+  }
+  if (dependsOn.clicked && dependsOn.clicked.length > 0) {
+    for (const id of dependsOn.clicked) {
+      return false;
+    }
+  }
+  if (dependsOn.dismissed && dependsOn.dismissed.length > 0) {
+    for (const id of dependsOn.dismissed) {
+      if (!dismissedDependencyIds.has(id)) return false;
+    }
+  }
+  return true;
+}
+function isNew(feature, watermark, dismissedIds, now = /* @__PURE__ */ new Date(), userContext, matchAudience, appVersion, dependencyState, triggerContext) {
+  if (dismissedIds.has(feature.id)) return false;
+  if (!isAudienceMatch(feature, userContext, matchAudience)) return false;
+  if (!isDependencyMatch(feature, dismissedIds)) return false;
+  if (!isVersionMatch(feature, appVersion)) return false;
+  if (!isTriggerMatch(feature.trigger)) return false;
+  const nowMs = now.getTime();
+  if (feature.publishAt) {
+    const publishMs = new Date(feature.publishAt).getTime();
+    if (nowMs < publishMs) return false;
+  }
+  const showUntilMs = new Date(feature.showNewUntil).getTime();
+  if (nowMs >= showUntilMs) return false;
+  if (watermark) {
+    const watermarkMs = new Date(watermark).getTime();
+    const releasedMs = new Date(feature.releasedAt).getTime();
+    if (releasedMs <= watermarkMs) return false;
+  }
+  return true;
+}
+function getNewFeatures(manifest, storage, now = /* @__PURE__ */ new Date(), userContext, matchAudience, appVersion, dependencyState, triggerContext) {
+  const watermark = storage.getWatermark();
+  const dismissedIds = storage.getDismissedIds();
+  return manifest.filter(
+    (f) => isNew(
+      f,
+      watermark,
+      dismissedIds,
+      now,
+      userContext,
+      matchAudience,
+      appVersion)
+  );
+}
+function hasNewFeature(manifest, sidebarKey, storage, now = /* @__PURE__ */ new Date(), userContext, matchAudience, appVersion, dependencyState, triggerContext) {
+  const watermark = storage.getWatermark();
+  const dismissedIds = storage.getDismissedIds();
+  return manifest.some(
+    (f) => f.sidebarKey === sidebarKey && isNew(
+      f,
+      watermark,
+      dismissedIds,
+      now,
+      userContext,
+      matchAudience,
+      appVersion)
+  );
+}
+
+// src/angular/index.ts
+function sortByPriority(features) {
+  const priorityOrder = { critical: 0, normal: 1, low: 2 };
+  return [...features].sort((a, b) => {
+    const pa = priorityOrder[a.priority ?? "normal"];
+    const pb = priorityOrder[b.priority ?? "normal"];
+    if (pa !== pb) return pa - pb;
+    return new Date(b.releasedAt).getTime() - new Date(a.releasedAt).getTime();
+  });
+}
+function createFeatureDropService(options) {
+  const computeFeatures = () => getNewFeatures(
+    options.manifest,
+    options.storage,
+    /* @__PURE__ */ new Date(),
+    options.userContext,
+    options.matchAudience,
+    options.appVersion
+  );
+  const newFeatures = options.createSignal(computeFeatures());
+  const refresh = () => {
+    newFeatures.set(computeFeatures());
+  };
+  const dismiss = (id) => {
+    const feature = newFeatures().find((item) => item.id === id);
+    options.storage.dismiss(id);
+    if (feature) {
+      options.analytics?.onFeatureDismissed?.(feature);
+    }
+    refresh();
+  };
+  const dismissAll = async () => {
+    await options.storage.dismissAll(/* @__PURE__ */ new Date());
+    options.analytics?.onAllDismissed?.();
+    refresh();
+  };
+  const newCount = () => newFeatures().length;
+  const isNew2 = (sidebarKey) => hasNewFeature(
+    options.manifest,
+    sidebarKey,
+    options.storage,
+    /* @__PURE__ */ new Date(),
+    options.userContext,
+    options.matchAudience,
+    options.appVersion
+  );
+  const getFeature = (sidebarKey) => newFeatures().find((feature) => feature.sidebarKey === sidebarKey);
+  return {
+    manifest: options.manifest,
+    newFeatures,
+    newCount,
+    newFeaturesSorted: () => sortByPriority(newFeatures()),
+    refresh,
+    dismiss,
+    dismissAll,
+    isNew: isNew2,
+    getFeature
+  };
+}
+var FeatureDropService = class {
+  manifest;
+  newFeatures;
+  service;
+  constructor(options) {
+    this.service = createFeatureDropService(options);
+    this.manifest = this.service.manifest;
+    this.newFeatures = this.service.newFeatures;
+  }
+  newCount() {
+    return this.service.newCount();
+  }
+  newFeaturesSorted() {
+    return this.service.newFeaturesSorted();
+  }
+  refresh() {
+    this.service.refresh();
+  }
+  dismiss(id) {
+    this.service.dismiss(id);
+  }
+  dismissAll() {
+    return this.service.dismissAll();
+  }
+  isNew(sidebarKey) {
+    return this.service.isNew(sidebarKey);
+  }
+  getFeature(sidebarKey) {
+    return this.service.getFeature(sidebarKey);
+  }
+};
+
+exports.FeatureDropService = FeatureDropService;
+exports.createFeatureDropService = createFeatureDropService;
+//# sourceMappingURL=angular.cjs.map
+//# sourceMappingURL=angular.cjs.map

package/dist/angular.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/semver.ts","../src/triggers.ts","../src/core.ts","../src/angular/index.ts"],"names":["isNew"],"mappings":"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","file":"angular.cjs","sourcesContent":["// Minimal semver comparison utilities (no build metadata sorting needed)\n\nexport type Comparator = \">=\" | \"<=\" | \">\" | \"<\" | \"=\";\n\nexport interface SemverParts {\n  major: number;\n  minor: number;\n  patch: number;\n  prerelease: string[];\n}\n\nconst SEMVER_REGEX = /^(\\d+)\\.(\\d+)\\.(\\d+)(?:-([0-9A-Za-z.-]+))?/;\n\nexport function parseSemver(input: string): SemverParts | null {\n  const match = input.trim().match(SEMVER_REGEX);\n  if (!match) return null;\n  return {\n    major: Number(match[1]),\n    minor: Number(match[2]),\n    patch: Number(match[3]),\n    prerelease: match[4] ? match[4].split(\".\") : [],\n  };\n}\n\nexport function compareSemver(a: string, b: string): number {\n  const pa = parseSemver(a);\n  const pb = parseSemver(b);\n  if (!pa || !pb) return 0;\n\n  for (const key of [\"major\", \"minor\", \"patch\"] as const) {\n    if (pa[key] !== pb[key]) return pa[key] - pb[key];\n  }\n\n  // Handle prerelease: absence > presence, otherwise lexicographic\n  const aPre = pa.prerelease;\n  const bPre = pb.prerelease;\n  if (aPre.length === 0 && bPre.length === 0) return 0;\n  if (aPre.length === 0) return 1;\n  if (bPre.length === 0) return -1;\n\n  const len = Math.max(aPre.length, bPre.length);\n  for (let i = 0; i < len; i++) {\n    const ai = aPre[i];\n    const bi = bPre[i];\n    if (ai === undefined) return -1;\n    if (bi === undefined) return 1;\n    const aNum = Number(ai);\n    const bNum = Number(bi);\n    const aIsNum = Number.isInteger(aNum);\n    const bIsNum = Number.isInteger(bNum);\n    if (aIsNum && bIsNum && aNum !== bNum) return aNum - bNum;\n    if (aIsNum !== bIsNum) return aIsNum ? -1 : 1;\n    if (ai !== bi) return ai < bi ? -1 : 1;\n  }\n  return 0;\n}\n\nfunction parseComparator(comp: string): { op: Comparator; version: string } | null {\n  const match = comp.trim().match(/^(>=|<=|>|<|=)?\\\\s*(.+)$/);\n  if (!match) return null;\n  const op = (match[1] as Comparator) || \">=\";\n  const version = match[2];\n  if (!parseSemver(version)) return null;\n  return { op, version };\n}\n\nfunction satisfiesComparator(version: string, comp: { op: Comparator; version: string }): boolean {\n  const diff = compareSemver(version, comp.version);\n  switch (comp.op) {\n    case \">\":\n      return diff > 0;\n    case \">=\":\n      return diff >= 0;\n    case \"<\":\n      return diff < 0;\n    case \"<=\":\n      return diff <= 0;\n    case \"=\":\n      return diff === 0;\n    default:\n      return false;\n  }\n}\n\n// Space-separated comparator list (AND semantics), e.g. \">=2.5.0 <3.0.0\"\nexport function satisfiesRange(version: string, range: string): boolean {\n  const parts = range.split(/\\s+/).filter(Boolean);\n  if (parts.length === 0) return true;\n  for (const part of parts) {\n    const comp = parseComparator(part);\n    if (!comp) return false;\n    if (!satisfiesComparator(version, comp)) return false;\n  }\n  return true;\n}\n","import type { FeatureEntry, FeatureTrigger, TriggerContext } from \"./types\";\n\nfunction wildcardToRegExp(value: string): RegExp {\n  const escaped = value.replace(/[.+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  const pattern = `^${escaped.replace(/\\*/g, \".*\")}$`;\n  return new RegExp(pattern);\n}\n\nfunction matchPath(path: string, pattern: string | RegExp): boolean {\n  if (pattern instanceof RegExp) return pattern.test(path);\n  if (!pattern) return false;\n  if (pattern.includes(\"*\")) return wildcardToRegExp(pattern).test(path);\n  return path === pattern || path.startsWith(pattern);\n}\n\nexport function isTriggerMatch(trigger: FeatureTrigger | undefined, context?: TriggerContext): boolean {\n  if (!trigger) return true;\n  if (!context) return false;\n\n  if (trigger.type === \"page\") {\n    const path = context.path;\n    if (!path) return false;\n    return matchPath(path, trigger.match);\n  }\n\n  if (trigger.type === \"usage\") {\n    const usage = context.usage ?? {};\n    const count = usage[trigger.event] ?? 0;\n    return count >= (trigger.minActions ?? 1);\n  }\n\n  if (trigger.type === \"time\") {\n    const elapsedMs = context.elapsedMs ?? 0;\n    return elapsedMs >= trigger.minSeconds * 1000;\n  }\n\n  if (trigger.type === \"milestone\") {\n    return context.milestones?.has(trigger.event) ?? false;\n  }\n\n  if (trigger.type === \"frustration\") {\n    const usage = context.usage ?? {};\n    const count = usage[trigger.pattern] ?? 0;\n    return count >= (trigger.threshold ?? 1);\n  }\n\n  if (trigger.type === \"scroll\") {\n    return (context.scrollPercent ?? 0) >= (trigger.minPercent ?? 50);\n  }\n\n  try {\n    return trigger.evaluate(context);\n  } catch {\n    return false;\n  }\n}\n\nexport class TriggerEngine {\n  private context: TriggerContext;\n\n  constructor(initial?: TriggerContext) {\n    this.context = {\n      path: initial?.path,\n      events: new Set(initial?.events ?? []),\n      milestones: new Set(initial?.milestones ?? []),\n      usage: { ...(initial?.usage ?? {}) },\n      elapsedMs: initial?.elapsedMs ?? 0,\n      scrollPercent: initial?.scrollPercent ?? 0,\n      metadata: { ...(initial?.metadata ?? {}) },\n    };\n  }\n\n  setPath(path: string): void {\n    this.context.path = path;\n  }\n\n  trackEvent(event: string): void {\n    const next = new Set(this.context.events ?? new Set<string>());\n    next.add(event);\n    this.context.events = next;\n  }\n\n  trackUsage(event: string, delta = 1): void {\n    const usage = { ...(this.context.usage ?? {}) };\n    usage[event] = (usage[event] ?? 0) + Math.max(1, delta);\n    this.context.usage = usage;\n  }\n\n  trackMilestone(event: string): void {\n    const next = new Set(this.context.milestones ?? new Set<string>());\n    next.add(event);\n    this.context.milestones = next;\n  }\n\n  setElapsedMs(elapsedMs: number): void {\n    this.context.elapsedMs = Math.max(0, elapsedMs);\n  }\n\n  setScrollPercent(scrollPercent: number): void {\n    const clamped = Math.max(0, Math.min(100, scrollPercent));\n    this.context.scrollPercent = clamped;\n  }\n\n  setMetadata(next: Record<string, unknown>): void {\n    this.context.metadata = { ...next };\n  }\n\n  getContext(): TriggerContext {\n    return {\n      path: this.context.path,\n      events: new Set(this.context.events ?? []),\n      milestones: new Set(this.context.milestones ?? []),\n      usage: { ...(this.context.usage ?? {}) },\n      elapsedMs: this.context.elapsedMs,\n      scrollPercent: this.context.scrollPercent,\n      metadata: { ...(this.context.metadata ?? {}) },\n    };\n  }\n\n  evaluate(trigger: FeatureTrigger | undefined): boolean {\n    return isTriggerMatch(trigger, this.context);\n  }\n\n  evaluateFeature(feature: Pick<FeatureEntry, \"trigger\">): boolean {\n    return this.evaluate(feature.trigger);\n  }\n}\n","import type {\n  AudienceMatchFn,\n  AudienceRule,\n  FeatureEntry,\n  FeatureManifest,\n  StorageAdapter,\n  UserContext,\n  FeatureDependencyState,\n  TriggerContext,\n} from \"./types\";\nimport { compareSemver, satisfiesRange } from \"./semver\";\nimport { isTriggerMatch } from \"./triggers\";\n\n/**\n * Default audience matching logic.\n *\n * For each specified field (plan, role, region), checks if the user's\n * value is included in the allowed list. Fields use AND logic between them,\n * OR logic within each field's array. The `custom` field is ignored by\n * the default matcher — use a custom `AudienceMatchFn` for that.\n */\nexport function matchesAudience(\n  audience: AudienceRule,\n  userContext: UserContext,\n): boolean {\n  if (audience.plan && audience.plan.length > 0) {\n    if (!userContext.plan || !audience.plan.includes(userContext.plan)) {\n      return false;\n    }\n  }\n  if (audience.role && audience.role.length > 0) {\n    if (!userContext.role || !audience.role.includes(userContext.role)) {\n      return false;\n    }\n  }\n  if (audience.region && audience.region.length > 0) {\n    if (!userContext.region || !audience.region.includes(userContext.region)) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/**\n * Check if a feature's audience allows the given user context.\n *\n * - No `audience` field → visible to all\n * - Empty `audience` ({}) → visible to all\n * - `audience` specified but no `userContext` → hidden (safe default)\n * - Otherwise, delegate to `matchFn` (or default `matchesAudience`)\n */\nfunction isAudienceMatch(\n  feature: FeatureEntry,\n  userContext?: UserContext,\n  matchFn?: AudienceMatchFn,\n): boolean {\n  // No audience restriction → show to everyone\n  if (!feature.audience) return true;\n\n  // Check if audience is empty (no fields with values)\n  const { plan, role, region, custom } = feature.audience;\n  const hasRules =\n    (plan && plan.length > 0) ||\n    (role && role.length > 0) ||\n    (region && region.length > 0) ||\n    (custom && Object.keys(custom).length > 0);\n  if (!hasRules) return true;\n\n  // Audience specified but no user context → hidden (safe default)\n  if (!userContext) return false;\n\n  // Use custom matcher if provided, otherwise default\n  if (matchFn) return matchFn(feature.audience, userContext);\n  return matchesAudience(feature.audience, userContext);\n}\n\nfunction isVersionMatch(feature: FeatureEntry, appVersion?: string): boolean {\n  const v = feature.version;\n  if (!v || typeof v === \"string\") return true; // string = display only\n  if (!appVersion) return false; // Safe default when constraints exist\n  if (!v.introduced && !v.showNewUntil && !v.deprecatedAt && !v.showIn) return true;\n\n  // Range check\n  if (v.showIn && !satisfiesRange(appVersion, v.showIn)) return false;\n\n  if (v.introduced && compareSemver(appVersion, v.introduced) < 0) return false;\n  if (v.deprecatedAt && compareSemver(appVersion, v.deprecatedAt) >= 0) return false;\n\n  // showNewUntil gates \"new\" state only\n  if (v.showNewUntil && compareSemver(appVersion, v.showNewUntil) >= 0) return false;\n\n  return true;\n}\n\nfunction isDependencyMatch(\n  feature: FeatureEntry,\n  dismissedIds: ReadonlySet<string>,\n  dependencyState?: FeatureDependencyState,\n): boolean {\n  const dependsOn = feature.dependsOn;\n  if (!dependsOn) return true;\n\n  const seenIds = dependencyState?.seenIds;\n  const clickedIds = dependencyState?.clickedIds;\n  const dismissedDependencyIds = dependencyState?.dismissedIds ?? dismissedIds;\n\n  if (dependsOn.seen && dependsOn.seen.length > 0) {\n    for (const id of dependsOn.seen) {\n      const seen = seenIds?.has(id) ?? false;\n      if (!seen && !dismissedDependencyIds.has(id)) return false;\n    }\n  }\n\n  if (dependsOn.clicked && dependsOn.clicked.length > 0) {\n    for (const id of dependsOn.clicked) {\n      if (!(clickedIds?.has(id) ?? false)) return false;\n    }\n  }\n\n  if (dependsOn.dismissed && dependsOn.dismissed.length > 0) {\n    for (const id of dependsOn.dismissed) {\n      if (!dismissedDependencyIds.has(id)) return false;\n    }\n  }\n\n  return true;\n}\n\n/**\n * Check if a single feature should show as \"new\".\n *\n * A feature is \"new\" when ALL of these are true:\n * 1. Current time is before `showNewUntil`\n * 2. Feature was released after the watermark (or no watermark exists)\n * 3. Feature has not been individually dismissed\n * 4. If `publishAt` is set, current time must be after it (scheduled publishing)\n * 5. If `audience` is set, user must match the targeting rules\n */\nexport function isNew(\n  feature: FeatureEntry,\n  watermark: string | null,\n  dismissedIds: ReadonlySet<string>,\n  now: Date = new Date(),\n  userContext?: UserContext,\n  matchAudience?: AudienceMatchFn,\n  appVersion?: string,\n  dependencyState?: FeatureDependencyState,\n  triggerContext?: TriggerContext,\n): boolean {\n  // Already dismissed by the user on this device\n  if (dismissedIds.has(feature.id)) return false;\n\n  // Audience targeting — check before time-based checks\n  if (!isAudienceMatch(feature, userContext, matchAudience)) return false;\n\n  // Dependency targeting — defer features until prerequisites are satisfied\n  if (!isDependencyMatch(feature, dismissedIds, dependencyState)) return false;\n\n  // Version targeting — requires appVersion when constraints exist\n  if (!isVersionMatch(feature, appVersion)) return false;\n\n  // Contextual trigger rules — show only when trigger condition is satisfied.\n  if (!isTriggerMatch(feature.trigger, triggerContext)) return false;\n\n  const nowMs = now.getTime();\n\n  // Scheduled publishing — hidden until publishAt\n  if (feature.publishAt) {\n    const publishMs = new Date(feature.publishAt).getTime();\n    if (nowMs < publishMs) return false;\n  }\n\n  const showUntilMs = new Date(feature.showNewUntil).getTime();\n\n  // Past the display window\n  if (nowMs >= showUntilMs) return false;\n\n  // If there's a watermark, feature must have been released after it\n  if (watermark) {\n    const watermarkMs = new Date(watermark).getTime();\n    const releasedMs = new Date(feature.releasedAt).getTime();\n    if (releasedMs <= watermarkMs) return false;\n  }\n\n  return true;\n}\n\n/**\n * Get all features that are currently \"new\" for this user.\n */\nexport function getNewFeatures(\n  manifest: FeatureManifest,\n  storage: StorageAdapter,\n  now: Date = new Date(),\n  userContext?: UserContext,\n  matchAudience?: AudienceMatchFn,\n  appVersion?: string,\n  dependencyState?: FeatureDependencyState,\n  triggerContext?: TriggerContext,\n): FeatureEntry[] {\n  const watermark = storage.getWatermark();\n  const dismissedIds = storage.getDismissedIds();\n  return manifest.filter((f) =>\n    isNew(\n      f,\n      watermark,\n      dismissedIds,\n      now,\n      userContext,\n      matchAudience,\n      appVersion,\n      dependencyState,\n      triggerContext,\n    ),\n  );\n}\n\n/**\n * Get the count of new features.\n */\nexport function getNewFeatureCount(\n  manifest: FeatureManifest,\n  storage: StorageAdapter,\n  now: Date = new Date(),\n  userContext?: UserContext,\n  matchAudience?: AudienceMatchFn,\n  appVersion?: string,\n  dependencyState?: FeatureDependencyState,\n  triggerContext?: TriggerContext,\n): number {\n  return getNewFeatures(\n    manifest,\n    storage,\n    now,\n    userContext,\n    matchAudience,\n    appVersion,\n    dependencyState,\n    triggerContext,\n  ).length;\n}\n\n/**\n * Check if a specific sidebar key has a new feature.\n */\nexport function hasNewFeature(\n  manifest: FeatureManifest,\n  sidebarKey: string,\n  storage: StorageAdapter,\n  now: Date = new Date(),\n  userContext?: UserContext,\n  matchAudience?: AudienceMatchFn,\n  appVersion?: string,\n  dependencyState?: FeatureDependencyState,\n  triggerContext?: TriggerContext,\n): boolean {\n  const watermark = storage.getWatermark();\n  const dismissedIds = storage.getDismissedIds();\n  return manifest.some(\n    (f) =>\n      f.sidebarKey === sidebarKey &&\n      isNew(\n        f,\n        watermark,\n        dismissedIds,\n        now,\n        userContext,\n        matchAudience,\n        appVersion,\n        dependencyState,\n        triggerContext,\n      ),\n  );\n}\n\n/**\n * Get all features sorted by priority (critical first) then by release date (newest first).\n */\nexport function getNewFeaturesSorted(\n  manifest: FeatureManifest,\n  storage: StorageAdapter,\n  now: Date = new Date(),\n  userContext?: UserContext,\n  matchAudience?: AudienceMatchFn,\n  appVersion?: string,\n  dependencyState?: FeatureDependencyState,\n  triggerContext?: TriggerContext,\n): FeatureEntry[] {\n  const priorityOrder = { critical: 0, normal: 1, low: 2 };\n  return getNewFeatures(\n    manifest,\n    storage,\n    now,\n    userContext,\n    matchAudience,\n    appVersion,\n    dependencyState,\n    triggerContext,\n  ).sort(\n    (a, b) => {\n      const pa = priorityOrder[a.priority ?? \"normal\"];\n      const pb = priorityOrder[b.priority ?? \"normal\"];\n      if (pa !== pb) return pa - pb;\n      return (\n        new Date(b.releasedAt).getTime() - new Date(a.releasedAt).getTime()\n      );\n    },\n  );\n}\n","import { getNewFeatures, hasNewFeature } from \"../core\";\nimport type {\n  AnalyticsCallbacks,\n  AudienceMatchFn,\n  FeatureEntry,\n  FeatureManifest,\n  StorageAdapter,\n  UserContext,\n} from \"../types\";\n\nexport interface SignalLike<T> {\n  (): T;\n  set: (value: T) => void;\n}\n\nexport type CreateSignalLikeFn = <T>(initial: T) => SignalLike<T>;\n\nexport interface AngularFeatureDropOptions {\n  manifest: FeatureManifest;\n  storage: StorageAdapter;\n  createSignal: CreateSignalLikeFn;\n  analytics?: AnalyticsCallbacks;\n  userContext?: UserContext;\n  matchAudience?: AudienceMatchFn;\n  appVersion?: string;\n}\n\nexport interface AngularFeatureDropService {\n  manifest: FeatureManifest;\n  newFeatures: SignalLike<FeatureEntry[]>;\n  newCount: () => number;\n  newFeaturesSorted: () => FeatureEntry[];\n  refresh: () => void;\n  dismiss: (id: string) => void;\n  dismissAll: () => Promise<void>;\n  isNew: (sidebarKey: string) => boolean;\n  getFeature: (sidebarKey: string) => FeatureEntry | undefined;\n}\n\nfunction sortByPriority(features: FeatureEntry[]): FeatureEntry[] {\n  const priorityOrder = { critical: 0, normal: 1, low: 2 };\n  return [...features].sort((a, b) => {\n    const pa = priorityOrder[a.priority ?? \"normal\"];\n    const pb = priorityOrder[b.priority ?? \"normal\"];\n    if (pa !== pb) return pa - pb;\n    return new Date(b.releasedAt).getTime() - new Date(a.releasedAt).getTime();\n  });\n}\n\nexport function createFeatureDropService(\n  options: AngularFeatureDropOptions,\n): AngularFeatureDropService {\n  const computeFeatures = (): FeatureEntry[] =>\n    getNewFeatures(\n      options.manifest,\n      options.storage,\n      new Date(),\n      options.userContext,\n      options.matchAudience,\n      options.appVersion,\n    );\n\n  const newFeatures = options.createSignal(computeFeatures());\n\n  const refresh = (): void => {\n    newFeatures.set(computeFeatures());\n  };\n\n  const dismiss = (id: string): void => {\n    const feature = newFeatures().find((item) => item.id === id);\n    options.storage.dismiss(id);\n    if (feature) {\n      options.analytics?.onFeatureDismissed?.(feature);\n    }\n    refresh();\n  };\n\n  const dismissAll = async (): Promise<void> => {\n    await options.storage.dismissAll(new Date());\n    options.analytics?.onAllDismissed?.();\n    refresh();\n  };\n\n  const newCount = (): number => newFeatures().length;\n\n  const isNew = (sidebarKey: string): boolean =>\n    hasNewFeature(\n      options.manifest,\n      sidebarKey,\n      options.storage,\n      new Date(),\n      options.userContext,\n      options.matchAudience,\n      options.appVersion,\n    );\n\n  const getFeature = (sidebarKey: string): FeatureEntry | undefined =>\n    newFeatures().find((feature) => feature.sidebarKey === sidebarKey);\n\n  return {\n    manifest: options.manifest,\n    newFeatures,\n    newCount,\n    newFeaturesSorted: () => sortByPriority(newFeatures()),\n    refresh,\n    dismiss,\n    dismissAll,\n    isNew,\n    getFeature,\n  };\n}\n\nexport class FeatureDropService {\n  readonly manifest: FeatureManifest;\n  readonly newFeatures: SignalLike<FeatureEntry[]>;\n\n  private readonly service: AngularFeatureDropService;\n\n  constructor(options: AngularFeatureDropOptions) {\n    this.service = createFeatureDropService(options);\n    this.manifest = this.service.manifest;\n    this.newFeatures = this.service.newFeatures;\n  }\n\n  newCount(): number {\n    return this.service.newCount();\n  }\n\n  newFeaturesSorted(): FeatureEntry[] {\n    return this.service.newFeaturesSorted();\n  }\n\n  refresh(): void {\n    this.service.refresh();\n  }\n\n  dismiss(id: string): void {\n    this.service.dismiss(id);\n  }\n\n  dismissAll(): Promise<void> {\n    return this.service.dismissAll();\n  }\n\n  isNew(sidebarKey: string): boolean {\n    return this.service.isNew(sidebarKey);\n  }\n\n  getFeature(sidebarKey: string): FeatureEntry | undefined {\n    return this.service.getFeature(sidebarKey);\n  }\n}\n"]}

package/dist/angular.d.cts

@@ -0,0 +1,229 @@
+/** 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>;
+}
+/** User context for audience targeting */
+interface UserContext {
+    /** Current user's plan (e.g. "pro", "free") */
+    plan?: string;
+    /** Current user's role (e.g. "admin", "viewer") */
+    role?: string;
+    /** Current user's region (e.g. "us", "eu") */
+    region?: string;
+    /** Arbitrary traits for custom matching logic */
+    traits?: Record<string, unknown>;
+}
+/** Custom audience matcher function */
+type AudienceMatchFn = (audience: AudienceRule, userContext: UserContext) => boolean;
+/** 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 URL to link to (e.g. docs page, changelog entry) */
+    url?: 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;
+}
+/** The full feature manifest — an array of feature entries */
+type FeatureManifest = readonly FeatureEntry[];
+/**
+ * Storage adapter interface — implement for your persistence layer.
+ *
+ * The adapter bridges two data sources:
+ * - **Watermark**: a server-side timestamp ("features seen at")
+ * - **Dismissed IDs**: client-side per-feature dismissals
+ */
+interface StorageAdapter {
+    /** Get the user's "features seen at" watermark (ISO string or null) */
+    getWatermark(): string | null;
+    /** Get the set of individually dismissed feature IDs */
+    getDismissedIds(): ReadonlySet<string>;
+    /** Dismiss a single feature by ID */
+    dismiss(id: string): void;
+    /** Dismiss all features — sets watermark to `now` and clears dismissals */
+    dismissAll(now: Date): Promise<void>;
+}
+/** Analytics event callbacks — pipe to your analytics provider */
+interface AnalyticsCallbacks {
+    /** Fired when a feature badge becomes visible to the user */
+    onFeatureSeen?: (feature: FeatureEntry) => void;
+    /** Fired when a user dismisses a single feature */
+    onFeatureDismissed?: (feature: FeatureEntry) => void;
+    /** Fired when a user clicks a feature link or CTA */
+    onFeatureClicked?: (feature: FeatureEntry) => void;
+    /** Fired when the changelog widget is opened */
+    onWidgetOpened?: () => void;
+    /** Fired when the changelog widget is closed */
+    onWidgetClosed?: () => void;
+    /** Fired when all features are dismissed at once */
+    onAllDismissed?: () => void;
+}
+
+interface SignalLike<T> {
+    (): T;
+    set: (value: T) => void;
+}
+type CreateSignalLikeFn = <T>(initial: T) => SignalLike<T>;
+interface AngularFeatureDropOptions {
+    manifest: FeatureManifest;
+    storage: StorageAdapter;
+    createSignal: CreateSignalLikeFn;
+    analytics?: AnalyticsCallbacks;
+    userContext?: UserContext;
+    matchAudience?: AudienceMatchFn;
+    appVersion?: string;
+}
+interface AngularFeatureDropService {
+    manifest: FeatureManifest;
+    newFeatures: SignalLike<FeatureEntry[]>;
+    newCount: () => number;
+    newFeaturesSorted: () => FeatureEntry[];
+    refresh: () => void;
+    dismiss: (id: string) => void;
+    dismissAll: () => Promise<void>;
+    isNew: (sidebarKey: string) => boolean;
+    getFeature: (sidebarKey: string) => FeatureEntry | undefined;
+}
+declare function createFeatureDropService(options: AngularFeatureDropOptions): AngularFeatureDropService;
+declare class FeatureDropService {
+    readonly manifest: FeatureManifest;
+    readonly newFeatures: SignalLike<FeatureEntry[]>;
+    private readonly service;
+    constructor(options: AngularFeatureDropOptions);
+    newCount(): number;
+    newFeaturesSorted(): FeatureEntry[];
+    refresh(): void;
+    dismiss(id: string): void;
+    dismissAll(): Promise<void>;
+    isNew(sidebarKey: string): boolean;
+    getFeature(sidebarKey: string): FeatureEntry | undefined;
+}
+
+export { type AngularFeatureDropOptions, type AngularFeatureDropService, type CreateSignalLikeFn, FeatureDropService, type SignalLike, createFeatureDropService };