@aglyn/shared-ui-jsx 1.0.0-beta.150 → 1.0.0-beta.151

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/shared-ui-jsx",
-  "version": "1.0.0-beta.150",
+  "version": "1.0.0-beta.151",
   "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.150",
-    "@aglyn/shared-ui-theme": "1.0.0-beta.150",
-    "@aglyn/shared-util-tools": "1.0.0-beta.150",
-    "@aglyn/shared-util-vendor": "1.0.0-beta.150",
+    "@aglyn/shared-data-mdi": "1.0.0-beta.151",
+    "@aglyn/shared-ui-theme": "1.0.0-beta.151",
+    "@aglyn/shared-util-tools": "1.0.0-beta.151",
+    "@aglyn/shared-util-vendor": "1.0.0-beta.151",
     "@mdi/js": "^7.4.47",
     "@swc/helpers": "0.5.23",
     "change-case": "^5.4.4",

package/src/lib/components/blocked-control.component.d.ts

@@ -0,0 +1,52 @@
+import { type ReactElement } from 'react';
+export interface BlockedControlProps {
+    /**
+     * Whether the viewer's standing is RESOLVED and refused. Never true while
+     * a claim is still loading: rendering the refusal in that window flashes a
+     * disabled button at everybody, including the people who may use it.
+     */
+    blocked: boolean;
+    /** Why, in one sentence. Shown on hover, and to a screen reader. */
+    reason: string;
+    /**
+     * A single control that accepts a `disabled` prop — MUI's Button,
+     * IconButton, Switch, TextField and friends all do.
+     */
+    children: ReactElement<{
+        disabled?: boolean;
+    }>;
+}
+/**
+ * Renders a control disabled with the reason attached, or passes it through
+ * untouched.
+ *
+ * DISABLED WITH THE REASON, NOT HIDDEN. Both are defensible and the choice is
+ * made here once rather than at every gate. Hiding leaves a reader unable to
+ * see that the capability exists at all, and the commonest support act is
+ * routing — "this needs someone with the super role" is an answer they can
+ * give in one message; "I see no such button" turns into an investigation of
+ * whether the feature shipped.
+ *
+ * ## Two details that are the whole reason this is shared
+ *
+ * The tooltip wraps a `span`, not the control: MUI does not fire pointer
+ * events on a disabled button, so a tooltip attached directly to one never
+ * appears — which would leave a dead button and no reason at all, the exact
+ * failure this exists to stop.
+ *
+ * And the reason lands on the span as a real `aria-label` and `title`, not
+ * only inside the Tooltip's popper. An explanation that appears only on
+ * hover says nothing to a screen reader and nothing on a touch device.
+ *
+ * Both were got right once and then copied; AGL-2113 is the precedent for
+ * what copies do — five quota readouts grew their own phrasing and stopped
+ * agreeing. THIS IS NOT A SECURITY BOUNDARY: the server refuses regardless
+ * of what rendered. It exists so a console stops promising what the server
+ * will refuse.
+ */
+export declare function BlockedControl({ blocked, reason, children }: BlockedControlProps): import("react").JSX.Element;
+export declare namespace BlockedControl {
+    var displayName: string;
+    var aglyn: boolean;
+}
+export default BlockedControl;

package/src/lib/components/blocked-control.component.js

@@ -0,0 +1,68 @@
+/**
+ * @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 { jsx as _jsx } from "react/jsx-runtime";
+import { Box, Tooltip } from "@mui/material";
+import { cloneElement, isValidElement } from "react";
+/**
+ * Renders a control disabled with the reason attached, or passes it through
+ * untouched.
+ *
+ * DISABLED WITH THE REASON, NOT HIDDEN. Both are defensible and the choice is
+ * made here once rather than at every gate. Hiding leaves a reader unable to
+ * see that the capability exists at all, and the commonest support act is
+ * routing — "this needs someone with the super role" is an answer they can
+ * give in one message; "I see no such button" turns into an investigation of
+ * whether the feature shipped.
+ *
+ * ## Two details that are the whole reason this is shared
+ *
+ * The tooltip wraps a `span`, not the control: MUI does not fire pointer
+ * events on a disabled button, so a tooltip attached directly to one never
+ * appears — which would leave a dead button and no reason at all, the exact
+ * failure this exists to stop.
+ *
+ * And the reason lands on the span as a real `aria-label` and `title`, not
+ * only inside the Tooltip's popper. An explanation that appears only on
+ * hover says nothing to a screen reader and nothing on a touch device.
+ *
+ * Both were got right once and then copied; AGL-2113 is the precedent for
+ * what copies do — five quota readouts grew their own phrasing and stopped
+ * agreeing. THIS IS NOT A SECURITY BOUNDARY: the server refuses regardless
+ * of what rendered. It exists so a console stops promising what the server
+ * will refuse.
+ */ export function BlockedControl({ blocked, reason, children }) {
+    if (!blocked || !/*#__PURE__*/ isValidElement(children)) return children;
+    return /*#__PURE__*/ _jsx(Tooltip, {
+        title: reason,
+        children: /*#__PURE__*/ _jsx(Box, {
+            component: "span",
+            "aria-label": reason,
+            title: reason,
+            sx: {
+                display: 'inline-flex'
+            },
+            children: /*#__PURE__*/ cloneElement(children, {
+                disabled: true
+            })
+        })
+    });
+}
+BlockedControl.displayName = 'BlockedControl';
+BlockedControl.aglyn = true;
+export default BlockedControl;
+
+//# sourceMappingURL=blocked-control.component.js.map

package/src/lib/components/blocked-control.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/ui/jsx/src/lib/components/blocked-control.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 { Box, Tooltip } from '@mui/material'\nimport { cloneElement, isValidElement, type ReactElement } from 'react'\n\nexport interface BlockedControlProps {\n  /**\n   * Whether the viewer's standing is RESOLVED and refused. Never true while\n   * a claim is still loading: rendering the refusal in that window flashes a\n   * disabled button at everybody, including the people who may use it.\n   */\n  blocked: boolean\n  /** Why, in one sentence. Shown on hover, and to a screen reader. */\n  reason: string\n  /**\n   * A single control that accepts a `disabled` prop — MUI's Button,\n   * IconButton, Switch, TextField and friends all do.\n   */\n  children: ReactElement<{ disabled?: boolean }>\n}\n\n/**\n * Renders a control disabled with the reason attached, or passes it through\n * untouched.\n *\n * DISABLED WITH THE REASON, NOT HIDDEN. Both are defensible and the choice is\n * made here once rather than at every gate. Hiding leaves a reader unable to\n * see that the capability exists at all, and the commonest support act is\n * routing — \"this needs someone with the super role\" is an answer they can\n * give in one message; \"I see no such button\" turns into an investigation of\n * whether the feature shipped.\n *\n * ## Two details that are the whole reason this is shared\n *\n * The tooltip wraps a `span`, not the control: MUI does not fire pointer\n * events on a disabled button, so a tooltip attached directly to one never\n * appears — which would leave a dead button and no reason at all, the exact\n * failure this exists to stop.\n *\n * And the reason lands on the span as a real `aria-label` and `title`, not\n * only inside the Tooltip's popper. An explanation that appears only on\n * hover says nothing to a screen reader and nothing on a touch device.\n *\n * Both were got right once and then copied; AGL-2113 is the precedent for\n * what copies do — five quota readouts grew their own phrasing and stopped\n * agreeing. THIS IS NOT A SECURITY BOUNDARY: the server refuses regardless\n * of what rendered. It exists so a console stops promising what the server\n * will refuse.\n */\nexport function BlockedControl({ blocked, reason, children }: BlockedControlProps) {\n  if (!blocked || !isValidElement(children)) return children\n  return (\n    <Tooltip title={reason}>\n      <Box\n        component=\"span\"\n        aria-label={reason}\n        title={reason}\n        sx={{ display: 'inline-flex' }}\n      >\n        {cloneElement(children, { disabled: true })}\n      </Box>\n    </Tooltip>\n  )\n}\n\nBlockedControl.displayName = 'BlockedControl'\nBlockedControl.aglyn = true\n\nexport default BlockedControl\n"],"names":["Box","Tooltip","cloneElement","isValidElement","BlockedControl","blocked","reason","children","title","component","aria-label","sx","display","disabled","displayName","aglyn"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAEA,SAASA,GAAG,EAAEC,OAAO,QAAQ,gBAAe;AAC5C,SAASC,YAAY,EAAEC,cAAc,QAA2B,QAAO;AAkBvE;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BC,GACD,OAAO,SAASC,eAAe,EAAEC,OAAO,EAAEC,MAAM,EAAEC,QAAQ,EAAuB;IAC/E,IAAI,CAACF,WAAW,eAACF,eAAeI,WAAW,OAAOA;IAClD,qBACE,KAACN;QAAQO,OAAOF;kBACd,cAAA,KAACN;YACCS,WAAU;YACVC,cAAYJ;YACZE,OAAOF;YACPK,IAAI;gBAAEC,SAAS;YAAc;sBAE5BV,cAAAA,aAAaK,UAAU;gBAAEM,UAAU;YAAK;;;AAIjD;AAEAT,eAAeU,WAAW,GAAG;AAC7BV,eAAeW,KAAK,GAAG;AAEvB,eAAeX,eAAc"}