@aglyn/shared-ui-jsx 1.0.0-beta.221 → 1.0.0-beta.223

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/shared-ui-jsx",
-  "version": "1.0.0-beta.221",
+  "version": "1.0.0-beta.223",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -25,10 +25,10 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/shared-data-mdi": "1.0.0-beta.221",
-    "@aglyn/shared-ui-theme": "1.0.0-beta.221",
-    "@aglyn/shared-util-tools": "1.0.0-beta.221",
-    "@aglyn/shared-util-vendor": "1.0.0-beta.221",
+    "@aglyn/shared-data-mdi": "1.0.0-beta.223",
+    "@aglyn/shared-ui-theme": "1.0.0-beta.223",
+    "@aglyn/shared-util-tools": "1.0.0-beta.223",
+    "@aglyn/shared-util-vendor": "1.0.0-beta.223",
     "@mdi/js": "^7.4.47",
     "@swc/helpers": "0.5.23",
     "change-case": "^5.4.4",

package/src/lib/components/usage-meter.component.d.ts

@@ -18,6 +18,18 @@ export interface UsageMeterProps {
     /** Where "Upgrade" points once the meter warns; the plans anchor by default. */
     upgradeHref?: string;
 }
+/** The share of a limit at which a meter turns amber and offers the upgrade. */
+export declare const USAGE_METER_WARNING_PCT = 80;
+/** A meter's bar color: the plan's own, amber once it nears the limit, red at it. */
+export type UsageMeterTone = 'primary' | 'warning' | 'error';
+/**
+ * The tone a meter at `percent` of its limit is drawn in.
+ *
+ * Exported so a readout drawn somewhere other than this row warns at the same
+ * point as every meter on the Billing page, rather than at a threshold of its
+ * own.
+ */
+export declare function usageMeterTone(percent: number): UsageMeterTone;
 /**
  * One quota meter: used/limit progress with warning at ≥80%, error at the
  * cap, an "Upgrade" link once warning, "Unlimited" for uncapped plans, and

package/src/lib/components/usage-meter.component.js

@@ -18,6 +18,18 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { LinearProgress, Link, Stack, Typography } from "@mui/material";
 import { HelpTip } from "./help-tip.component.js";
+/** The share of a limit at which a meter turns amber and offers the upgrade. */ export const USAGE_METER_WARNING_PCT = 80;
+/**
+ * The tone a meter at `percent` of its limit is drawn in.
+ *
+ * Exported so a readout drawn somewhere other than this row warns at the same
+ * point as every meter on the Billing page, rather than at a threshold of its
+ * own.
+ */ export function usageMeterTone(percent) {
+    if (!Number.isFinite(percent)) return 'primary';
+    if (percent >= 100) return 'error';
+    return percent >= USAGE_METER_WARNING_PCT ? 'warning' : 'primary';
+}
 function formatLimit(limit, unit, unlimited) {
     if (unlimited) return 'Unlimited';
     return unit ? `${limit} ${unit}` : String(limit);
@@ -34,7 +46,7 @@ function formatLimit(limit, unit, unlimited) {
     const unlimited = props.unlimited === true;
     const unmetered = used == null;
     const pct = unlimited || unmetered || limit <= 0 ? 0 : Math.min(100, used / limit * 100);
-    const warning = !unlimited && !unmetered && pct >= 80;
+    const warning = !unlimited && !unmetered && pct >= USAGE_METER_WARNING_PCT;
     return /*#__PURE__*/ _jsxs(Stack, {
         spacing: 0.5,
         sx: {
@@ -82,7 +94,7 @@ function formatLimit(limit, unit, unlimited) {
             unlimited || unmetered ? null : /*#__PURE__*/ _jsx(LinearProgress, {
                 variant: "determinate",
                 value: pct,
-                color: pct >= 100 ? 'error' : warning ? 'warning' : 'primary'
+                color: usageMeterTone(pct)
             })
         ]
     });

package/src/lib/components/usage-meter.component.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../libs/shared/ui/jsx/src/lib/components/usage-meter.component.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 { LinearProgress, Link, Stack, Typography } from '@mui/material'\nimport { HelpTip, type HelpTipContent } from './help-tip.component'\n\nexport interface UsageMeterProps {\n  label: string\n  /** `null` while the usage source has not answered — \"not yet metered\". */\n  used: number | null\n  limit: number\n  unit?: string\n  /** True when the plan caps nothing here; the bar is omitted and the limit reads \"Unlimited\". */\n  unlimited?: boolean\n  /**\n   * Optional help affordance beside the label.\n   *\n   * A meter is a number against a limit and says nothing about what happens\n   * when the two meet — which for bandwidth is the whole question, and is\n   * different on Free (the site pauses) than on a paid plan (the extra bills).\n   */\n  help?: HelpTipContent\n  /** Where \"Upgrade\" points once the meter warns; the plans anchor by default. */\n  upgradeHref?: string\n}\n\nfunction formatLimit(limit: number, unit: string | undefined, unlimited: boolean): string {\n  if (unlimited) return 'Unlimited'\n  return unit ? `${limit} ${unit}` : String(limit)\n}\n\n/**\n * One quota meter: used/limit progress with warning at ≥80%, error at the\n * cap, an \"Upgrade\" link once warning, \"Unlimited\" for uncapped plans, and\n * a \"not yet metered\" state for usage sources that have not answered.\n *\n * Shared (AGL-2939) so a plugin's own meter — the AI credits band — draws\n * beside the platform's on the same terms rather than as a lookalike.\n */\nexport function UsageMeter(props: UsageMeterProps) {\n  const { label, used, limit, unit, help, upgradeHref = '#plans' } = props\n  const unlimited = props.unlimited === true\n  const unmetered = used == null\n  const pct =\n    unlimited || unmetered || limit <= 0 ? 0 : Math.min(100, (used / limit) * 100)\n  const warning = !unlimited && !unmetered && pct >= 80\n  return (\n    <Stack spacing={0.5} sx={{ mb: 2 }}>\n      <Stack direction=\"row\" sx={{ justifyContent: 'space-between' }}>\n        {/*\n          The tip renders INSIDE the label, not beside it in a wrapper: the\n          console's meter specs find a meter by `getByText(label).parentElement`\n          and read the row's text from it, and a wrapper would make that\n          parent the wrapper, whose text is the label alone.\n        */}\n        <Typography variant=\"body2\">\n          {label}\n          {help ? <HelpTip {...help} sx={{ ml: 0.5, fontSize: '0.8em' }} /> : null}\n        </Typography>\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {unmetered\n            ? `not yet metered · limit ${formatLimit(limit, unit, unlimited)}`\n            : `${used} / ${formatLimit(limit, unit, unlimited)}`}\n          {warning ? (\n            <>\n              {' · '}\n              <Link href={upgradeHref} color=\"primary\" underline=\"hover\">\n                {'Upgrade'}\n              </Link>\n            </>\n          ) : null}\n        </Typography>\n      </Stack>\n      {unlimited || unmetered ? null : (\n        <LinearProgress\n          variant=\"determinate\"\n          value={pct}\n          color={pct >= 100 ? 'error' : warning ? 'warning' : 'primary'}\n        />\n      )}\n    </Stack>\n  )\n}\n\nexport default UsageMeter\n"],"names":["LinearProgress","Link","Stack","Typography","HelpTip","formatLimit","limit","unit","unlimited","String","UsageMeter","props","label","used","help","upgradeHref","unmetered","pct","Math","min","warning","spacing","sx","mb","direction","justifyContent","variant","ml","fontSize","color","href","underline","value"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;;AAEA,SAASA,cAAc,EAAEC,IAAI,EAAEC,KAAK,EAAEC,UAAU,QAAQ,gBAAe;AACvE,SAASC,OAAO,QAA6B,0BAAsB;AAsBnE,SAASC,YAAYC,KAAa,EAAEC,IAAwB,EAAEC,SAAkB;IAC9E,IAAIA,WAAW,OAAO;IACtB,OAAOD,OAAO,GAAGD,MAAM,CAAC,EAAEC,MAAM,GAAGE,OAAOH;AAC5C;AAEA;;;;;;;CAOC,GACD,OAAO,SAASI,WAAWC,KAAsB;IAC/C,MAAM,EAAEC,KAAK,EAAEC,IAAI,EAAEP,KAAK,EAAEC,IAAI,EAAEO,IAAI,EAAEC,cAAc,QAAQ,EAAE,GAAGJ;IACnE,MAAMH,YAAYG,MAAMH,SAAS,KAAK;IACtC,MAAMQ,YAAYH,QAAQ;IAC1B,MAAMI,MACJT,aAAaQ,aAAaV,SAAS,IAAI,IAAIY,KAAKC,GAAG,CAAC,KAAK,AAACN,OAAOP,QAAS;IAC5E,MAAMc,UAAU,CAACZ,aAAa,CAACQ,aAAaC,OAAO;IACnD,qBACE,MAACf;QAAMmB,SAAS;QAAKC,IAAI;YAAEC,IAAI;QAAE;;0BAC/B,MAACrB;gBAAMsB,WAAU;gBAAMF,IAAI;oBAAEG,gBAAgB;gBAAgB;;kCAO3D,MAACtB;wBAAWuB,SAAQ;;4BACjBd;4BACAE,qBAAO,KAACV,sBAAYU;gCAAMQ,IAAI;oCAAEK,IAAI;oCAAKC,UAAU;gCAAQ;kCAAQ;;;kCAEtE,MAACzB;wBAAWuB,SAAQ;wBAAQG,OAAM;;4BAC/Bb,YACG,CAAC,wBAAwB,EAAEX,YAAYC,OAAOC,MAAMC,YAAY,GAChE,GAAGK,KAAK,GAAG,EAAER,YAAYC,OAAOC,MAAMC,YAAY;4BACrDY,wBACC;;oCACG;kDACD,KAACnB;wCAAK6B,MAAMf;wCAAac,OAAM;wCAAUE,WAAU;kDAChD;;;iCAGH;;;;;YAGPvB,aAAaQ,YAAY,qBACxB,KAAChB;gBACC0B,SAAQ;gBACRM,OAAOf;gBACPY,OAAOZ,OAAO,MAAM,UAAUG,UAAU,YAAY;;;;AAK9D;AAEA,eAAeV,WAAU"}
+{"version":3,"sources":["../../../../../../../../libs/shared/ui/jsx/src/lib/components/usage-meter.component.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 { LinearProgress, Link, Stack, Typography } from '@mui/material'\nimport { HelpTip, type HelpTipContent } from './help-tip.component'\n\nexport interface UsageMeterProps {\n  label: string\n  /** `null` while the usage source has not answered — \"not yet metered\". */\n  used: number | null\n  limit: number\n  unit?: string\n  /** True when the plan caps nothing here; the bar is omitted and the limit reads \"Unlimited\". */\n  unlimited?: boolean\n  /**\n   * Optional help affordance beside the label.\n   *\n   * A meter is a number against a limit and says nothing about what happens\n   * when the two meet — which for bandwidth is the whole question, and is\n   * different on Free (the site pauses) than on a paid plan (the extra bills).\n   */\n  help?: HelpTipContent\n  /** Where \"Upgrade\" points once the meter warns; the plans anchor by default. */\n  upgradeHref?: string\n}\n\n/** The share of a limit at which a meter turns amber and offers the upgrade. */\nexport const USAGE_METER_WARNING_PCT = 80\n\n/** A meter's bar color: the plan's own, amber once it nears the limit, red at it. */\nexport type UsageMeterTone = 'primary' | 'warning' | 'error'\n\n/**\n * The tone a meter at `percent` of its limit is drawn in.\n *\n * Exported so a readout drawn somewhere other than this row warns at the same\n * point as every meter on the Billing page, rather than at a threshold of its\n * own.\n */\nexport function usageMeterTone(percent: number): UsageMeterTone {\n  if (!Number.isFinite(percent)) return 'primary'\n  if (percent >= 100) return 'error'\n  return percent >= USAGE_METER_WARNING_PCT ? 'warning' : 'primary'\n}\n\nfunction formatLimit(limit: number, unit: string | undefined, unlimited: boolean): string {\n  if (unlimited) return 'Unlimited'\n  return unit ? `${limit} ${unit}` : String(limit)\n}\n\n/**\n * One quota meter: used/limit progress with warning at ≥80%, error at the\n * cap, an \"Upgrade\" link once warning, \"Unlimited\" for uncapped plans, and\n * a \"not yet metered\" state for usage sources that have not answered.\n *\n * Shared (AGL-2939) so a plugin's own meter — the AI credits band — draws\n * beside the platform's on the same terms rather than as a lookalike.\n */\nexport function UsageMeter(props: UsageMeterProps) {\n  const { label, used, limit, unit, help, upgradeHref = '#plans' } = props\n  const unlimited = props.unlimited === true\n  const unmetered = used == null\n  const pct =\n    unlimited || unmetered || limit <= 0 ? 0 : Math.min(100, (used / limit) * 100)\n  const warning = !unlimited && !unmetered && pct >= USAGE_METER_WARNING_PCT\n  return (\n    <Stack spacing={0.5} sx={{ mb: 2 }}>\n      <Stack direction=\"row\" sx={{ justifyContent: 'space-between' }}>\n        {/*\n          The tip renders INSIDE the label, not beside it in a wrapper: the\n          console's meter specs find a meter by `getByText(label).parentElement`\n          and read the row's text from it, and a wrapper would make that\n          parent the wrapper, whose text is the label alone.\n        */}\n        <Typography variant=\"body2\">\n          {label}\n          {help ? <HelpTip {...help} sx={{ ml: 0.5, fontSize: '0.8em' }} /> : null}\n        </Typography>\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {unmetered\n            ? `not yet metered · limit ${formatLimit(limit, unit, unlimited)}`\n            : `${used} / ${formatLimit(limit, unit, unlimited)}`}\n          {warning ? (\n            <>\n              {' · '}\n              <Link href={upgradeHref} color=\"primary\" underline=\"hover\">\n                {'Upgrade'}\n              </Link>\n            </>\n          ) : null}\n        </Typography>\n      </Stack>\n      {unlimited || unmetered ? null : (\n        <LinearProgress\n          variant=\"determinate\"\n          value={pct}\n          color={usageMeterTone(pct)}\n        />\n      )}\n    </Stack>\n  )\n}\n\nexport default UsageMeter\n"],"names":["LinearProgress","Link","Stack","Typography","HelpTip","USAGE_METER_WARNING_PCT","usageMeterTone","percent","Number","isFinite","formatLimit","limit","unit","unlimited","String","UsageMeter","props","label","used","help","upgradeHref","unmetered","pct","Math","min","warning","spacing","sx","mb","direction","justifyContent","variant","ml","fontSize","color","href","underline","value"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;;AAEA,SAASA,cAAc,EAAEC,IAAI,EAAEC,KAAK,EAAEC,UAAU,QAAQ,gBAAe;AACvE,SAASC,OAAO,QAA6B,0BAAsB;AAsBnE,8EAA8E,GAC9E,OAAO,MAAMC,0BAA0B,GAAE;AAKzC;;;;;;CAMC,GACD,OAAO,SAASC,eAAeC,OAAe;IAC5C,IAAI,CAACC,OAAOC,QAAQ,CAACF,UAAU,OAAO;IACtC,IAAIA,WAAW,KAAK,OAAO;IAC3B,OAAOA,WAAWF,0BAA0B,YAAY;AAC1D;AAEA,SAASK,YAAYC,KAAa,EAAEC,IAAwB,EAAEC,SAAkB;IAC9E,IAAIA,WAAW,OAAO;IACtB,OAAOD,OAAO,GAAGD,MAAM,CAAC,EAAEC,MAAM,GAAGE,OAAOH;AAC5C;AAEA;;;;;;;CAOC,GACD,OAAO,SAASI,WAAWC,KAAsB;IAC/C,MAAM,EAAEC,KAAK,EAAEC,IAAI,EAAEP,KAAK,EAAEC,IAAI,EAAEO,IAAI,EAAEC,cAAc,QAAQ,EAAE,GAAGJ;IACnE,MAAMH,YAAYG,MAAMH,SAAS,KAAK;IACtC,MAAMQ,YAAYH,QAAQ;IAC1B,MAAMI,MACJT,aAAaQ,aAAaV,SAAS,IAAI,IAAIY,KAAKC,GAAG,CAAC,KAAK,AAACN,OAAOP,QAAS;IAC5E,MAAMc,UAAU,CAACZ,aAAa,CAACQ,aAAaC,OAAOjB;IACnD,qBACE,MAACH;QAAMwB,SAAS;QAAKC,IAAI;YAAEC,IAAI;QAAE;;0BAC/B,MAAC1B;gBAAM2B,WAAU;gBAAMF,IAAI;oBAAEG,gBAAgB;gBAAgB;;kCAO3D,MAAC3B;wBAAW4B,SAAQ;;4BACjBd;4BACAE,qBAAO,KAACf,sBAAYe;gCAAMQ,IAAI;oCAAEK,IAAI;oCAAKC,UAAU;gCAAQ;kCAAQ;;;kCAEtE,MAAC9B;wBAAW4B,SAAQ;wBAAQG,OAAM;;4BAC/Bb,YACG,CAAC,wBAAwB,EAAEX,YAAYC,OAAOC,MAAMC,YAAY,GAChE,GAAGK,KAAK,GAAG,EAAER,YAAYC,OAAOC,MAAMC,YAAY;4BACrDY,wBACC;;oCACG;kDACD,KAACxB;wCAAKkC,MAAMf;wCAAac,OAAM;wCAAUE,WAAU;kDAChD;;;iCAGH;;;;;YAGPvB,aAAaQ,YAAY,qBACxB,KAACrB;gBACC+B,SAAQ;gBACRM,OAAOf;gBACPY,OAAO5B,eAAegB;;;;AAKhC;AAEA,eAAeP,WAAU"}

package/src/lib/hooks/use-soft-get-submit.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @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.
+ */
+import { type FormEvent } from 'react';
+/**
+ * The URL a `method="get"` form would load, or `null` when the submit should
+ * be left to the browser: a POST, a `target` other than this window, or an
+ * action on another origin, none of which the client router can stand in for.
+ *
+ * Built the way the browser builds it — the action's own query string is
+ * REPLACED by the form's fields, not merged with them — so the soft
+ * navigation lands on exactly the page a full load would have.
+ */
+export declare const softGetSubmitHref: (form: HTMLFormElement, submitter?: HTMLElement | null) => string | null;
+/**
+ * An `onSubmit` for a plain GET form that navigates with the Next router
+ * instead of reloading the document.
+ *
+ * The form keeps its `action` and `method`, so it still works before
+ * hydration and with scripting off — this only takes over once React is
+ * listening, the same progressive enhancement `AppLink` gives an `<a>`.
+ *
+ * The router is read from its context rather than through `useRouter`,
+ * which throws when no App Router is mounted. Site elements render in
+ * places that have none (component specs, axe sweeps, server-rendered
+ * previews), and there the submit stays the browser's.
+ */
+export declare const useSoftGetSubmit: () => (event: FormEvent<HTMLFormElement>) => void;

package/src/lib/hooks/use-soft-get-submit.js

@@ -0,0 +1,69 @@
+/**
+ * @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 { AppRouterContext } from "next/dist/shared/lib/app-router-context.shared-runtime";
+import { useCallback, useContext } from "react";
+/**
+ * The URL a `method="get"` form would load, or `null` when the submit should
+ * be left to the browser: a POST, a `target` other than this window, or an
+ * action on another origin, none of which the client router can stand in for.
+ *
+ * Built the way the browser builds it — the action's own query string is
+ * REPLACED by the form's fields, not merged with them — so the soft
+ * navigation lands on exactly the page a full load would have.
+ */ export const softGetSubmitHref = (form, submitter)=>{
+    var _form_getAttribute;
+    if (((_form_getAttribute = form.getAttribute('method')) != null ? _form_getAttribute : 'get').toLowerCase() !== 'get') {
+        return null;
+    }
+    const target = form.getAttribute('target');
+    if (target && target !== '_self') return null;
+    const url = new URL(form.action, window.location.href);
+    if (url.origin !== window.location.origin) return null;
+    const params = new URLSearchParams();
+    for (const [name, value] of new FormData(form, submitter != null ? submitter : null)){
+        if (typeof value === 'string') params.append(name, value);
+    }
+    const search = params.toString();
+    return `${url.pathname}${search ? `?${search}` : ''}`;
+};
+/**
+ * An `onSubmit` for a plain GET form that navigates with the Next router
+ * instead of reloading the document.
+ *
+ * The form keeps its `action` and `method`, so it still works before
+ * hydration and with scripting off — this only takes over once React is
+ * listening, the same progressive enhancement `AppLink` gives an `<a>`.
+ *
+ * The router is read from its context rather than through `useRouter`,
+ * which throws when no App Router is mounted. Site elements render in
+ * places that have none (component specs, axe sweeps, server-rendered
+ * previews), and there the submit stays the browser's.
+ */ export const useSoftGetSubmit = ()=>{
+    const router = useContext(AppRouterContext);
+    return useCallback((event)=>{
+        if (!router || event.defaultPrevented) return;
+        const submitter = event.nativeEvent.submitter;
+        const href = softGetSubmitHref(event.currentTarget, submitter);
+        if (!href) return;
+        event.preventDefault();
+        router.push(href);
+    }, [
+        router
+    ]);
+};
+
+//# sourceMappingURL=use-soft-get-submit.js.map

package/src/lib/hooks/use-soft-get-submit.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/ui/jsx/src/lib/hooks/use-soft-get-submit.ts"],"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\n'use client'\n\nimport { AppRouterContext } from 'next/dist/shared/lib/app-router-context.shared-runtime'\nimport { type FormEvent, useCallback, useContext } from 'react'\n\n/**\n * The URL a `method=\"get\"` form would load, or `null` when the submit should\n * be left to the browser: a POST, a `target` other than this window, or an\n * action on another origin, none of which the client router can stand in for.\n *\n * Built the way the browser builds it — the action's own query string is\n * REPLACED by the form's fields, not merged with them — so the soft\n * navigation lands on exactly the page a full load would have.\n */\nexport const softGetSubmitHref = (\n  form: HTMLFormElement,\n  submitter?: HTMLElement | null,\n): string | null => {\n  if ((form.getAttribute('method') ?? 'get').toLowerCase() !== 'get') {\n    return null\n  }\n  const target = form.getAttribute('target')\n  if (target && target !== '_self') return null\n  const url = new URL(form.action, window.location.href)\n  if (url.origin !== window.location.origin) return null\n  const params = new URLSearchParams()\n  for (const [name, value] of new FormData(form, submitter ?? null)) {\n    if (typeof value === 'string') params.append(name, value)\n  }\n  const search = params.toString()\n  return `${url.pathname}${search ? `?${search}` : ''}`\n}\n\n/**\n * An `onSubmit` for a plain GET form that navigates with the Next router\n * instead of reloading the document.\n *\n * The form keeps its `action` and `method`, so it still works before\n * hydration and with scripting off — this only takes over once React is\n * listening, the same progressive enhancement `AppLink` gives an `<a>`.\n *\n * The router is read from its context rather than through `useRouter`,\n * which throws when no App Router is mounted. Site elements render in\n * places that have none (component specs, axe sweeps, server-rendered\n * previews), and there the submit stays the browser's.\n */\nexport const useSoftGetSubmit = () => {\n  const router = useContext(AppRouterContext)\n  return useCallback(\n    (event: FormEvent<HTMLFormElement>) => {\n      if (!router || event.defaultPrevented) return\n      const submitter = (event.nativeEvent as SubmitEvent).submitter\n      const href = softGetSubmitHref(event.currentTarget, submitter)\n      if (!href) return\n      event.preventDefault()\n      router.push(href)\n    },\n    [router],\n  )\n}\n"],"names":["AppRouterContext","useCallback","useContext","softGetSubmitHref","form","submitter","getAttribute","toLowerCase","target","url","URL","action","window","location","href","origin","params","URLSearchParams","name","value","FormData","append","search","toString","pathname","useSoftGetSubmit","router","event","defaultPrevented","nativeEvent","currentTarget","preventDefault","push"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;AAEA,SAASA,gBAAgB,QAAQ,yDAAwD;AACzF,SAAyBC,WAAW,EAAEC,UAAU,QAAQ,QAAO;AAE/D;;;;;;;;CAQC,GACD,OAAO,MAAMC,oBAAoB,CAC/BC,MACAC;QAEKD;IAAL,IAAI,EAACA,qBAAAA,KAAKE,YAAY,CAAC,qBAAlBF,qBAA+B,OAAOG,WAAW,OAAO,OAAO;QAClE,OAAO;IACT;IACA,MAAMC,SAASJ,KAAKE,YAAY,CAAC;IACjC,IAAIE,UAAUA,WAAW,SAAS,OAAO;IACzC,MAAMC,MAAM,IAAIC,IAAIN,KAAKO,MAAM,EAAEC,OAAOC,QAAQ,CAACC,IAAI;IACrD,IAAIL,IAAIM,MAAM,KAAKH,OAAOC,QAAQ,CAACE,MAAM,EAAE,OAAO;IAClD,MAAMC,SAAS,IAAIC;IACnB,KAAK,MAAM,CAACC,MAAMC,MAAM,IAAI,IAAIC,SAAShB,MAAMC,oBAAAA,YAAa,MAAO;QACjE,IAAI,OAAOc,UAAU,UAAUH,OAAOK,MAAM,CAACH,MAAMC;IACrD;IACA,MAAMG,SAASN,OAAOO,QAAQ;IAC9B,OAAO,GAAGd,IAAIe,QAAQ,GAAGF,SAAS,CAAC,CAAC,EAAEA,QAAQ,GAAG,IAAI;AACvD,EAAC;AAED;;;;;;;;;;;;CAYC,GACD,OAAO,MAAMG,mBAAmB;IAC9B,MAAMC,SAASxB,WAAWF;IAC1B,OAAOC,YACL,CAAC0B;QACC,IAAI,CAACD,UAAUC,MAAMC,gBAAgB,EAAE;QACvC,MAAMvB,YAAY,AAACsB,MAAME,WAAW,CAAiBxB,SAAS;QAC9D,MAAMS,OAAOX,kBAAkBwB,MAAMG,aAAa,EAAEzB;QACpD,IAAI,CAACS,MAAM;QACXa,MAAMI,cAAc;QACpBL,OAAOM,IAAI,CAAClB;IACd,GACA;QAACY;KAAO;AAEZ,EAAC"}