@homebound/beam 4.12.0 → 4.12.1

package/dist/index.d.cts

@@ -10965,10 +10965,12 @@ type FormSectionLayoutProps = {
     /** When true, wraps in {@link AiCard} and applies AI title styling. */
     aiMode?: boolean;
     /**
-     * When true, show a JumpLinks rail from section titles (needs 2+ includable sections; hidden on `sm`).
+     * When true, show a JumpLinks rail from section titles (needs 2+ includable links; hidden on `sm`).
      * Default false — opt in for FocusedForm / Stepper form steps that want the rail.
      */
     withJumpLinks?: boolean;
+    /** When true with `withJumpLinks`, prepend the form `title` as the first rail link. */
+    includeTitleJumpLink?: boolean;
     /**
      * Opt into the document-scroll detail pane (`useRightPane`).
      * Hosts JumpLinks + form — do not also set `withRightPane` on the inner `CenteredLayout`.

package/dist/index.d.ts

@@ -10965,10 +10965,12 @@ type FormSectionLayoutProps = {
     /** When true, wraps in {@link AiCard} and applies AI title styling. */
     aiMode?: boolean;
     /**
-     * When true, show a JumpLinks rail from section titles (needs 2+ includable sections; hidden on `sm`).
+     * When true, show a JumpLinks rail from section titles (needs 2+ includable links; hidden on `sm`).
      * Default false — opt in for FocusedForm / Stepper form steps that want the rail.
      */
     withJumpLinks?: boolean;
+    /** When true with `withJumpLinks`, prepend the form `title` as the first rail link. */
+    includeTitleJumpLink?: boolean;
     /**
      * Opt into the document-scroll detail pane (`useRightPane`).
      * Hosts JumpLinks + form — do not also set `withRightPane` on the inner `CenteredLayout`.

package/dist/index.js

@@ -29081,6 +29081,7 @@ function FormSectionLayout(props) {
     sections,
     aiMode = false,
     withJumpLinks = false,
+    includeTitleJumpLink = false,
     withRightPane
   } = props;
   const tid = useTestIds(props, "formSectionLayout");
@@ -29088,13 +29089,19 @@ function FormSectionLayout(props) {
     sm: isMobile
   } = useBreakpoint();
   const rightPane = resolveWithRightPaneOptions(withRightPane);
-  const jumpLinks = (sections ?? []).filter((section) => !section.excludeJumpLink).map((section) => {
+  const formSectionLayoutTitleId = "formSectionLayoutTitle";
+  const sectionLinks = (sections ?? []).filter((section) => !section.excludeJumpLink).map((section) => {
     const id = defaultTestId(section.title);
     return {
       id,
       label: section.title
     };
   });
+  const titleAnchor = withJumpLinks && includeTitleJumpLink;
+  const jumpLinks = [...titleAnchor ? [{
+    id: formSectionLayoutTitleId,
+    label: title
+  }] : [], ...sectionLinks];
   const showRail = withJumpLinks && jumpLinks.length >= 2 && !isMobile;
   const activeId = useActiveJumpLink(showRail ? jumpLinks.map((link) => link.id) : []);
   const content2 = /* @__PURE__ */ jsxs123("div", { ...trussProps134({
@@ -29108,7 +29115,16 @@ function FormSectionLayout(props) {
       paddingLeft: "pl3"
     } : {}
   }), children: [
-    /* @__PURE__ */ jsxs123("div", { className: "df fdc g_3", children: [
+    /* @__PURE__ */ jsxs123("div", { id: titleAnchor ? formSectionLayoutTitleId : void 0, ...trussProps134({
+      display: "df",
+      flexDirection: "fdc",
+      gap: "g_3",
+      ...titleAnchor ? {
+        scrollMarginTop: ["scrollMarginTop_var", {
+          "--scrollMarginTop": maybeCssVar67(stickyNavAndHeaderOffset())
+        }]
+      } : {}
+    }), children: [
       /* @__PURE__ */ jsx230(ContentHeader, { ...tid, title, description, actions, withAutoSave, level: 2, aiMode }),
       initialFields
     ] }),