ffdev 0.0.0

package/dist/bar/index.d.ts

@@ -0,0 +1,22 @@
+import { FlagDef } from '../core/flag-def.js';
+import { Store } from '../core/store.js';
+export declare const BAR_SENTINEL = "__FFDEV_BAR_SENTINEL__";
+export interface BarController {
+    mount(): void;
+    unmount(): void;
+}
+export declare function mountBar(isDev?: boolean): BarController;
+declare global {
+    interface Window {
+        __FFDEV__?: {
+            open(): void;
+            close(): void;
+            setFlag(name: string, value: unknown): void;
+            getFlags(): Record<string, unknown>;
+            status(): string;
+            refetchRemote(): Promise<void>;
+        };
+    }
+}
+export declare function attachGlobalApi(store: Store, defs: Record<string, FlagDef<unknown>>, bar: BarController): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/bar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bar/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,YAAY,2BAA2B,CAAC;AAErD,MAAM,WAAW,aAAa;IAC7B,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,aAAa,CA4BvD;AAED,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,SAAS,CAAC,EAAE;YACX,IAAI,IAAI,IAAI,CAAC;YACb,KAAK,IAAI,IAAI,CAAC;YACd,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;YAC5C,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACpC,MAAM,IAAI,MAAM,CAAC;YACjB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;SAC/B,CAAC;KACF;CACD;AAED,wBAAgB,eAAe,CAC9B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,EACtC,GAAG,EAAE,aAAa,GAChB,IAAI,CA6BN"}

package/dist/core/flag-def.d.ts

@@ -0,0 +1,17 @@
+export interface FlagDef<V> {
+    readonly kind: 'boolean' | 'enum';
+    readonly defaultValue: V;
+    validate(value: unknown): value is V;
+}
+declare function booleanFlag(opts: {
+    default: boolean;
+}): FlagDef<boolean>;
+declare function enumFlag<const T extends readonly string[]>(variants: T, opts: {
+    default: T[number];
+}): FlagDef<T[number]>;
+export declare const flag: {
+    readonly boolean: typeof booleanFlag;
+    readonly enum: typeof enumFlag;
+};
+export {};
+//# sourceMappingURL=flag-def.d.ts.map

package/dist/core/flag-def.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-def.d.ts","sourceRoot":"","sources":["../../src/core/flag-def.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO,CAAC,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC;CACrC;AAED,iBAAS,WAAW,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAQjE;AAED,iBAAS,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EAClD,QAAQ,EAAE,CAAC,EACX,IAAI,EAAE;IAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;CAAE,GAC1B,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CASpB;AAED,eAAO,MAAM,IAAI;;;CAGP,CAAC"}

package/dist/core/local-source.d.ts

@@ -0,0 +1,9 @@
+import { Source } from './source.js';
+export declare class LocalSource implements Source {
+    private readonly prefix;
+    constructor(namespace: string);
+    read(flagName: string): unknown | undefined;
+    write(flagName: string, value: unknown | undefined): void;
+    subscribe(listener: () => void): () => void;
+}
+//# sourceMappingURL=local-source.d.ts.map

package/dist/core/local-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-source.d.ts","sourceRoot":"","sources":["../../src/core/local-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,qBAAa,WAAY,YAAW,MAAM;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,SAAS,EAAE,MAAM;IAI7B,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAU3C,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IASzD,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;CAS3C"}

package/dist/core/query-source.d.ts

@@ -0,0 +1,9 @@
+import { FlagDef } from './flag-def.js';
+import { Source } from './source.js';
+export declare class QuerySource implements Source {
+    private namespace;
+    private getSearchParams;
+    constructor(namespace: string, getSearchParams: () => URLSearchParams);
+    read(flagName: string, def: FlagDef<unknown>): unknown | undefined;
+}
+//# sourceMappingURL=query-source.d.ts.map

package/dist/core/query-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-source.d.ts","sourceRoot":"","sources":["../../src/core/query-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,qBAAa,WAAY,YAAW,MAAM;IAExC,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,eAAe;gBADf,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,eAAe;IAG/C,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS;CAmBlE"}

package/dist/core/remote-source.d.ts

@@ -0,0 +1,11 @@
+import { FlagDef } from './flag-def.js';
+import { Source } from './source.js';
+export type RemoteConfig = string | (() => Promise<Record<string, unknown>>);
+export declare class RemoteSource implements Source {
+    private cache;
+    private fetcher;
+    constructor(config: RemoteConfig);
+    read(flagName: string, _def: FlagDef<unknown>): unknown | undefined;
+    fetch(): Promise<void>;
+}
+//# sourceMappingURL=remote-source.d.ts.map

package/dist/core/remote-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-source.d.ts","sourceRoot":"","sources":["../../src/core/remote-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7E,qBAAa,YAAa,YAAW,MAAM;IAC1C,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,OAAO,CAAyC;gBAE5C,MAAM,EAAE,YAAY;IAWhC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS;IAI7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK5B"}

package/dist/core/resolver.d.ts

@@ -0,0 +1,4 @@
+import { FlagDef } from './flag-def.js';
+import { Source } from './source.js';
+export declare function resolve<V>(flagName: string, def: FlagDef<V>, sources: readonly Source[]): V;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/core/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/core/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,wBAAgB,OAAO,CAAC,CAAC,EACxB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EACf,OAAO,EAAE,SAAS,MAAM,EAAE,GACxB,CAAC,CAQH"}

package/dist/core/source.d.ts

@@ -0,0 +1,11 @@
+import { FlagDef } from './flag-def.js';
+export interface Source {
+    read(flagName: string, def: FlagDef<unknown>): unknown | undefined;
+    subscribe?(listener: () => void): () => void;
+}
+export declare class DefaultSource implements Source {
+    private defs;
+    constructor(defs: Record<string, FlagDef<unknown>>);
+    read(flagName: string): unknown | undefined;
+}
+//# sourceMappingURL=source.d.ts.map

package/dist/core/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/core/source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,MAAM;IACtB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC;IACnE,SAAS,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7C;AAED,qBAAa,aAAc,YAAW,MAAM;IAC/B,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1D,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;CAI3C"}

package/dist/core/store.d.ts

@@ -0,0 +1,16 @@
+import { FlagDef } from './flag-def.js';
+import { LocalSource } from './local-source.js';
+import { RemoteSource } from './remote-source.js';
+import { Source } from './source.js';
+export type Status = 'idle' | 'loading' | 'ready' | 'error';
+export interface Store {
+    getSnapshot(): Record<string, unknown>;
+    getFlagSnapshot(flagName: string): unknown;
+    subscribe(listener: () => void): () => void;
+    getStatus(): Status;
+    notify(): void;
+    setLocal(flagName: string, value: unknown | undefined): void;
+    refetchRemote(): Promise<void>;
+}
+export declare function createStore(defs: Record<string, FlagDef<unknown>>, sources: readonly Source[], localSource?: LocalSource, remote?: RemoteSource): Store;
+//# sourceMappingURL=store.d.ts.map

package/dist/core/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/core/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5D,MAAM,WAAW,KAAK;IACrB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3C,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,SAAS,IAAI,MAAM,CAAC;IACpB,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;IAC7D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,wBAAgB,WAAW,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,EACtC,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,WAAW,CAAC,EAAE,WAAW,EACzB,MAAM,CAAC,EAAE,YAAY,GACnB,KAAK,CA6EP"}

package/dist/create-ffdev-B2ww_7Y1.js

@@ -0,0 +1,170 @@
+var y = Object.defineProperty;
+var F = (r, e, t) => e in r ? y(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
+var S = (r, e, t) => F(r, typeof e != "symbol" ? e + "" : e, t);
+import { useSyncExternalStore as g } from "react";
+import { QuerySource as x } from "./index.js";
+class L {
+  constructor(e) {
+    S(this, "prefix");
+    this.prefix = `${e}:`;
+  }
+  read(e) {
+    const t = localStorage.getItem(this.prefix + e);
+    if (t !== null)
+      try {
+        return JSON.parse(t);
+      } catch {
+        return;
+      }
+  }
+  write(e, t) {
+    const n = this.prefix + e;
+    t === void 0 ? localStorage.removeItem(n) : localStorage.setItem(n, JSON.stringify(t));
+  }
+  subscribe(e) {
+    const t = (n) => {
+      var c;
+      (c = n.key) != null && c.startsWith(this.prefix) && e();
+    };
+    return window.addEventListener("storage", t), () => window.removeEventListener("storage", t);
+  }
+}
+class P {
+  constructor(e) {
+    S(this, "cache");
+    S(this, "fetcher");
+    this.fetcher = typeof e == "string" ? () => fetch(e).then((t) => {
+      if (!t.ok) throw new Error(`HTTP ${t.status}`);
+      return t.json();
+    }) : e;
+  }
+  read(e, t) {
+    var n;
+    return (n = this.cache) == null ? void 0 : n[e];
+  }
+  async fetch() {
+    this.cache = void 0;
+    const e = await this.fetcher();
+    this.cache = e;
+  }
+}
+class R {
+  constructor(e) {
+    this.defs = e;
+  }
+  read(e) {
+    const t = this.defs[e];
+    return t == null ? void 0 : t.defaultValue;
+  }
+}
+function k(r, e, t) {
+  for (const n of t) {
+    const c = n.read(r, e);
+    if (c !== void 0 && e.validate(c))
+      return c;
+  }
+  return e.defaultValue;
+}
+function D(r, e, t, n) {
+  const c = /* @__PURE__ */ new Set();
+  let h = l();
+  const u = { ...h };
+  let f = n ? "loading" : "idle";
+  function l() {
+    const s = {};
+    for (const o of Object.keys(r))
+      s[o] = k(o, r[o], e);
+    return s;
+  }
+  function i() {
+    const s = l();
+    for (const o of Object.keys(s))
+      s[o] !== u[o] && (u[o] = s[o]);
+    h = s;
+    for (const o of c)
+      o();
+  }
+  function d(s) {
+    return s.fetch().then(
+      () => {
+        f = "ready", i();
+      },
+      (o) => {
+        console.warn("[ffdev] Remote fetch failed:", o), f = "error", i();
+      }
+    );
+  }
+  n && d(n);
+  function a() {
+    return n ? (f = "loading", i(), d(n)) : Promise.resolve();
+  }
+  return {
+    getSnapshot() {
+      return h;
+    },
+    getFlagSnapshot(s) {
+      return u[s];
+    },
+    subscribe(s) {
+      return c.add(s), () => {
+        c.delete(s);
+      };
+    },
+    getStatus() {
+      return f;
+    },
+    notify: i,
+    setLocal(s, o) {
+      t && (t.write(s, o), i());
+    },
+    refetchRemote: a
+  };
+}
+const E = () => new URL(window.location.href).searchParams;
+function I(r, e) {
+  const { flags: t } = r, n = r.namespace ?? "ffdev", { remote: c } = r, h = (e == null ? void 0 : e.getSearchParams) ?? E, u = new L(n), f = new x(n, h), l = c ? new P(c) : void 0, i = new R(t), d = [
+    f,
+    u,
+    ...l ? [l] : [],
+    i
+  ], a = D(t, d, u, l);
+  u.subscribe(() => a.notify());
+  function s(m) {
+    return g(
+      a.subscribe,
+      () => a.getFlagSnapshot(m)
+    );
+  }
+  function o() {
+    return g(
+      a.subscribe,
+      () => a.getSnapshot()
+    );
+  }
+  function w(m, b) {
+    a.setLocal(m, b);
+  }
+  function p() {
+    return g(a.subscribe, () => a.getStatus());
+  }
+  function v() {
+    return a.refetchRemote();
+  }
+  return {
+    useFlag: s,
+    useFlags: o,
+    setFlag: w,
+    useFFDevStatus: p,
+    refetchRemote: v,
+    store: a,
+    defs: t
+  };
+}
+function N(r, e) {
+  const { store: t, defs: n, ...c } = I(r, e);
+  return c;
+}
+export {
+  I as a,
+  N as c
+};

package/dist/entries/react-headless.d.ts

@@ -0,0 +1,5 @@
+export { defineConfig, flag, QuerySource } from '../index.js';
+export type { FlagDef, Source } from '../index.js';
+export { createFFDev } from '../react/create-ffdev.js';
+export type { FFDevOptions } from '../react/create-ffdev.js';
+//# sourceMappingURL=react-headless.d.ts.map

package/dist/entries/react-headless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-headless.d.ts","sourceRoot":"","sources":["../../src/entries/react-headless.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/entries/react-headless.js

@@ -0,0 +1,8 @@
+import { QuerySource as o, defineConfig as f, flag as a } from "../index.js";
+import { c as t } from "../create-ffdev-B2ww_7Y1.js";
+export {
+  o as QuerySource,
+  t as createFFDev,
+  f as defineConfig,
+  a as flag
+};

package/dist/entries/react.d.ts

@@ -0,0 +1,16 @@
+import { BAR_SENTINEL, mountBar } from '../bar/index.js';
+import { FFDevConfig, FFDevOptions } from '../react/create-ffdev.js';
+export { defineConfig, flag, QuerySource } from '../index.js';
+export type { FlagDef, Source } from '../index.js';
+export type { FFDevOptions };
+export { BAR_SENTINEL, mountBar };
+export declare function createFFDev<C extends FFDevConfig>(config: C, options?: FFDevOptions): {
+    useFlag: <K extends keyof C["flags"] & string>(name: K) => C["flags"][K] extends infer T ? T extends C["flags"][K] ? T extends import('./react.js').FlagDef<infer V> ? V : never : never : never;
+    useFlags: () => C["flags"] extends infer T extends {
+        [x: string]: import('./react.js').FlagDef<unknown>;
+    } ? { [K in keyof T]: T[K] extends infer T_1 ? T_1 extends T[K] ? T_1 extends import('./react.js').FlagDef<infer V> ? V : never : never : never; } : never;
+    setFlag: <K extends keyof C["flags"] & string>(name: K, value: (C["flags"][K] extends infer T ? T extends C["flags"][K] ? T extends import('./react.js').FlagDef<infer V> ? V : never : never : never) | undefined) => void;
+    useFFDevStatus: () => import('../core/store.js').Status;
+    refetchRemote: () => Promise<void>;
+};
+//# sourceMappingURL=react.d.ts.map

package/dist/entries/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/entries/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAmB,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,YAAY,EAEjB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,YAAY,EAAE,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;AAElC,wBAAgB,WAAW,CAAC,CAAC,SAAS,WAAW,EAChD,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,YAAY;;;;;;;;EAMtB"}

package/dist/entries/react.js

@@ -0,0 +1,56 @@
+import { QuerySource as _, defineConfig as m, flag as v } from "../index.js";
+import { a as f } from "../create-ffdev-B2ww_7Y1.js";
+const c = "__FFDEV_BAR_SENTINEL__";
+function i(n) {
+  const r = n ?? (typeof process < "u" ? process.env.NODE_ENV !== "production" : !0);
+  let t = null;
+  function e() {
+    t || (t = document.createElement("div"), t.setAttribute("data-ffdev-bar", c), t.textContent = "ffdev bar [stub]", document.body.appendChild(t));
+  }
+  function o() {
+    t && (t.remove(), t = null);
+  }
+  return r && e(), { mount: e, unmount: o };
+}
+function a(n, r, t) {
+  window.__FFDEV__ = {
+    open() {
+      t.mount();
+    },
+    close() {
+      t.unmount();
+    },
+    setFlag(e, o) {
+      if (!(e in r)) {
+        console.warn(`[ffdev] Unknown flag: "${e}"`);
+        return;
+      }
+      if (o !== void 0 && !r[e].validate(o)) {
+        console.warn(`[ffdev] Invalid value for flag "${e}":`, o);
+        return;
+      }
+      n.setLocal(e, o);
+    },
+    getFlags() {
+      return n.getSnapshot();
+    },
+    status() {
+      return n.getStatus();
+    },
+    refetchRemote() {
+      return n.refetchRemote();
+    }
+  };
+}
+function l(n, r) {
+  const { store: t, defs: e, ...o } = f(n, r), u = i();
+  return a(t, e, u), o;
+}
+export {
+  c as BAR_SENTINEL,
+  _ as QuerySource,
+  l as createFFDev,
+  m as defineConfig,
+  v as flag,
+  i as mountBar
+};

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import { FlagDef } from './core/flag-def.js';
+import { RemoteConfig } from './core/remote-source.js';
+export { flag } from './core/flag-def.js';
+export type { FlagDef } from './core/flag-def.js';
+export type { Source } from './core/source.js';
+export { QuerySource } from './core/query-source.js';
+interface FFDevConfig {
+    namespace?: string;
+    remote?: RemoteConfig;
+    flags: Record<string, FlagDef<unknown>>;
+}
+export declare function defineConfig<C extends FFDevConfig>(config: C): C;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,UAAU,WAAW;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;CACxC;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAEhE"}

package/dist/index.js

@@ -0,0 +1,45 @@
+function u(t) {
+  return {
+    kind: "boolean",
+    defaultValue: t.default,
+    validate(e) {
+      return typeof e == "boolean";
+    }
+  };
+}
+function i(t, e) {
+  const n = new Set(t);
+  return {
+    kind: "enum",
+    defaultValue: e.default,
+    validate(a) {
+      return typeof a == "string" && n.has(a);
+    }
+  };
+}
+const l = {
+  boolean: u,
+  enum: i
+};
+class s {
+  constructor(e, n) {
+    this.namespace = e, this.getSearchParams = n;
+  }
+  read(e, n) {
+    const a = this.getSearchParams(), o = `${this.namespace}.${e}`, r = a.get(o);
+    if (r !== null) {
+      if (n.kind === "boolean")
+        return r === "true" ? !0 : r === "false" ? !1 : void 0;
+      if (n.kind === "enum")
+        return n.validate(r) ? r : void 0;
+    }
+  }
+}
+function f(t) {
+  return t;
+}
+export {
+  s as QuerySource,
+  f as defineConfig,
+  l as flag
+};

package/dist/react/create-ffdev.d.ts

@@ -0,0 +1,34 @@
+import { FlagDef } from '../core/flag-def.js';
+import { RemoteConfig } from '../core/remote-source.js';
+import { Status } from '../core/store.js';
+type FlagsConfig = Record<string, FlagDef<unknown>>;
+type FlagValue<F> = F extends FlagDef<infer V> ? V : never;
+type FlagsSnapshot<F extends FlagsConfig> = {
+    [K in keyof F]: FlagValue<F[K]>;
+};
+export interface FFDevConfig {
+    namespace?: string;
+    remote?: RemoteConfig;
+    flags: FlagsConfig;
+}
+export interface FFDevOptions {
+    getSearchParams?: () => URLSearchParams;
+}
+export declare function createFFDevInternal<C extends FFDevConfig>(config: C, options?: FFDevOptions): {
+    useFlag: <K extends keyof C["flags"] & string>(name: K) => FlagValue<C["flags"][K]>;
+    useFlags: () => FlagsSnapshot<C["flags"]>;
+    setFlag: <K extends keyof C["flags"] & string>(name: K, value: FlagValue<C["flags"][K]> | undefined) => void;
+    useFFDevStatus: () => Status;
+    refetchRemote: () => Promise<void>;
+    store: import('../core/store.js').Store;
+    defs: FlagsConfig;
+};
+export declare function createFFDev<C extends FFDevConfig>(config: C, options?: FFDevOptions): {
+    useFlag: <K extends keyof C["flags"] & string>(name: K) => FlagValue<C["flags"][K]>;
+    useFlags: () => FlagsSnapshot<C["flags"]>;
+    setFlag: <K extends keyof C["flags"] & string>(name: K, value: FlagValue<C["flags"][K]> | undefined) => void;
+    useFFDevStatus: () => Status;
+    refetchRemote: () => Promise<void>;
+};
+export {};
+//# sourceMappingURL=create-ffdev.d.ts.map

package/dist/react/create-ffdev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-ffdev.d.ts","sourceRoot":"","sources":["../../src/react/create-ffdev.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,KAAK,MAAM,EAAe,MAAM,kBAAkB,CAAC;AAE5D,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AAEpD,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE3D,KAAK,aAAa,CAAC,CAAC,SAAS,WAAW,IAAI;KAC1C,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,WAAW,WAAW;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC5B,eAAe,CAAC,EAAE,MAAM,eAAe,CAAC;CACxC;AAKD,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,WAAW,EACxD,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,YAAY;cAsBL,CAAC,SAAS,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,MAAM,QAC7C,CAAC,KACL,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;oBAON,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;cAO7B,CAAC,SAAS,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,MAAM,QAC7C,CAAC,SACA,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,KACzC,IAAI;0BAIoB,MAAM;yBAIP,OAAO,CAAC,IAAI,CAAC;;;EAavC;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,WAAW,EAChD,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,YAAY;cA5CL,CAAC;;cAgBD,CAAC,6FAGf,IAAI;0BAIoB,MAAM;yBAIP,OAAO,CAAC,IAAI,CAAC;EAqBvC"}

package/dist/react/create-ffdev.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-ffdev.test.d.ts.map

package/dist/react/create-ffdev.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-ffdev.test.d.ts","sourceRoot":"","sources":["../../src/react/create-ffdev.test.tsx"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "ffdev",
+  "version": "0.0.0",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/entries/react.d.ts",
+      "import": "./dist/entries/react.js"
+    },
+    "./react/headless": {
+      "types": "./dist/entries/react-headless.d.ts",
+      "import": "./dist/entries/react-headless.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.14",
+    "react": "^19.1.0",
+    "vite": "^6.3.5",
+    "vite-plugin-dts": "^4.5.4"
+  }
+}