@burdenoff/website-sdk 2026.1013.1 → 2026.1014.1

package/README.md

@@ -211,7 +211,12 @@ end-to-end suite: `page`, `messages`, `composer`, `chip`, `thinking`, `user`,
 `ConceptsPage` and `ConceptDetailPage` render a product's concepts: each one a
 feature or flow, shown through the mockups drawn for it and explained in
 reviewed copy. Every image is labelled an **illustration of the concept, not a
-screenshot of the actual product** (`CONCEPT_ILLUSTRATION_NOTICE`).
+screenshot of the actual product** (`CONCEPT_ILLUSTRATION_NOTICE`), and a
+concept's numbered "How it works" steps carry the matching qualifier
+(`CONCEPT_WORKFLOW_NOTICE`) — a numbered list under that heading otherwise reads
+as a click-through procedure. Both render wherever their section does; neither
+is keyed to a field of generated data, so neither can vanish when a generator
+drops one.
 
 The data is a generated `src/data/concepts.ts` in each site — never hand-edit
 it; regenerate with
@@ -290,7 +295,8 @@ filter bar or zero counts.
 `className`.
 
 **Helpers**: `CONCEPTS_PATH` (`/concepts`), `CONCEPT_PATH_PREFIX` (`/concept`),
-`conceptPath(slug)`, `getConceptBySlug(concepts, slug)`; types `Concept`,
+`conceptPath(slug)`, `getConceptBySlug(concepts, slug)`,
+`CONCEPT_ILLUSTRATION_NOTICE`, `CONCEPT_WORKFLOW_NOTICE`; types `Concept`,
 `ConceptImage`, `ConceptCategory`, `ConceptLinkComponent`, `ConceptLinkProps`.
 
 **SEO and llms.** One `<h1>` per page, a self-canonical URL, absolute OG images
@@ -305,7 +311,12 @@ never in the prerendered HTML.
 **Testing hooks.** `data-concepts="landing" | "card" (plus data-slug) | "filter"
 | "notice" | "empty" (filters match nothing) | "none" (no concepts at all) |
 "detail" | "category" | "hero" | "illustration" | "related" | "pager" | "cta" |
-"lightbox"`, and `data-concepts-notice` on the notice.
+"lightbox" | "workflow-notice"`, plus `data-concepts-notice` on the illustration
+notice and `data-concepts-workflow-notice` on the workflow one. The two
+attributes are deliberately distinct: several assertions select
+`[data-concepts-notice]` with `querySelector` and read the single node they get
+back, so a second element wearing it would keep them green while describing the
+wrong element.
 
 ### SEO Component
 

package/dist/index.d.mts

@@ -166,6 +166,25 @@ type ConceptLinkComponent = ComponentType<ConceptLinkProps>;
  * picture shows the shipping product.
  */
 declare const CONCEPT_ILLUSTRATION_NOTICE = "These images are illustrations of the concept, not screenshots of the actual product.";
+/**
+ * The disclaimer shown above every concept's "How it works" steps.
+ *
+ * A numbered list under that heading reads as a procedure — the sequence of screens a
+ * visitor would click through — when what it actually describes is how the pieces of the
+ * concept relate. The illustration notice covers the pictures; nothing covered the steps,
+ * so the most instruction-shaped part of the page was the least qualified.
+ *
+ * Rendered with NO data gate, exactly like CONCEPT_ILLUSTRATION_NOTICE. Keying a
+ * disclosure to a generated field is how it disappears silently the first time a
+ * generator omits that field, and the page would then look more authoritative, not less.
+ * The section's own `workflow.length > 0` check is the only condition: no steps, no
+ * heading, nothing to qualify.
+ *
+ * The sentence says nothing about launch or availability. Every product behind these
+ * pages is generally available, and a notice that hinted otherwise would be false on
+ * every site that renders it.
+ */
+declare const CONCEPT_WORKFLOW_NOTICE = "These steps illustrate how the concept fits together \u2014 not a walkthrough of the product's current interface.";
 /** Where every industry solution is listed. */
 declare const DOMAINS_URL = "https://burdenoff.com/domains";
 /** The landing page route. */
@@ -815,4 +834,4 @@ declare const Textarea: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLP
  */
 declare const ECOSYSTEM_PRODUCTS: WebsiteSwitcherProduct[];
 
-export { ANSWERS_PATH, ANSWER_HEADING_SHIFT, ANSWER_PATH_PREFIX, AnswerDetailPage, type AnswerDetailPageProps, type AnswerLinkComponent, type AnswerLinkProps, AnswerRendererStrings, type AnswerStrings, AnswersPage, type AnswersPageProps, Button, type ButtonProps, CONCEPTS_PATH, CONCEPT_ILLUSTRATION_NOTICE, CONCEPT_PATH_PREFIX, CareersPostingOption, CareersSubmissionForm, type CareersSubmissionFormProps, type Concept, type ConceptCategory, ConceptDetailPage, type ConceptDetailPageProps, type ConceptDevice, type ConceptImage, type ConceptLinkComponent, type ConceptLinkProps, type ConceptSolution, ConceptsPage, type ConceptsPageProps, DOMAINS_URL, ECOSYSTEM_PRODUCTS, EXPLORE_LOCALES, type ExploreLocale, type ExploreStrings, Input, Label, PUBLISHED_ANSWER_FIELDS, type PublishedAnswer, type PublishedAnswerSource, type PublishedAnswerTopic, Select, Textarea, WebsiteSwitcherProduct, answerPath, answerSourceHost, answerStrings, buttonVariants, conceptPath, formatAnswerDate, getAnswerBySlug, getConceptBySlug, isPublishedSourceUrl, isValidUrl, speechLocaleOf };
+export { ANSWERS_PATH, ANSWER_HEADING_SHIFT, ANSWER_PATH_PREFIX, AnswerDetailPage, type AnswerDetailPageProps, type AnswerLinkComponent, type AnswerLinkProps, AnswerRendererStrings, type AnswerStrings, AnswersPage, type AnswersPageProps, Button, type ButtonProps, CONCEPTS_PATH, CONCEPT_ILLUSTRATION_NOTICE, CONCEPT_PATH_PREFIX, CONCEPT_WORKFLOW_NOTICE, CareersPostingOption, CareersSubmissionForm, type CareersSubmissionFormProps, type Concept, type ConceptCategory, ConceptDetailPage, type ConceptDetailPageProps, type ConceptDevice, type ConceptImage, type ConceptLinkComponent, type ConceptLinkProps, type ConceptSolution, ConceptsPage, type ConceptsPageProps, DOMAINS_URL, ECOSYSTEM_PRODUCTS, EXPLORE_LOCALES, type ExploreLocale, type ExploreStrings, Input, Label, PUBLISHED_ANSWER_FIELDS, type PublishedAnswer, type PublishedAnswerSource, type PublishedAnswerTopic, Select, Textarea, WebsiteSwitcherProduct, answerPath, answerSourceHost, answerStrings, buttonVariants, conceptPath, formatAnswerDate, getAnswerBySlug, getConceptBySlug, isPublishedSourceUrl, isValidUrl, speechLocaleOf };

package/dist/index.d.ts

@@ -166,6 +166,25 @@ type ConceptLinkComponent = ComponentType<ConceptLinkProps>;
  * picture shows the shipping product.
  */
 declare const CONCEPT_ILLUSTRATION_NOTICE = "These images are illustrations of the concept, not screenshots of the actual product.";
+/**
+ * The disclaimer shown above every concept's "How it works" steps.
+ *
+ * A numbered list under that heading reads as a procedure — the sequence of screens a
+ * visitor would click through — when what it actually describes is how the pieces of the
+ * concept relate. The illustration notice covers the pictures; nothing covered the steps,
+ * so the most instruction-shaped part of the page was the least qualified.
+ *
+ * Rendered with NO data gate, exactly like CONCEPT_ILLUSTRATION_NOTICE. Keying a
+ * disclosure to a generated field is how it disappears silently the first time a
+ * generator omits that field, and the page would then look more authoritative, not less.
+ * The section's own `workflow.length > 0` check is the only condition: no steps, no
+ * heading, nothing to qualify.
+ *
+ * The sentence says nothing about launch or availability. Every product behind these
+ * pages is generally available, and a notice that hinted otherwise would be false on
+ * every site that renders it.
+ */
+declare const CONCEPT_WORKFLOW_NOTICE = "These steps illustrate how the concept fits together \u2014 not a walkthrough of the product's current interface.";
 /** Where every industry solution is listed. */
 declare const DOMAINS_URL = "https://burdenoff.com/domains";
 /** The landing page route. */
@@ -815,4 +834,4 @@ declare const Textarea: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLP
  */
 declare const ECOSYSTEM_PRODUCTS: WebsiteSwitcherProduct[];
 
-export { ANSWERS_PATH, ANSWER_HEADING_SHIFT, ANSWER_PATH_PREFIX, AnswerDetailPage, type AnswerDetailPageProps, type AnswerLinkComponent, type AnswerLinkProps, AnswerRendererStrings, type AnswerStrings, AnswersPage, type AnswersPageProps, Button, type ButtonProps, CONCEPTS_PATH, CONCEPT_ILLUSTRATION_NOTICE, CONCEPT_PATH_PREFIX, CareersPostingOption, CareersSubmissionForm, type CareersSubmissionFormProps, type Concept, type ConceptCategory, ConceptDetailPage, type ConceptDetailPageProps, type ConceptDevice, type ConceptImage, type ConceptLinkComponent, type ConceptLinkProps, type ConceptSolution, ConceptsPage, type ConceptsPageProps, DOMAINS_URL, ECOSYSTEM_PRODUCTS, EXPLORE_LOCALES, type ExploreLocale, type ExploreStrings, Input, Label, PUBLISHED_ANSWER_FIELDS, type PublishedAnswer, type PublishedAnswerSource, type PublishedAnswerTopic, Select, Textarea, WebsiteSwitcherProduct, answerPath, answerSourceHost, answerStrings, buttonVariants, conceptPath, formatAnswerDate, getAnswerBySlug, getConceptBySlug, isPublishedSourceUrl, isValidUrl, speechLocaleOf };
+export { ANSWERS_PATH, ANSWER_HEADING_SHIFT, ANSWER_PATH_PREFIX, AnswerDetailPage, type AnswerDetailPageProps, type AnswerLinkComponent, type AnswerLinkProps, AnswerRendererStrings, type AnswerStrings, AnswersPage, type AnswersPageProps, Button, type ButtonProps, CONCEPTS_PATH, CONCEPT_ILLUSTRATION_NOTICE, CONCEPT_PATH_PREFIX, CONCEPT_WORKFLOW_NOTICE, CareersPostingOption, CareersSubmissionForm, type CareersSubmissionFormProps, type Concept, type ConceptCategory, ConceptDetailPage, type ConceptDetailPageProps, type ConceptDevice, type ConceptImage, type ConceptLinkComponent, type ConceptLinkProps, type ConceptSolution, ConceptsPage, type ConceptsPageProps, DOMAINS_URL, ECOSYSTEM_PRODUCTS, EXPLORE_LOCALES, type ExploreLocale, type ExploreStrings, Input, Label, PUBLISHED_ANSWER_FIELDS, type PublishedAnswer, type PublishedAnswerSource, type PublishedAnswerTopic, Select, Textarea, WebsiteSwitcherProduct, answerPath, answerSourceHost, answerStrings, buttonVariants, conceptPath, formatAnswerDate, getAnswerBySlug, getConceptBySlug, isPublishedSourceUrl, isValidUrl, speechLocaleOf };

package/dist/index.js

@@ -4858,6 +4858,7 @@ function ElectronDownloadLink({
 
 // src/components/concepts-types.ts
 var CONCEPT_ILLUSTRATION_NOTICE = "These images are illustrations of the concept, not screenshots of the actual product.";
+var CONCEPT_WORKFLOW_NOTICE = "These steps illustrate how the concept fits together \u2014 not a walkthrough of the product's current interface.";
 var DOMAINS_URL = "https://burdenoff.com/domains";
 var CONCEPTS_PATH = "/concepts";
 var CONCEPT_PATH_PREFIX = "/concept";
@@ -5160,6 +5161,30 @@ function IllustrationNotice({ className }) {
     }
   );
 }
+function WorkflowNotice({ className }) {
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      role: "note",
+      "data-concepts": "workflow-notice",
+      "data-concepts-workflow-notice": "",
+      className: cn(
+        "mt-4 flex items-start gap-3 rounded-xl border border-border bg-muted/50 px-4 py-3 text-sm leading-relaxed text-muted-foreground",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx(
+          lucideReact.Info,
+          {
+            "aria-hidden": "true",
+            className: "mt-0.5 h-4 w-4 shrink-0 text-muted-foreground"
+          }
+        ),
+        /* @__PURE__ */ jsxRuntime.jsx("p", { children: CONCEPT_WORKFLOW_NOTICE })
+      ]
+    }
+  );
+}
 function IllustrationBadge({ className }) {
   return /* @__PURE__ */ jsxRuntime.jsx(
     "span",
@@ -5985,6 +6010,7 @@ function ConceptDetail({
             ] }) : null,
             concept.workflow.length > 0 ? /* @__PURE__ */ jsxRuntime.jsxs("section", { "aria-labelledby": `${headingId}-workflow`, children: [
               /* @__PURE__ */ jsxRuntime.jsx("h2", { id: `${headingId}-workflow`, className: SECTION_HEADING, children: "How it works" }),
+              /* @__PURE__ */ jsxRuntime.jsx(WorkflowNotice, {}),
               /* @__PURE__ */ jsxRuntime.jsx("ol", { role: "list", className: "mt-4 space-y-4", children: concept.workflow.map((step, index) => /* @__PURE__ */ jsxRuntime.jsxs(
                 "li",
                 {
@@ -19053,6 +19079,7 @@ exports.Button = Button;
 exports.CONCEPTS_PATH = CONCEPTS_PATH;
 exports.CONCEPT_ILLUSTRATION_NOTICE = CONCEPT_ILLUSTRATION_NOTICE;
 exports.CONCEPT_PATH_PREFIX = CONCEPT_PATH_PREFIX;
+exports.CONCEPT_WORKFLOW_NOTICE = CONCEPT_WORKFLOW_NOTICE;
 exports.CareersApplyForm = CareersApplyForm;
 exports.CareersSubmissionForm = CareersSubmissionForm;
 exports.CaseStudiesListPage = CaseStudiesListPage;