@toyz/loom-flags 0.1.0

package/dist/events.d.ts

@@ -0,0 +1,15 @@
+/**
+ * LoomFlags — FlagChanged event
+ *
+ * Dispatched on the Loom bus when a flag's state changes.
+ * Consumed by @flag decorators and <loom-flag> components
+ * to reactively update the UI.
+ */
+import { LoomEvent } from "@toyz/loom";
+export declare class FlagChanged extends LoomEvent {
+    readonly flag: string;
+    readonly enabled: boolean;
+    readonly variant?: string | undefined;
+    constructor(flag: string, enabled: boolean, variant?: string | undefined);
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,qBAAa,WAAY,SAAQ,SAAS;aAEtB,IAAI,EAAE,MAAM;aACZ,OAAO,EAAE,OAAO;aAChB,OAAO,CAAC,EAAE,MAAM;gBAFhB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,YAAA;CAInC"}

package/dist/events.js

@@ -0,0 +1,20 @@
+/**
+ * LoomFlags — FlagChanged event
+ *
+ * Dispatched on the Loom bus when a flag's state changes.
+ * Consumed by @flag decorators and <loom-flag> components
+ * to reactively update the UI.
+ */
+import { LoomEvent } from "@toyz/loom";
+export class FlagChanged extends LoomEvent {
+    flag;
+    enabled;
+    variant;
+    constructor(flag, enabled, variant) {
+        super();
+        this.flag = flag;
+        this.enabled = enabled;
+        this.variant = variant;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,OAAO,WAAY,SAAQ,SAAS;IAEtB;IACA;IACA;IAHlB,YACkB,IAAY,EACZ,OAAgB,EAChB,OAAgB;QAEhC,KAAK,EAAE,CAAC;QAJQ,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAS;QAChB,YAAO,GAAP,OAAO,CAAS;IAGlC,CAAC;CACF"}

package/dist/flag-component.d.ts

@@ -0,0 +1,24 @@
+/**
+ * LoomFlags — <loom-flag> component
+ *
+ * Conditional rendering via named slots:
+ *
+ * ```tsx
+ * <loom-flag name="beta-feature">
+ *   <new-widget slot="enabled" />
+ *   <span slot="disabled">Coming soon…</span>
+ * </loom-flag>
+ * ```
+ *
+ * Listens for FlagChanged bus events to swap slots reactively.
+ */
+import { LoomElement } from "@toyz/loom";
+declare class LoomFlagElement extends LoomElement {
+    accessor name: string;
+    accessor enabled: boolean;
+    private _init;
+    private _onFlagChanged;
+    update(): import("@toyz/loom/jsx-runtime").JSX.Element;
+}
+export { LoomFlagElement };
+//# sourceMappingURL=flag-component.d.ts.map

package/dist/flag-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-component.d.ts","sourceRoot":"","sources":["../src/flag-component.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAA0D,MAAM,YAAY,CAAC;AAQjG,cAEM,eAAgB,SAAQ,WAAW;IACjC,QAAQ,CAAC,IAAI,SAAM;IACf,QAAQ,CAAC,OAAO,UAAS;IAGnC,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,cAAc;IAMtB,MAAM;CAKP;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/flag-component.js

@@ -0,0 +1,122 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { jsx as _jsx } from "@toyz/loom/jsx-runtime";
+/**
+ * LoomFlags — <loom-flag> component
+ *
+ * Conditional rendering via named slots:
+ *
+ * ```tsx
+ * <loom-flag name="beta-feature">
+ *   <new-widget slot="enabled" />
+ *   <span slot="disabled">Coming soon…</span>
+ * </loom-flag>
+ * ```
+ *
+ * Listens for FlagChanged bus events to swap slots reactively.
+ */
+import { LoomElement, component, prop, css, styles, reactive, app, on, mount } from "@toyz/loom";
+import { FlagProvider } from "./provider";
+import { FlagChanged } from "./events";
+const flagStyles = css `
+  :host { display: contents; }
+`;
+let LoomFlagElement = (() => {
+    let _classDecorators = [component("loom-flag"), styles(flagStyles)];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = LoomElement;
+    let _instanceExtraInitializers = [];
+    let _name_decorators;
+    let _name_initializers = [];
+    let _name_extraInitializers = [];
+    let _enabled_decorators;
+    let _enabled_initializers = [];
+    let _enabled_extraInitializers = [];
+    let __init_decorators;
+    let __onFlagChanged_decorators;
+    var LoomFlagElement = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _name_decorators = [prop];
+            _enabled_decorators = [reactive];
+            __init_decorators = [mount];
+            __onFlagChanged_decorators = [on(FlagChanged)];
+            __esDecorate(this, null, _name_decorators, { kind: "accessor", name: "name", static: false, private: false, access: { has: obj => "name" in obj, get: obj => obj.name, set: (obj, value) => { obj.name = value; } }, metadata: _metadata }, _name_initializers, _name_extraInitializers);
+            __esDecorate(this, null, _enabled_decorators, { kind: "accessor", name: "enabled", static: false, private: false, access: { has: obj => "enabled" in obj, get: obj => obj.enabled, set: (obj, value) => { obj.enabled = value; } }, metadata: _metadata }, _enabled_initializers, _enabled_extraInitializers);
+            __esDecorate(this, null, __init_decorators, { kind: "method", name: "_init", static: false, private: false, access: { has: obj => "_init" in obj, get: obj => obj._init }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, __onFlagChanged_decorators, { kind: "method", name: "_onFlagChanged", static: false, private: false, access: { has: obj => "_onFlagChanged" in obj, get: obj => obj._onFlagChanged }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            LoomFlagElement = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        #name_accessor_storage = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _name_initializers, ""));
+        get name() { return this.#name_accessor_storage; }
+        set name(value) { this.#name_accessor_storage = value; }
+        #enabled_accessor_storage = (__runInitializers(this, _name_extraInitializers), __runInitializers(this, _enabled_initializers, false));
+        get enabled() { return this.#enabled_accessor_storage; }
+        set enabled(value) { this.#enabled_accessor_storage = value; }
+        _init() {
+            if (!this.name)
+                return;
+            try {
+                this.enabled = app.get(FlagProvider).isEnabled(this.name);
+            }
+            catch {
+                this.enabled = false;
+            }
+        }
+        _onFlagChanged(event) {
+            if (event.flag === this.name) {
+                this.enabled = event.enabled;
+            }
+        }
+        update() {
+            return this.enabled
+                ? _jsx("slot", { name: "enabled" })
+                : _jsx("slot", { name: "disabled" });
+        }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _enabled_extraInitializers);
+        }
+    };
+    return LoomFlagElement = _classThis;
+})();
+export { LoomFlagElement };
+//# sourceMappingURL=flag-component.js.map

package/dist/flag-component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-component.js","sourceRoot":"","sources":["../src/flag-component.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,UAAU,GAAG,GAAG,CAAA;;CAErB,CAAC;IAII,eAAe;4BAFpB,SAAS,CAAC,WAAW,CAAC,EACtB,MAAM,CAAC,UAAU,CAAC;;;;sBACW,WAAW;;;;;;;;;;+BAAnB,SAAQ,WAAW;;;;gCACtC,IAAI;mCACJ,QAAQ;iCAER,KAAK;0CAUL,EAAE,CAAC,WAAW,CAAC;YAbV,iKAAS,IAAI,6BAAJ,IAAI,mFAAM;YACf,0KAAS,OAAO,6BAAP,OAAO,yFAAS;YAGnC,kKAAQ,KAAK,6DAOZ;YAGD,6LAAQ,cAAc,6DAIrB;YAnBH,6KA0BC;;;YA1BK,uDAAe;;QACb,0BADF,mDAAe,8CACG,EAAE,GAAC;QAAnB,IAAS,IAAI,0CAAM;QAAnB,IAAS,IAAI,gDAAM;QACf,8HAAmB,KAAK,GAAC;QAAzB,IAAS,OAAO,6CAAS;QAAzB,IAAS,OAAO,mDAAS;QAG3B,KAAK;YACX,IAAI,CAAC,IAAI,CAAC,IAAI;gBAAE,OAAO;YACvB,IAAI,CAAC;gBACH,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5D,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACvB,CAAC;QACH,CAAC;QAGO,cAAc,CAAC,KAAkB;YACvC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC7B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,MAAM;YACJ,OAAO,IAAI,CAAC,OAAO;gBACjB,CAAC,CAAC,eAAM,IAAI,EAAC,SAAS,GAAG;gBACzB,CAAC,CAAC,eAAM,IAAI,EAAC,UAAU,GAAG,CAAC;QAC/B,CAAC;;;;;;;;AAGH,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/flag.d.ts

@@ -0,0 +1,28 @@
+/**
+ * LoomFlags — @flag decorator
+ *
+ * Raw TC39 Stage 3 decorator for feature flag gating.
+ * Dispatches on `context.kind` to support class and method targets.
+ *
+ * - **class**: injects a reactive `flagEnabled` boolean property
+ * - **method**: guards execution — no-op when flag is off
+ *
+ * ```ts
+ * // Class — injects flagEnabled property
+ * @flag("new-dashboard")
+ * class Dashboard extends LoomElement { ... }
+ *
+ * // Method — no-op when flag is off
+ * @flag("beta-export")
+ * handleExport() { ... }
+ *
+ * // Dynamic context from element instance
+ * @flag("premium", el => ({ plan: el.plan }))
+ * class PremiumWidget extends LoomElement { ... }
+ * ```
+ */
+/** Second arg: static context or a function returning context from element */
+type ContextArg = Record<string, any> | ((el: any) => Record<string, any>);
+export declare function flag(name: string, context?: ContextArg): (value: any, decoratorContext: DecoratorContext) => any;
+export {};
+//# sourceMappingURL=flag.d.ts.map

package/dist/flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag.d.ts","sourceRoot":"","sources":["../src/flag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,8EAA8E;AAC9E,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AAQ3E,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,IAC7C,OAAO,GAAG,EAAE,kBAAkB,gBAAgB,KAAG,GAAG,CAkD7D"}

package/dist/flag.js

@@ -0,0 +1,81 @@
+/**
+ * LoomFlags — @flag decorator
+ *
+ * Raw TC39 Stage 3 decorator for feature flag gating.
+ * Dispatches on `context.kind` to support class and method targets.
+ *
+ * - **class**: injects a reactive `flagEnabled` boolean property
+ * - **method**: guards execution — no-op when flag is off
+ *
+ * ```ts
+ * // Class — injects flagEnabled property
+ * @flag("new-dashboard")
+ * class Dashboard extends LoomElement { ... }
+ *
+ * // Method — no-op when flag is off
+ * @flag("beta-export")
+ * handleExport() { ... }
+ *
+ * // Dynamic context from element instance
+ * @flag("premium", el => ({ plan: el.plan }))
+ * class PremiumWidget extends LoomElement { ... }
+ * ```
+ */
+import { app, bus } from "@toyz/loom";
+import { FlagProvider } from "./provider";
+import { FlagChanged } from "./events";
+function resolveContext(ctx, el) {
+    if (!ctx)
+        return undefined;
+    if (typeof ctx === "function")
+        return ctx(el);
+    return { ...ctx };
+}
+export function flag(name, context) {
+    return (value, decoratorContext) => {
+        switch (decoratorContext.kind) {
+            case "class": {
+                const ctor = value;
+                const originalConnected = ctor.prototype.connectedCallback;
+                ctor.prototype.connectedCallback = function () {
+                    if (originalConnected)
+                        originalConnected.call(this);
+                    // Set initial flag state
+                    const ctx = resolveContext(context, this);
+                    this.flagEnabled = app.get(FlagProvider).isEnabled(name, ctx);
+                    this.flagName = name;
+                    // Listen for flag changes — re-evaluate reactively
+                    const handler = (event) => {
+                        if (event.flag === name) {
+                            this.flagEnabled = event.enabled;
+                            this.scheduleUpdate?.();
+                        }
+                    };
+                    bus.on(FlagChanged, handler);
+                    // Cleanup on disconnect
+                    if (this.track) {
+                        this.track(() => bus.off(FlagChanged, handler));
+                    }
+                };
+                break;
+            }
+            case "method": {
+                const method = value;
+                const key = String(decoratorContext.name);
+                decoratorContext.addInitializer(function () {
+                    const original = method;
+                    const self = this;
+                    this[key] = function (...args) {
+                        const ctx = resolveContext(context, self);
+                        if (!app.get(FlagProvider).isEnabled(name, ctx)) {
+                            return; // Flag is off — no-op
+                        }
+                        return original.apply(self, args);
+                    };
+                });
+                break;
+            }
+        }
+    };
+}
+//# sourceMappingURL=flag.js.map

package/dist/flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag.js","sourceRoot":"","sources":["../src/flag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAKvC,SAAS,cAAc,CAAC,GAA2B,EAAE,EAAO;IAC1D,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,IAAI,OAAO,GAAG,KAAK,UAAU;QAAE,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9C,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,OAAoB;IACrD,OAAO,CAAC,KAAU,EAAE,gBAAkC,EAAO,EAAE;QAC7D,QAAQ,gBAAgB,CAAC,IAAI,EAAE,CAAC;YAC9B,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,IAAI,GAAG,KAAiB,CAAC;gBAC/B,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;gBAE3D,IAAI,CAAC,SAAS,CAAC,iBAAiB,GAAG;oBACjC,IAAI,iBAAiB;wBAAE,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAEpD,yBAAyB;oBACzB,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;oBAC1C,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;oBAC9D,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;oBAErB,mDAAmD;oBACnD,MAAM,OAAO,GAAG,CAAC,KAAkB,EAAE,EAAE;wBACrC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;4BACxB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC;4BACjC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;wBAC1B,CAAC;oBACH,CAAC,CAAC;oBACF,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;oBAE7B,wBAAwB;oBACxB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;wBACf,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;oBAClD,CAAC;gBACH,CAAC,CAAC;gBACF,MAAM;YACR,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,MAAM,GAAG,KAAiB,CAAC;gBACjC,MAAM,GAAG,GAAG,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBAE1C,gBAAgB,CAAC,cAAc,CAAC;oBAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC;oBACxB,MAAM,IAAI,GAAG,IAAI,CAAC;oBACjB,IAAY,CAAC,GAAG,CAAC,GAAG,UAAU,GAAG,IAAW;wBAC3C,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;wBAC1C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;4BAChD,OAAO,CAAC,sBAAsB;wBAChC,CAAC;wBACD,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBACpC,CAAC,CAAC;gBACJ,CAAC,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @toyz/loom-flags — Feature flags for Loom
+ *
+ * Decorator-driven feature flags with real-time reactive updates.
+ *
+ * @packageDocumentation
+ */
+export { FlagProvider } from "./provider";
+export { flag } from "./flag";
+export { FlagChanged } from "./events";
+export { LoomFlagElement } from "./flag-component.js";
+//# 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;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @toyz/loom-flags — Feature flags for Loom
+ *
+ * Decorator-driven feature flags with real-time reactive updates.
+ *
+ * @packageDocumentation
+ */
+export { FlagProvider } from "./provider";
+export { flag } from "./flag";
+export { FlagChanged } from "./events";
+export { LoomFlagElement } from "./flag-component.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,29 @@
+/**
+ * LoomFlags — FlagProvider abstract class
+ *
+ * Base class for all flag providers. Extend this and implement
+ * isEnabled() and getVariant(). Register via DI:
+ *
+ *   app.use(FlagProvider, new MyProvider());
+ *
+ * Providers can call set() to update flags at runtime — this fires
+ * FlagChanged on the Loom bus, causing all @flag decorators and
+ * <loom-flag> components to re-evaluate reactively.
+ */
+export declare abstract class FlagProvider {
+    /** Internal flag cache — providers maintain their own state */
+    protected flags: Map<string, boolean>;
+    protected variants: Map<string, string>;
+    /** Check if a flag is enabled */
+    abstract isEnabled(flag: string, context?: Record<string, any>): boolean;
+    /** Get a flag's variant value */
+    abstract getVariant<T = string>(flag: string, fallback: T): T;
+    /**
+     * Update a flag at runtime — fires FlagChanged on the bus.
+     * Call this from WebSocket handlers, SSE listeners, polling loops, etc.
+     */
+    set(flag: string, enabled: boolean): void;
+    /** Update a variant at runtime — fires FlagChanged on the bus */
+    setVariant(flag: string, value: string): void;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,8BAAsB,YAAY;IAChC,+DAA+D;IAC/D,SAAS,CAAC,KAAK,uBAA8B;IAC7C,SAAS,CAAC,QAAQ,sBAA6B;IAE/C,iCAAiC;IACjC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO;IAExE,iCAAiC;IACjC,QAAQ,CAAC,UAAU,CAAC,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAE7D;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAKzC,iEAAiE;IACjE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;CAI9C"}

package/dist/provider.js

@@ -0,0 +1,33 @@
+/**
+ * LoomFlags — FlagProvider abstract class
+ *
+ * Base class for all flag providers. Extend this and implement
+ * isEnabled() and getVariant(). Register via DI:
+ *
+ *   app.use(FlagProvider, new MyProvider());
+ *
+ * Providers can call set() to update flags at runtime — this fires
+ * FlagChanged on the Loom bus, causing all @flag decorators and
+ * <loom-flag> components to re-evaluate reactively.
+ */
+import { bus } from "@toyz/loom";
+import { FlagChanged } from "./events";
+export class FlagProvider {
+    /** Internal flag cache — providers maintain their own state */
+    flags = new Map();
+    variants = new Map();
+    /**
+     * Update a flag at runtime — fires FlagChanged on the bus.
+     * Call this from WebSocket handlers, SSE listeners, polling loops, etc.
+     */
+    set(flag, enabled) {
+        this.flags.set(flag, enabled);
+        bus.emit(new FlagChanged(flag, enabled));
+    }
+    /** Update a variant at runtime — fires FlagChanged on the bus */
+    setVariant(flag, value) {
+        this.variants.set(flag, value);
+        bus.emit(new FlagChanged(flag, this.isEnabled(flag), value));
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAO,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,OAAgB,YAAY;IAChC,+DAA+D;IACrD,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;IACnC,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAQ/C;;;OAGG;IACH,GAAG,CAAC,IAAY,EAAE,OAAgB;QAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,iEAAiE;IACjE,UAAU,CAAC,IAAY,EAAE,KAAa;QACpC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/testing.d.ts

@@ -0,0 +1,44 @@
+/**
+ * LoomFlags — MockFlags (testing transport)
+ *
+ * Drop-in test provider for @toyz/loom-flags.
+ *
+ * ```ts
+ * import { MockFlags } from "@toyz/loom-flags/testing";
+ *
+ * const flags = new MockFlags();
+ * flags.enable("dark-mode");
+ * flags.disable("beta-export");
+ * flags.setVariant("checkout-flow", "variant-b");
+ *
+ * app.use(FlagProvider, flags);
+ *
+ * flags.assertChecked("dark-mode");
+ * flags.assertEnabled("dark-mode");
+ * flags.reset();
+ * ```
+ */
+import { FlagProvider } from "./provider";
+export declare class MockFlags extends FlagProvider {
+    /** Track which flags were checked (for assertions) */
+    readonly checked: string[];
+    /** Enable a flag */
+    enable(flag: string): void;
+    /** Disable a flag */
+    disable(flag: string): void;
+    /** Check if a flag is enabled */
+    isEnabled(flag: string, _context?: Record<string, any>): boolean;
+    /** Get a flag's variant value */
+    getVariant<T = string>(flag: string, fallback: T): T;
+    /** Assert a flag was checked at least once */
+    assertChecked(flag: string): void;
+    /** Assert a flag was NOT checked */
+    assertNotChecked(flag: string): void;
+    /** Assert a flag is currently enabled */
+    assertEnabled(flag: string): void;
+    /** Assert a flag is currently disabled */
+    assertDisabled(flag: string): void;
+    /** Reset all state */
+    reset(): void;
+}
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,qBAAa,SAAU,SAAQ,YAAY;IACzC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAM;IAEhC,oBAAoB;IACpB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B,qBAAqB;IACrB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,iCAAiC;IACjC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO;IAKhE,iCAAiC;IACjC,UAAU,CAAC,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAMpD,8CAA8C;IAC9C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMjC,oCAAoC;IACpC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMpC,yCAAyC;IACzC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMjC,0CAA0C;IAC1C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMlC,sBAAsB;IACtB,KAAK,IAAI,IAAI;CAKd"}

package/dist/testing.js

@@ -0,0 +1,75 @@
+/**
+ * LoomFlags — MockFlags (testing transport)
+ *
+ * Drop-in test provider for @toyz/loom-flags.
+ *
+ * ```ts
+ * import { MockFlags } from "@toyz/loom-flags/testing";
+ *
+ * const flags = new MockFlags();
+ * flags.enable("dark-mode");
+ * flags.disable("beta-export");
+ * flags.setVariant("checkout-flow", "variant-b");
+ *
+ * app.use(FlagProvider, flags);
+ *
+ * flags.assertChecked("dark-mode");
+ * flags.assertEnabled("dark-mode");
+ * flags.reset();
+ * ```
+ */
+import { FlagProvider } from "./provider";
+export class MockFlags extends FlagProvider {
+    /** Track which flags were checked (for assertions) */
+    checked = [];
+    /** Enable a flag */
+    enable(flag) {
+        this.set(flag, true);
+    }
+    /** Disable a flag */
+    disable(flag) {
+        this.set(flag, false);
+    }
+    /** Check if a flag is enabled */
+    isEnabled(flag, _context) {
+        this.checked.push(flag);
+        return this.flags.get(flag) ?? false;
+    }
+    /** Get a flag's variant value */
+    getVariant(flag, fallback) {
+        this.checked.push(flag);
+        const val = this.variants.get(flag);
+        return (val !== undefined ? val : fallback);
+    }
+    /** Assert a flag was checked at least once */
+    assertChecked(flag) {
+        if (!this.checked.includes(flag)) {
+            throw new Error(`Expected flag "${flag}" to be checked, but it was not.`);
+        }
+    }
+    /** Assert a flag was NOT checked */
+    assertNotChecked(flag) {
+        if (this.checked.includes(flag)) {
+            throw new Error(`Expected flag "${flag}" to NOT be checked, but it was.`);
+        }
+    }
+    /** Assert a flag is currently enabled */
+    assertEnabled(flag) {
+        if (!this.flags.get(flag)) {
+            throw new Error(`Expected flag "${flag}" to be enabled, but it is ${this.flags.get(flag) ?? "unset"}.`);
+        }
+    }
+    /** Assert a flag is currently disabled */
+    assertDisabled(flag) {
+        if (this.flags.get(flag) === true) {
+            throw new Error(`Expected flag "${flag}" to be disabled, but it is enabled.`);
+        }
+    }
+    /** Reset all state */
+    reset() {
+        this.flags.clear();
+        this.variants.clear();
+        this.checked.length = 0;
+    }
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,OAAO,SAAU,SAAQ,YAAY;IACzC,sDAAsD;IAC7C,OAAO,GAAa,EAAE,CAAC;IAEhC,oBAAoB;IACpB,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,qBAAqB;IACrB,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,iCAAiC;IACjC,SAAS,CAAC,IAAY,EAAE,QAA8B;QACpD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;IACvC,CAAC;IAED,iCAAiC;IACjC,UAAU,CAAa,IAAY,EAAE,QAAW;QAC9C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAM,CAAC;IACnD,CAAC;IAED,8CAA8C;IAC9C,aAAa,CAAC,IAAY;QACxB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,kCAAkC,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,gBAAgB,CAAC,IAAY;QAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,kCAAkC,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,aAAa,CAAC,IAAY;QACxB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,8BAA8B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;QAC1G,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,cAAc,CAAC,IAAY;QACzB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,sCAAsC,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@toyz/loom-flags",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Feature flags for Loom — decorator-driven with real-time reactive updates",
+  "license": "MIT",
+  "author": "toyz",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Toyz/loom.git",
+    "directory": "loom-flags"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@toyz/loom": "^0.12.0"
+  },
+  "devDependencies": {
+    "happy-dom": "^20.7.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "keywords": [
+    "loom",
+    "feature-flags",
+    "decorators",
+    "reactive",
+    "web-components"
+  ]
+}