@guideify/react 0.1.1 → 0.3.0

package/dist/index.cjs

@@ -4,8 +4,12 @@
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
+// ../shared/src/paths.ts
+var DEFAULT_CDN_HOST = "https://cdn.guideify.in";
+var LOADER_PATH = "/v1/loader.js";
+
 // ../snippet/src/index.ts
-var DEFAULT_CDN = "https://cdn.guideify.in";
+var DEFAULT_CDN = DEFAULT_CDN_HOST;
 function isCore(candidate) {
   return typeof candidate?.on === "function";
 }
@@ -23,7 +27,7 @@ function installLoader(options) {
   const cdn = options.cdnHost ?? DEFAULT_CDN;
   const tag = document.createElement("script");
   tag.async = true;
-  tag.src = `${cdn}/v1/loader.js`;
+  tag.src = `${cdn}${LOADER_PATH}`;
   tag.setAttribute("data-guideify-key", options.apiKey);
   if (options.cdnHost) tag.setAttribute("data-cdn", options.cdnHost);
   if (options.ingestHost) tag.setAttribute("data-ingest", options.ingestHost);

package/dist/index.d.cts

@@ -186,6 +186,56 @@ interface Flow {
     dismissible?: boolean;
     steps: Step[];
 }
+/**
+ * What marks a checklist item done.
+ *
+ * A flow this environment already publishes, or an event the customer already
+ * sends us — both of which exist before the checklist does. There is
+ * deliberately no third variant for "the user ticked it": the surface is only
+ * worth its corner of somebody's application if it reflects what has actually
+ * happened in the product, and a box you can tick yourself reports nothing.
+ */
+type ChecklistItemGoal = {
+    type: 'flow';
+    flowId: string;
+} | {
+    type: 'event';
+    name: string;
+};
+interface ChecklistItem {
+    id: string;
+    label: string;
+    /** Optional one-liner under the label. The renderer's document, not a string. */
+    body?: ContentNode;
+    goal: ChecklistItemGoal;
+}
+/**
+ * The persistent surface — BUILD_REPORT §8, J-02.
+ *
+ * **It carries no `trigger`, no `frequency` and no `priority`, and the three
+ * absences are the design.** A checklist is not triggered, it is present:
+ * `Trigger`'s five variants each describe a moment, which is precisely what
+ * this is not, and `Frequency` answers *how often does this fire* about
+ * something that never fires. It does not compete for the screen either — §8
+ * puts it outside the one-blocking-flow rule, so it never enters the sort that
+ * `priority` exists to break. Three fields pinned to a constant would each be a
+ * question the reader has to answer before discovering it was never asked.
+ *
+ * `audience` is the same `RuleNode` a flow takes, read by the same
+ * `evaluateRules`. Reusing the evaluator is what stops a second rule engine
+ * existing.
+ */
+interface Checklist {
+    id: string;
+    name: string;
+    version: number;
+    audience?: RuleNode;
+    items: ChecklistItem[];
+    /** Where the launcher sits. The host app's other corner is usually taken. */
+    position?: 'bottom-end' | 'bottom-start';
+    /** Hidden once every item is done, which is the default a customer expects. */
+    dismissWhenComplete?: boolean;
+}
 interface ThemeTokens {
     accent?: string;
     scrim?: string;
@@ -203,6 +253,21 @@ interface GuideifyConfig {
     envKey: string;
     flows: Flow[];
     settings?: ConfigSettings;
+    /**
+     * The one persistent surface this environment publishes, if it has one.
+     *
+     * **Singular, deliberately.** A corner of somebody else's application has
+     * room for one launcher; a list invites two of them fighting over the same
+     * 56 pixels, and nothing in this product could arbitrate between them.
+     *
+     * Additive with a safe default, which is the header's rule and is what makes
+     * it publishable to environments held on an older core by `sdkPin` (R-04): a
+     * core built before this field existed parses the artifact, ignores the key
+     * and runs its flows. `packages/sdk/test/checklist-config.test.mjs` pins
+     * that, because it is an accident of `validateConfig` until something asserts
+     * it.
+     */
+    checklist?: Checklist;
 }
 interface UserTraits {
     [key: string]: unknown;
@@ -297,7 +362,15 @@ interface SnippetOptions extends Pick<InitOptions, 'apiKey'> {
      */
     nonce?: string | undefined;
 }
-/** Where the loader lives when nothing says otherwise. Mirrors `loader.ts`. */
+/**
+ * Where the loader lives when nothing says otherwise.
+ *
+ * Re-exported under this package's own name rather than renamed at the call
+ * site, because `@guideify/react` and `@guideify/vue` both re-export it again
+ * and it is public API in three places. The value is `@guideify/shared`'s —
+ * this used to say *mirrors `loader.ts`*, and a mirror is the thing T-110 was
+ * filed about.
+ */
 declare const DEFAULT_CDN = "https://cdn.guideify.in";
 
 interface GuideifyProviderProps extends SnippetOptions {

package/dist/index.d.ts

@@ -186,6 +186,56 @@ interface Flow {
     dismissible?: boolean;
     steps: Step[];
 }
+/**
+ * What marks a checklist item done.
+ *
+ * A flow this environment already publishes, or an event the customer already
+ * sends us — both of which exist before the checklist does. There is
+ * deliberately no third variant for "the user ticked it": the surface is only
+ * worth its corner of somebody's application if it reflects what has actually
+ * happened in the product, and a box you can tick yourself reports nothing.
+ */
+type ChecklistItemGoal = {
+    type: 'flow';
+    flowId: string;
+} | {
+    type: 'event';
+    name: string;
+};
+interface ChecklistItem {
+    id: string;
+    label: string;
+    /** Optional one-liner under the label. The renderer's document, not a string. */
+    body?: ContentNode;
+    goal: ChecklistItemGoal;
+}
+/**
+ * The persistent surface — BUILD_REPORT §8, J-02.
+ *
+ * **It carries no `trigger`, no `frequency` and no `priority`, and the three
+ * absences are the design.** A checklist is not triggered, it is present:
+ * `Trigger`'s five variants each describe a moment, which is precisely what
+ * this is not, and `Frequency` answers *how often does this fire* about
+ * something that never fires. It does not compete for the screen either — §8
+ * puts it outside the one-blocking-flow rule, so it never enters the sort that
+ * `priority` exists to break. Three fields pinned to a constant would each be a
+ * question the reader has to answer before discovering it was never asked.
+ *
+ * `audience` is the same `RuleNode` a flow takes, read by the same
+ * `evaluateRules`. Reusing the evaluator is what stops a second rule engine
+ * existing.
+ */
+interface Checklist {
+    id: string;
+    name: string;
+    version: number;
+    audience?: RuleNode;
+    items: ChecklistItem[];
+    /** Where the launcher sits. The host app's other corner is usually taken. */
+    position?: 'bottom-end' | 'bottom-start';
+    /** Hidden once every item is done, which is the default a customer expects. */
+    dismissWhenComplete?: boolean;
+}
 interface ThemeTokens {
     accent?: string;
     scrim?: string;
@@ -203,6 +253,21 @@ interface GuideifyConfig {
     envKey: string;
     flows: Flow[];
     settings?: ConfigSettings;
+    /**
+     * The one persistent surface this environment publishes, if it has one.
+     *
+     * **Singular, deliberately.** A corner of somebody else's application has
+     * room for one launcher; a list invites two of them fighting over the same
+     * 56 pixels, and nothing in this product could arbitrate between them.
+     *
+     * Additive with a safe default, which is the header's rule and is what makes
+     * it publishable to environments held on an older core by `sdkPin` (R-04): a
+     * core built before this field existed parses the artifact, ignores the key
+     * and runs its flows. `packages/sdk/test/checklist-config.test.mjs` pins
+     * that, because it is an accident of `validateConfig` until something asserts
+     * it.
+     */
+    checklist?: Checklist;
 }
 interface UserTraits {
     [key: string]: unknown;
@@ -297,7 +362,15 @@ interface SnippetOptions extends Pick<InitOptions, 'apiKey'> {
      */
     nonce?: string | undefined;
 }
-/** Where the loader lives when nothing says otherwise. Mirrors `loader.ts`. */
+/**
+ * Where the loader lives when nothing says otherwise.
+ *
+ * Re-exported under this package's own name rather than renamed at the call
+ * site, because `@guideify/react` and `@guideify/vue` both re-export it again
+ * and it is public API in three places. The value is `@guideify/shared`'s —
+ * this used to say *mirrors `loader.ts`*, and a mirror is the thing T-110 was
+ * filed about.
+ */
 declare const DEFAULT_CDN = "https://cdn.guideify.in";
 
 interface GuideifyProviderProps extends SnippetOptions {

package/dist/index.js

@@ -2,8 +2,12 @@
 import { createContext, useContext, useMemo, useState, useEffect, isValidElement, cloneElement } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
+// ../shared/src/paths.ts
+var DEFAULT_CDN_HOST = "https://cdn.guideify.in";
+var LOADER_PATH = "/v1/loader.js";
+
 // ../snippet/src/index.ts
-var DEFAULT_CDN = "https://cdn.guideify.in";
+var DEFAULT_CDN = DEFAULT_CDN_HOST;
 function isCore(candidate) {
   return typeof candidate?.on === "function";
 }
@@ -21,7 +25,7 @@ function installLoader(options) {
   const cdn = options.cdnHost ?? DEFAULT_CDN;
   const tag = document.createElement("script");
   tag.async = true;
-  tag.src = `${cdn}/v1/loader.js`;
+  tag.src = `${cdn}${LOADER_PATH}`;
   tag.setAttribute("data-guideify-key", options.apiKey);
   if (options.cdnHost) tag.setAttribute("data-cdn", options.cdnHost);
   if (options.ingestHost) tag.setAttribute("data-ingest", options.ingestHost);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guideify/react",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
   "main": "./dist/index.cjs",