@wireai/activation 0.7.0 → 0.9.0

package/src/icons/index.ts

@@ -0,0 +1,18 @@
+/**
+ * The icon module — a named semantic vocabulary the AI emits, resolved to real glyphs through
+ * an OPTIONAL peer, with a host override registry in front and a no-op behind. See
+ * `vocabulary.ts` for the contract and `expoIcons.ts` for why the optional peer honors the
+ * kit's no-forced-native-dependency policy rather than breaking it.
+ */
+export { WireIcon } from "./WireIcon";
+export type { WireIconProps } from "./WireIcon";
+export { IconRegistryProvider, useHostIcon } from "./IconRegistry";
+export type { WireIconRegistry, IconRegistryProviderProps } from "./IconRegistry";
+export {
+  WIRE_ICON_GLYPHS,
+  WIRE_ICON_NAMES,
+  lookupIconGlyph,
+} from "./vocabulary";
+export type { WireIconName, WireIconFamily, WireIconGlyph } from "./vocabulary";
+export { resolveIconFamily, resetIconModuleCache } from "./expoIcons";
+export type { OptionalRequire, IconComponent } from "./expoIcons";

package/src/icons/vocabulary.ts

@@ -0,0 +1,154 @@
+/**
+ * The Wire icon VOCABULARY — the stable, semantic contract between the AI and the kit.
+ *
+ * The model emits a plain semantic string (`"instagram"`, `"friend"`, `"wedding"`), never a
+ * raw icon-library glyph name. That indirection is the whole point:
+ *
+ *   • The model is never coupled to a library version. `@expo/vector-icons` renaming a glyph,
+ *     or a host swapping the library out for brand SVGs, changes THIS map — not the prompt,
+ *     not the server, and not a single stored answer.
+ *   • A host can override any name with its own artwork (see `IconRegistry`), so brand icons
+ *     need no kit change.
+ *   • An unknown name degrades to no icon (see `WireIcon`), which is why the vocabulary can
+ *     grow without a coordinated kit+server release.
+ *
+ * `WIRE_ICON_NAMES` is exported so the server/AI side can be taught the list verbatim — paste
+ * it into the prompt as the allowed `icon` values. Keep names SEMANTIC (what the option means)
+ * rather than visual (what the glyph looks like): the model reasons about meaning.
+ *
+ * Every glyph below was verified to exist in the `@expo/vector-icons` 15.0.3 glyphmaps that
+ * both live host apps already ship. MaterialCommunityIcons is the default family (the broadest
+ * single set); Ionicons covers the few brand logos MCI lacks (TikTok, Discord).
+ */
+
+/** The icon families this kit resolves out of `@expo/vector-icons`. Both are root exports. */
+export type WireIconFamily = "MaterialCommunityIcons" | "Ionicons";
+
+/** One vocabulary entry: the concrete glyph a semantic name resolves to. */
+export interface WireIconGlyph {
+  family: WireIconFamily;
+  /** The library's own glyph name — an INTERNAL detail. The AI never sees or emits this. */
+  name: string;
+}
+
+/**
+ * The semantic name → concrete glyph map. Grouped by the onboarding questions these actually
+ * serve: acquisition channels ("where did you hear about us"), intent/occasion ("what brings
+ * you here"), and a general-purpose set for everything else.
+ */
+export const WIRE_ICON_GLYPHS = {
+  // ── Acquisition channels ("where did you hear about us?") ──────────────────
+  instagram: { family: "MaterialCommunityIcons", name: "instagram" },
+  tiktok: { family: "Ionicons", name: "logo-tiktok" },
+  youtube: { family: "MaterialCommunityIcons", name: "youtube" },
+  facebook: { family: "MaterialCommunityIcons", name: "facebook" },
+  twitter: { family: "MaterialCommunityIcons", name: "twitter" },
+  reddit: { family: "MaterialCommunityIcons", name: "reddit" },
+  linkedin: { family: "MaterialCommunityIcons", name: "linkedin" },
+  discord: { family: "Ionicons", name: "logo-discord" },
+  whatsapp: { family: "MaterialCommunityIcons", name: "whatsapp" },
+  twitch: { family: "MaterialCommunityIcons", name: "twitch" },
+  snapchat: { family: "MaterialCommunityIcons", name: "snapchat" },
+  pinterest: { family: "MaterialCommunityIcons", name: "pinterest" },
+  google: { family: "MaterialCommunityIcons", name: "google" },
+  search: { family: "MaterialCommunityIcons", name: "magnify" },
+  friend: { family: "MaterialCommunityIcons", name: "account-heart" },
+  podcast: { family: "MaterialCommunityIcons", name: "podcast" },
+  blog: { family: "MaterialCommunityIcons", name: "post" },
+  newsletter: { family: "MaterialCommunityIcons", name: "email-outline" },
+  news: { family: "MaterialCommunityIcons", name: "newspaper" },
+  "app-store": { family: "MaterialCommunityIcons", name: "apple" },
+  ad: { family: "MaterialCommunityIcons", name: "bullhorn" },
+
+  // ── Intent / occasion ("what brings you here?") ────────────────────────────
+  wedding: { family: "MaterialCommunityIcons", name: "ring" },
+  birthday: { family: "MaterialCommunityIcons", name: "cake-variant" },
+  baby: { family: "MaterialCommunityIcons", name: "baby-carriage" },
+  travel: { family: "MaterialCommunityIcons", name: "airplane" },
+  work: { family: "MaterialCommunityIcons", name: "briefcase" },
+  celebration: { family: "MaterialCommunityIcons", name: "party-popper" },
+  store: { family: "MaterialCommunityIcons", name: "storefront" },
+  school: { family: "MaterialCommunityIcons", name: "school" },
+  team: { family: "MaterialCommunityIcons", name: "account-multiple" },
+  growth: { family: "MaterialCommunityIcons", name: "trending-up" },
+
+  // ── General purpose ────────────────────────────────────────────────────────
+  sparkle: { family: "MaterialCommunityIcons", name: "star-four-points" },
+  heart: { family: "MaterialCommunityIcons", name: "heart" },
+  star: { family: "MaterialCommunityIcons", name: "star" },
+  fire: { family: "MaterialCommunityIcons", name: "fire" },
+  target: { family: "MaterialCommunityIcons", name: "target" },
+  trophy: { family: "MaterialCommunityIcons", name: "trophy" },
+  rocket: { family: "MaterialCommunityIcons", name: "rocket-launch" },
+  clock: { family: "MaterialCommunityIcons", name: "clock-outline" },
+  calendar: { family: "MaterialCommunityIcons", name: "calendar-star" },
+  camera: { family: "MaterialCommunityIcons", name: "camera" },
+  image: { family: "MaterialCommunityIcons", name: "image" },
+  video: { family: "MaterialCommunityIcons", name: "video" },
+  mic: { family: "MaterialCommunityIcons", name: "microphone" },
+  music: { family: "MaterialCommunityIcons", name: "music" },
+  book: { family: "MaterialCommunityIcons", name: "book-open-variant" },
+  food: { family: "MaterialCommunityIcons", name: "silverware-fork-knife" },
+  coffee: { family: "MaterialCommunityIcons", name: "coffee" },
+  fitness: { family: "MaterialCommunityIcons", name: "dumbbell" },
+  health: { family: "MaterialCommunityIcons", name: "heart-pulse" },
+  meditation: { family: "MaterialCommunityIcons", name: "meditation" },
+  sleep: { family: "MaterialCommunityIcons", name: "sleep" },
+  brain: { family: "MaterialCommunityIcons", name: "brain" },
+  idea: { family: "MaterialCommunityIcons", name: "lightbulb-on" },
+  money: { family: "MaterialCommunityIcons", name: "cash" },
+  shopping: { family: "MaterialCommunityIcons", name: "cart" },
+  gift: { family: "MaterialCommunityIcons", name: "gift" },
+  home: { family: "MaterialCommunityIcons", name: "home" },
+  car: { family: "MaterialCommunityIcons", name: "car" },
+  pet: { family: "MaterialCommunityIcons", name: "paw" },
+  plant: { family: "MaterialCommunityIcons", name: "sprout" },
+  sun: { family: "MaterialCommunityIcons", name: "white-balance-sunny" },
+  moon: { family: "MaterialCommunityIcons", name: "weather-night" },
+  globe: { family: "MaterialCommunityIcons", name: "earth" },
+  "map-pin": { family: "MaterialCommunityIcons", name: "map-marker" },
+  compass: { family: "MaterialCommunityIcons", name: "compass" },
+  flag: { family: "MaterialCommunityIcons", name: "flag" },
+  bookmark: { family: "MaterialCommunityIcons", name: "bookmark" },
+  bell: { family: "MaterialCommunityIcons", name: "bell" },
+  mail: { family: "MaterialCommunityIcons", name: "email" },
+  phone: { family: "MaterialCommunityIcons", name: "phone" },
+  chat: { family: "MaterialCommunityIcons", name: "chat" },
+  user: { family: "MaterialCommunityIcons", name: "account" },
+  users: { family: "MaterialCommunityIcons", name: "account-group" },
+  settings: { family: "MaterialCommunityIcons", name: "cog" },
+  tools: { family: "MaterialCommunityIcons", name: "tools" },
+  puzzle: { family: "MaterialCommunityIcons", name: "puzzle" },
+  chart: { family: "MaterialCommunityIcons", name: "chart-line" },
+  shield: { family: "MaterialCommunityIcons", name: "shield-check" },
+  lock: { family: "MaterialCommunityIcons", name: "lock" },
+  cloud: { family: "MaterialCommunityIcons", name: "cloud" },
+  pencil: { family: "MaterialCommunityIcons", name: "pencil" },
+  check: { family: "MaterialCommunityIcons", name: "check-circle" },
+  plus: { family: "MaterialCommunityIcons", name: "plus-circle" },
+  question: { family: "MaterialCommunityIcons", name: "help-circle" },
+  other: { family: "MaterialCommunityIcons", name: "dots-horizontal-circle" },
+} as const satisfies Record<string, WireIconGlyph>;
+
+/** A name in the vocabulary. The card schemas accept any string and degrade — see `WireIcon`. */
+export type WireIconName = keyof typeof WIRE_ICON_GLYPHS;
+
+/**
+ * Every semantic name, as a plain array — the list to paste into the server/AI prompt as the
+ * allowed `icon` values. Sorted for a stable, diffable prompt.
+ */
+export const WIRE_ICON_NAMES: readonly string[] = Object.keys(WIRE_ICON_GLYPHS).sort();
+
+/**
+ * Look up a semantic name. Returns undefined for anything outside the vocabulary.
+ *
+ * The OWN-property check is load-bearing, not defensive noise: the name comes from an LLM, and
+ * a plain object lookup answers `"toString"` / `"constructor"` / `"valueOf"` with an inherited
+ * `Object.prototype` member. That would hand back a function where a `{family, name}` is
+ * expected — a non-glyph masquerading as one. Caught by the vocabulary canary.
+ */
+export const lookupIconGlyph = (name: string | undefined): WireIconGlyph | undefined => {
+  if (!name) return undefined;
+  if (!Object.prototype.hasOwnProperty.call(WIRE_ICON_GLYPHS, name)) return undefined;
+  return (WIRE_ICON_GLYPHS as Record<string, WireIconGlyph>)[name];
+};

package/src/index.ts

@@ -52,11 +52,31 @@ export {
   ChipSelectCard,
   TextInputCard,
   SelectionCard,
+  CardGridSelectCard,
   StatusCard,
   NumberStepperCard,
   InterstitialCard,
   onboardingComponents,
 } from "./cards";
+export type { CardOption } from "./cards";
+
+// ─── Icons (semantic vocabulary → optional @expo/vector-icons → nothing) ──────
+// WIRE_ICON_NAMES is the list to paste into the server/AI prompt as the allowed `icon` values.
+export {
+  WireIcon,
+  IconRegistryProvider,
+  useHostIcon,
+  WIRE_ICON_GLYPHS,
+  WIRE_ICON_NAMES,
+  lookupIconGlyph,
+} from "./icons";
+export type {
+  WireIconProps,
+  WireIconRegistry,
+  WireIconName,
+  WireIconFamily,
+  WireIconGlyph,
+} from "./icons";
 
 // ─── Flow internals (advanced) ────────────────────────────────────────────────
 export { OnboardingFlow } from "./OnboardingFlow";
@@ -118,6 +138,7 @@ export type { OnboardingAttribution } from "./attribution/attribution";
 export { collectDeviceContext } from "./device/deviceContext";
 export type { DeviceContext, DeviceFormFactor } from "./device/deviceContext";
 export { detectAppVersion } from "./device/appVersion";
+export { detectNativeModel } from "./device/deviceModel";
 
 // ─── User identity (opaque pseudonymous id; late binding, dependency-free) ────
 export { identifyOnboarding, sanitizeUserId, USER_ID_MAX_LENGTH } from "./identity/userIdentity";
@@ -137,6 +158,7 @@ export type {
   ResolvedUserContext,
   ResolveUserContextOptions,
 } from "./context/userContext";
+export { mintDeviceId, deviceIdStorageKey, AUTO_DEVICE_ID_PREFIX } from "./context/deviceId";
 
 // ─── Current per-open session registry (identify/app-events reuse the live session) ───
 export {