@aglyn/plugins-marketing 1.0.0-beta.143

package/src/lib/components/experiment-zones.d.ts

@@ -0,0 +1,78 @@
+import type { ExperimentTarget, ExperimentVariant } from '../model/experiments';
+/**
+ * The two zones the A/B testing card hosts (AGL-2914).
+ *
+ * A/B testing is this plugin's: the experiment document, its variants, the
+ * traffic split, the counters and the comparison. What it never had was
+ * anyone to help WRITE the variants or READ the result in words, and the
+ * plugin that could do both may not be imported here any more than this one
+ * may be imported there.
+ *
+ * So the card hosts two positions and says what each hands a widget. A
+ * widget is drawn by the console shell's own renderer, through the context it
+ * hands down, so every gate a console page's slot applies — the plugins this
+ * workspace has, the entitlement the widget declares, the permission its
+ * reader must hold — applies here unchanged. Outside the shell the context is
+ * `null` and a zone draws nothing, which is also what a workspace with no
+ * widget for the zone gets: the card renders exactly as it did before these
+ * positions existed.
+ *
+ * ## A widget proposes; this card writes
+ *
+ * {@link EXPERIMENT_VARIANTS_ZONE} hands a widget the experiment being
+ * edited and a `proposeVariants` callback. The callback fills the editor's
+ * OWN fields, unsaved, and the dialog's Save is the only write — the same
+ * guarded write a typed variant takes. Nothing a widget returns reaches
+ * Firestore, starts a test or moves a visitor.
+ *
+ * {@link EXPERIMENT_RESULT_ZONE} hands a widget the test whose results are
+ * open, by the name the results figures label it with, so a widget that
+ * explains a result is looking at the same test the reader is. It takes no
+ * callback: there is nothing to apply to an explanation.
+ */
+/** One variant as the editor holds it, for a widget writing alternatives to it. */
+export interface MarketingExperimentVariantDraft {
+    id: string;
+    name: string;
+    /** A screen or section variant's copy is its screen version, so it carries none here. */
+    subject: string;
+    body: string;
+}
+/** What {@link EXPERIMENT_VARIANTS_ZONE} hands each widget. */
+export interface MarketingExperimentVariantsZoneProps {
+    hostId: string;
+    /** The experiment's id once it has been saved; empty while it is new. */
+    experimentId: string;
+    /** The experiment's name as the editor holds it. */
+    name: string;
+    target: ExperimentTarget;
+    /** The conversion event the test counts, as the goal names it. */
+    goal: string;
+    variants: MarketingExperimentVariantDraft[];
+    /**
+     * Fills the editor's variant fields with what a widget proposes, unsaved.
+     * `key` identifies the proposal so a widget can tell which of its own the
+     * editor is showing. Variants past the ones the editor holds are ignored:
+     * the editor's list is the test's shape and a widget does not change it.
+     */
+    proposeVariants: (variants: readonly MarketingExperimentVariantDraft[], key: string) => void;
+}
+/** What {@link EXPERIMENT_RESULT_ZONE} hands each widget. */
+export interface MarketingExperimentResultZoneProps {
+    hostId: string;
+    experimentId: string;
+    /** The test's name as the results figures label it, which is how a reader names one. */
+    test: string;
+}
+export declare const EXPERIMENT_VARIANTS_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<MarketingExperimentVariantsZoneProps>;
+export declare const EXPERIMENT_RESULT_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<MarketingExperimentResultZoneProps>;
+export declare function ExperimentVariantsZone(props: MarketingExperimentVariantsZoneProps): import("react").JSX.Element;
+export declare namespace ExperimentVariantsZone {
+    var displayName: string;
+}
+export declare function ExperimentResultZone(props: MarketingExperimentResultZoneProps): import("react").JSX.Element;
+export declare namespace ExperimentResultZone {
+    var displayName: string;
+}
+/** The editor's variants as the zone hands them over. */
+export declare function marketingExperimentVariantDrafts(variants: readonly ExperimentVariant[] | undefined): MarketingExperimentVariantDraft[];

package/src/lib/components/experiment-zones.js

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useConsoleWidgetSlot } from "@aglyn/aglyn/app-utils/console-widget-slot-context";
+import { definePluginZone } from "@aglyn/aglyn/plugin-manager/plugin-zones";
+export const EXPERIMENT_VARIANTS_ZONE = definePluginZone('experimentVariants');
+export const EXPERIMENT_RESULT_ZONE = definePluginZone('experimentResult');
+/**
+ * Draws a hosted zone through the shell's renderer, or nothing at all when
+ * there is no shell. One component for both zones: they differ only in the
+ * id they name and the props they carry, and a zone that drew a heading or a
+ * wrapper of its own would change the card for every workspace that has no
+ * widget for it.
+ */ function HostedZone(props) {
+    const { slot, zone, Slot } = props;
+    return /*#__PURE__*/ _jsx(Slot, _extends({
+        slot: slot
+    }, zone));
+}
+export function ExperimentVariantsZone(props) {
+    const Slot = useConsoleWidgetSlot();
+    return Slot ? /*#__PURE__*/ _jsx(HostedZone, {
+        slot: EXPERIMENT_VARIANTS_ZONE.id,
+        zone: _extends({}, props),
+        Slot: Slot
+    }) : null;
+}
+ExperimentVariantsZone.displayName = 'ExperimentVariantsZone';
+export function ExperimentResultZone(props) {
+    const Slot = useConsoleWidgetSlot();
+    return Slot ? /*#__PURE__*/ _jsx(HostedZone, {
+        slot: EXPERIMENT_RESULT_ZONE.id,
+        zone: _extends({}, props),
+        Slot: Slot
+    }) : null;
+}
+ExperimentResultZone.displayName = 'ExperimentResultZone';
+/** The editor's variants as the zone hands them over. */ export function marketingExperimentVariantDrafts(variants) {
+    return (variants != null ? variants : []).map((variant)=>{
+        var _variant_name, _variant_subject, _variant_body;
+        return {
+            id: variant.id,
+            name: (_variant_name = variant.name) != null ? _variant_name : '',
+            subject: (_variant_subject = variant.subject) != null ? _variant_subject : '',
+            body: (_variant_body = variant.body) != null ? _variant_body : ''
+        };
+    });
+}
+
+//# sourceMappingURL=experiment-zones.js.map

package/src/lib/components/experiment-zones.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/components/experiment-zones.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport {\n  type ConsoleWidgetSlotRenderer,\n  useConsoleWidgetSlot,\n} from '@aglyn/aglyn/app-utils/console-widget-slot-context'\nimport { definePluginZone } from '@aglyn/aglyn/plugin-manager/plugin-zones'\nimport type { ExperimentTarget, ExperimentVariant } from '../model/experiments'\n\n/**\n * The two zones the A/B testing card hosts (AGL-2914).\n *\n * A/B testing is this plugin's: the experiment document, its variants, the\n * traffic split, the counters and the comparison. What it never had was\n * anyone to help WRITE the variants or READ the result in words, and the\n * plugin that could do both may not be imported here any more than this one\n * may be imported there.\n *\n * So the card hosts two positions and says what each hands a widget. A\n * widget is drawn by the console shell's own renderer, through the context it\n * hands down, so every gate a console page's slot applies — the plugins this\n * workspace has, the entitlement the widget declares, the permission its\n * reader must hold — applies here unchanged. Outside the shell the context is\n * `null` and a zone draws nothing, which is also what a workspace with no\n * widget for the zone gets: the card renders exactly as it did before these\n * positions existed.\n *\n * ## A widget proposes; this card writes\n *\n * {@link EXPERIMENT_VARIANTS_ZONE} hands a widget the experiment being\n * edited and a `proposeVariants` callback. The callback fills the editor's\n * OWN fields, unsaved, and the dialog's Save is the only write — the same\n * guarded write a typed variant takes. Nothing a widget returns reaches\n * Firestore, starts a test or moves a visitor.\n *\n * {@link EXPERIMENT_RESULT_ZONE} hands a widget the test whose results are\n * open, by the name the results figures label it with, so a widget that\n * explains a result is looking at the same test the reader is. It takes no\n * callback: there is nothing to apply to an explanation.\n */\n\n/** One variant as the editor holds it, for a widget writing alternatives to it. */\nexport interface MarketingExperimentVariantDraft {\n  id: string\n  name: string\n  /** A screen or section variant's copy is its screen version, so it carries none here. */\n  subject: string\n  body: string\n}\n\n/** What {@link EXPERIMENT_VARIANTS_ZONE} hands each widget. */\nexport interface MarketingExperimentVariantsZoneProps {\n  hostId: string\n  /** The experiment's id once it has been saved; empty while it is new. */\n  experimentId: string\n  /** The experiment's name as the editor holds it. */\n  name: string\n  target: ExperimentTarget\n  /** The conversion event the test counts, as the goal names it. */\n  goal: string\n  variants: MarketingExperimentVariantDraft[]\n  /**\n   * Fills the editor's variant fields with what a widget proposes, unsaved.\n   * `key` identifies the proposal so a widget can tell which of its own the\n   * editor is showing. Variants past the ones the editor holds are ignored:\n   * the editor's list is the test's shape and a widget does not change it.\n   */\n  proposeVariants: (\n    variants: readonly MarketingExperimentVariantDraft[],\n    key: string,\n  ) => void\n}\n\n/** What {@link EXPERIMENT_RESULT_ZONE} hands each widget. */\nexport interface MarketingExperimentResultZoneProps {\n  hostId: string\n  experimentId: string\n  /** The test's name as the results figures label it, which is how a reader names one. */\n  test: string\n}\n\nexport const EXPERIMENT_VARIANTS_ZONE =\n  definePluginZone<MarketingExperimentVariantsZoneProps>('experimentVariants')\n\nexport const EXPERIMENT_RESULT_ZONE =\n  definePluginZone<MarketingExperimentResultZoneProps>('experimentResult')\n\n/**\n * Draws a hosted zone through the shell's renderer, or nothing at all when\n * there is no shell. One component for both zones: they differ only in the\n * id they name and the props they carry, and a zone that drew a heading or a\n * wrapper of its own would change the card for every workspace that has no\n * widget for it.\n */\nfunction HostedZone(props: {\n  slot: string\n  zone: Record<string, unknown>\n  Slot: ConsoleWidgetSlotRenderer\n}) {\n  const { slot, zone, Slot } = props\n  return <Slot slot={slot} {...zone} />\n}\n\nexport function ExperimentVariantsZone(props: MarketingExperimentVariantsZoneProps) {\n  const Slot = useConsoleWidgetSlot()\n  return Slot ? (\n    <HostedZone slot={EXPERIMENT_VARIANTS_ZONE.id} zone={{ ...props }} Slot={Slot} />\n  ) : null\n}\nExperimentVariantsZone.displayName = 'ExperimentVariantsZone'\n\nexport function ExperimentResultZone(props: MarketingExperimentResultZoneProps) {\n  const Slot = useConsoleWidgetSlot()\n  return Slot ? (\n    <HostedZone slot={EXPERIMENT_RESULT_ZONE.id} zone={{ ...props }} Slot={Slot} />\n  ) : null\n}\nExperimentResultZone.displayName = 'ExperimentResultZone'\n\n/** The editor's variants as the zone hands them over. */\nexport function marketingExperimentVariantDrafts(\n  variants: readonly ExperimentVariant[] | undefined,\n): MarketingExperimentVariantDraft[] {\n  return (variants ?? []).map((variant) => ({\n    id: variant.id,\n    name: variant.name ?? '',\n    subject: variant.subject ?? '',\n    body: variant.body ?? '',\n  }))\n}\n"],"names":["useConsoleWidgetSlot","definePluginZone","EXPERIMENT_VARIANTS_ZONE","EXPERIMENT_RESULT_ZONE","HostedZone","props","slot","zone","Slot","ExperimentVariantsZone","id","displayName","ExperimentResultZone","marketingExperimentVariantDrafts","variants","map","variant","name","subject","body"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;;AAEA,SAEEA,oBAAoB,QACf,qDAAoD;AAC3D,SAASC,gBAAgB,QAAQ,2CAA0C;AA2E3E,OAAO,MAAMC,2BACXD,iBAAuD,sBAAqB;AAE9E,OAAO,MAAME,yBACXF,iBAAqD,oBAAmB;AAE1E;;;;;;CAMC,GACD,SAASG,WAAWC,KAInB;IACC,MAAM,EAAEC,IAAI,EAAEC,IAAI,EAAEC,IAAI,EAAE,GAAGH;IAC7B,qBAAO,KAACG;QAAKF,MAAMA;OAAUC;AAC/B;AAEA,OAAO,SAASE,uBAAuBJ,KAA2C;IAChF,MAAMG,OAAOR;IACb,OAAOQ,qBACL,KAACJ;QAAWE,MAAMJ,yBAAyBQ,EAAE;QAAEH,MAAM,aAAKF;QAASG,MAAMA;SACvE;AACN;AACAC,uBAAuBE,WAAW,GAAG;AAErC,OAAO,SAASC,qBAAqBP,KAAyC;IAC5E,MAAMG,OAAOR;IACb,OAAOQ,qBACL,KAACJ;QAAWE,MAAMH,uBAAuBO,EAAE;QAAEH,MAAM,aAAKF;QAASG,MAAMA;SACrE;AACN;AACAI,qBAAqBD,WAAW,GAAG;AAEnC,uDAAuD,GACvD,OAAO,SAASE,iCACdC,QAAkD;IAElD,OAAO,CAACA,mBAAAA,WAAY,EAAE,EAAEC,GAAG,CAAC,CAACC;YAErBA,eACGA,kBACHA;eAJkC;YACxCN,IAAIM,QAAQN,EAAE;YACdO,IAAI,GAAED,gBAAAA,QAAQC,IAAI,YAAZD,gBAAgB;YACtBE,OAAO,GAAEF,mBAAAA,QAAQE,OAAO,YAAfF,mBAAmB;YAC5BG,IAAI,GAAEH,gBAAAA,QAAQG,IAAI,YAAZH,gBAAgB;QACxB;;AACF"}

package/src/lib/components/host-experiments-card.component.d.ts

@@ -0,0 +1,17 @@
+import { type AglynOrgBilling } from '@aglyn/aglyn';
+export interface HostExperimentsCardProps {
+    hostId: string;
+    /** Resolved entitlement source (AGL-395). */
+    org?: Partial<AglynOrgBilling>;
+}
+/**
+ * Experiments manager (AGL-252): create screen/section/email A/B tests
+ * with weighted variants and a conversion goal; start/pause/finish them
+ * and read exposures/conversions per variant. Business tier
+ * (`ab-testing`).
+ */
+export declare function HostExperimentsCard(props: HostExperimentsCardProps): import("react").JSX.Element;
+export declare namespace HostExperimentsCard {
+    var displayName: string;
+}
+export default HostExperimentsCard;