@inshorts/glint-ui 0.5.4 → 0.6.1

package/dist/feature-access-gate.cjs

@@ -0,0 +1,160 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/feature-access-gate.tsx
+var feature_access_gate_exports = {};
+__export(feature_access_gate_exports, {
+  FeatureAccessGate: () => FeatureAccessGate
+});
+module.exports = __toCommonJS(feature_access_gate_exports);
+
+// src/alert.tsx
+var React = __toESM(require("react"), 1);
+var import_class_variance_authority = require("class-variance-authority");
+
+// src/utils.ts
+var import_clsx = require("clsx");
+var import_tailwind_merge = require("tailwind-merge");
+function cn(...inputs) {
+  return (0, import_tailwind_merge.twMerge)((0, import_clsx.clsx)(inputs));
+}
+
+// src/alert.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var alertVariants = (0, import_class_variance_authority.cva)("rounded-lg border px-3 py-2 text-sm", {
+  variants: {
+    variant: {
+      danger: "border-destructive/30 bg-destructive/5 text-destructive",
+      warning: "border-warning/30 bg-warning/5 text-warning",
+      success: "border-success/30 bg-success/5 text-success",
+      info: "border-info/30 bg-info/5 text-info",
+      /**
+       * The quiet state of a banner that also has loud ones — "no default
+       * campaign set" next to "this is the default". Without it those callers
+       * keep a ternary of raw class strings and the shared component only
+       * covers half of what they draw.
+       */
+      neutral: "border-border bg-muted/40 text-muted-foreground"
+    }
+  },
+  defaultVariants: {
+    // Failure is what a banner almost always reports here, and defaulting to
+    // it means the noisy case cannot be forgotten.
+    variant: "danger"
+  }
+});
+var Alert = React.forwardRef(
+  ({ className, variant, action, children, ...props }, ref) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+    "div",
+    {
+      ref,
+      role: variant === "danger" || variant == null ? "alert" : "status",
+      className: cn(
+        alertVariants({ variant }),
+        action && "flex flex-wrap items-center justify-between gap-3",
+        className
+      ),
+      ...props,
+      children: [
+        action ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children }) : children,
+        action
+      ]
+    }
+  )
+);
+Alert.displayName = "Alert";
+
+// src/spinner.tsx
+var import_lucide_react = require("lucide-react");
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var SIZES = {
+  sm: "size-3.5",
+  md: "size-4",
+  lg: "size-5",
+  xl: "size-10 border-2"
+};
+function Spinner({ size = "md", className, ...props }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+    import_lucide_react.Loader2,
+    {
+      "aria-hidden": true,
+      className: cn("animate-spin", SIZES[size], className),
+      ...props
+    }
+  );
+}
+
+// src/state-panel.tsx
+var import_jsx_runtime3 = require("react/jsx-runtime");
+function StatePanel({
+  loading,
+  className,
+  children,
+  ...props
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+    "div",
+    {
+      role: loading ? "status" : void 0,
+      "aria-live": loading ? "polite" : void 0,
+      className: cn(
+        "border-border bg-background/80 text-muted-foreground rounded-lg border px-4 py-6 text-center text-sm",
+        loading && "flex items-center justify-center gap-2",
+        className
+      ),
+      ...props,
+      children: [
+        loading ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Spinner, { size: "md" }) : null,
+        children
+      ]
+    }
+  );
+}
+
+// src/feature-access-gate.tsx
+var import_jsx_runtime4 = require("react/jsx-runtime");
+function FeatureAccessGate({
+  isLoading,
+  allowed,
+  deniedMessage,
+  children
+}) {
+  if (isLoading) {
+    return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(StatePanel, { loading: true, className: "p-6", children: "Checking permissions\u2026" });
+  }
+  if (!allowed) {
+    return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Alert, { children: deniedMessage });
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_jsx_runtime4.Fragment, { children });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FeatureAccessGate
+});
+//# sourceMappingURL=feature-access-gate.cjs.map

package/dist/feature-access-gate.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/feature-access-gate.tsx","../src/alert.tsx","../src/utils.ts","../src/spinner.tsx","../src/state-panel.tsx"],"sourcesContent":["import * as React from \"react\";\n\nimport { Alert } from \"./alert\";\nimport { StatePanel } from \"./state-panel\";\n\ntype FeatureAccessGateProps = {\n  isLoading?: boolean;\n  allowed: boolean;\n  deniedMessage: React.ReactNode;\n  children: React.ReactNode;\n};\n\n/**\n * Shared loading / denied shell for feature Managers (showcase, headers, …).\n */\nexport function FeatureAccessGate({\n  isLoading,\n  allowed,\n  deniedMessage,\n  children,\n}: FeatureAccessGateProps) {\n  if (isLoading) {\n    return (\n      <StatePanel loading className=\"p-6\">\n        Checking permissions…\n      </StatePanel>\n    );\n  }\n\n  if (!allowed) {\n    // `Alert`, not a hand-rolled banner: this is the denial surface for\n    // seventeen panels, and it was the one copy the Alert migration missed —\n    // so being refused a panel announced nothing to a screen reader.\n    return <Alert>{deniedMessage}</Alert>;\n  }\n\n  return <>{children}</>;\n}\n","import * as React from \"react\";\nimport { cva, type VariantProps } from \"class-variance-authority\";\n\nimport { cn } from \"./utils\";\n\n/**\n * The inline message banner — a failed load, a warning above a form, a note.\n *\n * This was the most duplicated markup in the panel: thirty blocks across\n * twenty-eight files, spelled seven different ways. `px-3 py-2` in most places\n * and `px-4 py-3` in others, `text-rose-700` here and `text-destructive`\n * there — all meaning \"something went wrong\".\n *\n * `role` is derived from the variant rather than left to callers. An error a\n * user needs to act on should interrupt a screen reader; a note should not.\n * Almost none of the hand-rolled copies set either.\n */\nconst alertVariants = cva(\"rounded-lg border px-3 py-2 text-sm\", {\n  variants: {\n    variant: {\n      danger: \"border-destructive/30 bg-destructive/5 text-destructive\",\n      warning: \"border-warning/30 bg-warning/5 text-warning\",\n      success: \"border-success/30 bg-success/5 text-success\",\n      info: \"border-info/30 bg-info/5 text-info\",\n      /**\n       * The quiet state of a banner that also has loud ones — \"no default\n       * campaign set\" next to \"this is the default\". Without it those callers\n       * keep a ternary of raw class strings and the shared component only\n       * covers half of what they draw.\n       */\n      neutral: \"border-border bg-muted/40 text-muted-foreground\",\n    },\n  },\n  defaultVariants: {\n    // Failure is what a banner almost always reports here, and defaulting to\n    // it means the noisy case cannot be forgotten.\n    variant: \"danger\",\n  },\n});\n\nexport interface AlertProps\n  extends\n    React.HTMLAttributes<HTMLDivElement>,\n    VariantProps<typeof alertVariants> {\n  /**\n   * A control belonging to the message, such as Retry. Given one, the banner\n   * lays out as a row and keeps the action at its end.\n   */\n  action?: React.ReactNode;\n}\n\nexport const Alert = React.forwardRef<HTMLDivElement, AlertProps>(\n  ({ className, variant, action, children, ...props }, ref) => (\n    <div\n      ref={ref}\n      role={variant === \"danger\" || variant == null ? \"alert\" : \"status\"}\n      className={cn(\n        alertVariants({ variant }),\n        action && \"flex flex-wrap items-center justify-between gap-3\",\n        className,\n      )}\n      {...props}\n    >\n      {/* Wrapped so the action sits opposite the text rather than being\n          pushed around by whatever the caller passed as children. */}\n      {action ? <span>{children}</span> : children}\n      {action}\n    </div>\n  ),\n);\n\nAlert.displayName = \"Alert\";\n\nexport { alertVariants };\n","import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n","import * as React from \"react\";\nimport { Loader2 } from \"lucide-react\";\n\nimport { cn } from \"./utils\";\n\n/**\n * The one spinner.\n *\n * There were five spellings of `animate-spin` across twelve files — `h-4 w-4`,\n * `h-5 w-5`, `size-4`, bare, and a hand-drawn ring in `ProtectedRoute` — so the\n * same \"working\" signal came out a different size depending on which panel you\n * were on.\n *\n * It is `aria-hidden` on purpose. A spinner is decoration; what a screen reader\n * needs is the surrounding control's `aria-busy` or the panel's status text,\n * and announcing \"loading\" twice is worse than once. `Button` and `StatePanel`\n * both supply that.\n */\nconst SIZES = {\n  sm: \"size-3.5\",\n  md: \"size-4\",\n  lg: \"size-5\",\n  xl: \"size-10 border-2\",\n} as const;\n\nexport interface SpinnerProps extends React.SVGProps<SVGSVGElement> {\n  size?: keyof typeof SIZES;\n}\n\nexport function Spinner({ size = \"md\", className, ...props }: SpinnerProps) {\n  return (\n    <Loader2\n      aria-hidden\n      className={cn(\"animate-spin\", SIZES[size], className)}\n      {...props}\n    />\n  );\n}\n","import * as React from \"react\";\n\nimport { Spinner } from \"./spinner\";\nimport { cn } from \"./utils\";\n\n/**\n * The bordered block a list shows instead of rows: loading, or nothing found.\n *\n * Fourteen copies of the same\n * `border-border bg-background/80 … rounded-lg border px-4 py-6 text-center`\n * across the panels, each with its own wording — \"Loading users…\", \"Loading\n * taxonomy…\", \"Loading showcases…\". The wording is worth keeping (it says what\n * is loading), the markup is not.\n *\n * `loading` adds two things the hand-rolled versions did not have: a spinner,\n * so a slow panel does not look like an empty one, and `role=\"status\"` with\n * `aria-live=\"polite\"`, so a screen reader is told the list arrived instead of\n * silently finding rows on the next tab press.\n */\nexport interface StatePanelProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Shows a spinner and announces politely. */\n  loading?: boolean;\n}\n\nexport function StatePanel({\n  loading,\n  className,\n  children,\n  ...props\n}: StatePanelProps) {\n  return (\n    <div\n      role={loading ? \"status\" : undefined}\n      aria-live={loading ? \"polite\" : undefined}\n      className={cn(\n        \"border-border bg-background/80 text-muted-foreground rounded-lg border px-4 py-6 text-center text-sm\",\n        loading && \"flex items-center justify-center gap-2\",\n        className,\n      )}\n      {...props}\n    >\n      {loading ? <Spinner size=\"md\" /> : null}\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,YAAuB;AACvB,sCAAuC;;;ACDvC,kBAAsC;AACtC,4BAAwB;AAEjB,SAAS,MAAM,QAAsB;AAC1C,aAAO,mCAAQ,kBAAK,MAAM,CAAC;AAC7B;;;ADgDI;AApCJ,IAAM,oBAAgB,qCAAI,uCAAuC;AAAA,EAC/D,UAAU;AAAA,IACR,SAAS;AAAA,MACP,QAAQ;AAAA,MACR,SAAS;AAAA,MACT,SAAS;AAAA,MACT,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAON,SAAS;AAAA,IACX;AAAA,EACF;AAAA,EACA,iBAAiB;AAAA;AAAA;AAAA,IAGf,SAAS;AAAA,EACX;AACF,CAAC;AAaM,IAAM,QAAc;AAAA,EACzB,CAAC,EAAE,WAAW,SAAS,QAAQ,UAAU,GAAG,MAAM,GAAG,QACnD;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,MAAM,YAAY,YAAY,WAAW,OAAO,UAAU;AAAA,MAC1D,WAAW;AAAA,QACT,cAAc,EAAE,QAAQ,CAAC;AAAA,QACzB,UAAU;AAAA,QACV;AAAA,MACF;AAAA,MACC,GAAG;AAAA,MAIH;AAAA,iBAAS,4CAAC,UAAM,UAAS,IAAU;AAAA,QACnC;AAAA;AAAA;AAAA,EACH;AAEJ;AAEA,MAAM,cAAc;;;AEtEpB,0BAAwB;AA8BpB,IAAAA,sBAAA;AAbJ,IAAM,QAAQ;AAAA,EACZ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AACN;AAMO,SAAS,QAAQ,EAAE,OAAO,MAAM,WAAW,GAAG,MAAM,GAAiB;AAC1E,SACE;AAAA,IAAC;AAAA;AAAA,MACC,eAAW;AAAA,MACX,WAAW,GAAG,gBAAgB,MAAM,IAAI,GAAG,SAAS;AAAA,MACnD,GAAG;AAAA;AAAA,EACN;AAEJ;;;ACNI,IAAAC,sBAAA;AAPG,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAoB;AAClB,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAM,UAAU,WAAW;AAAA,MAC3B,aAAW,UAAU,WAAW;AAAA,MAChC,WAAW;AAAA,QACT;AAAA,QACA,WAAW;AAAA,QACX;AAAA,MACF;AAAA,MACC,GAAG;AAAA,MAEH;AAAA,kBAAU,6CAAC,WAAQ,MAAK,MAAK,IAAK;AAAA,QAClC;AAAA;AAAA;AAAA,EACH;AAEJ;;;AJtBM,IAAAC,sBAAA;AARC,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA2B;AACzB,MAAI,WAAW;AACb,WACE,6CAAC,cAAW,SAAO,MAAC,WAAU,OAAM,wCAEpC;AAAA,EAEJ;AAEA,MAAI,CAAC,SAAS;AAIZ,WAAO,6CAAC,SAAO,yBAAc;AAAA,EAC/B;AAEA,SAAO,6EAAG,UAAS;AACrB;","names":["import_jsx_runtime","import_jsx_runtime","import_jsx_runtime"]}

package/dist/feature-access-gate.d.cts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+
+type FeatureAccessGateProps = {
+    isLoading?: boolean;
+    allowed: boolean;
+    deniedMessage: React.ReactNode;
+    children: React.ReactNode;
+};
+/**
+ * Shared loading / denied shell for feature Managers (showcase, headers, …).
+ */
+declare function FeatureAccessGate({ isLoading, allowed, deniedMessage, children, }: FeatureAccessGateProps): React.JSX.Element;
+
+export { FeatureAccessGate };

package/dist/feature-access-gate.d.ts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+
+type FeatureAccessGateProps = {
+    isLoading?: boolean;
+    allowed: boolean;
+    deniedMessage: React.ReactNode;
+    children: React.ReactNode;
+};
+/**
+ * Shared loading / denied shell for feature Managers (showcase, headers, …).
+ */
+declare function FeatureAccessGate({ isLoading, allowed, deniedMessage, children, }: FeatureAccessGateProps): React.JSX.Element;
+
+export { FeatureAccessGate };

package/dist/feature-access-gate.js

@@ -0,0 +1,11 @@
+import {
+  FeatureAccessGate
+} from "./chunk-S7PVZAPL.js";
+import "./chunk-G4ZQUSAJ.js";
+import "./chunk-ZP252OJZ.js";
+import "./chunk-UE7JY7VR.js";
+import "./chunk-HCA5ODCD.js";
+export {
+  FeatureAccessGate
+};
+//# sourceMappingURL=feature-access-gate.js.map

package/dist/feature-access-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/field.cjs

@@ -0,0 +1,58 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/field.tsx
+var field_exports = {};
+__export(field_exports, {
+  Field: () => Field
+});
+module.exports = __toCommonJS(field_exports);
+
+// src/utils.ts
+var import_clsx = require("clsx");
+var import_tailwind_merge = require("tailwind-merge");
+function cn(...inputs) {
+  return (0, import_tailwind_merge.twMerge)((0, import_clsx.clsx)(inputs));
+}
+
+// src/field.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function Field({
+  label,
+  required,
+  htmlFor,
+  as = "div",
+  className,
+  children
+}) {
+  const Wrapper = as;
+  const labelNode = /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
+    label,
+    required ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "text-destructive ml-0.5", "aria-hidden": "true", children: "*" }) : null
+  ] });
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(Wrapper, { className: cn("space-y-1 text-sm", className), children: [
+    htmlFor && as === "div" ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("label", { htmlFor, className: "text-muted-foreground", children: labelNode }) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "text-muted-foreground", children: labelNode }),
+    children
+  ] });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Field
+});
+//# sourceMappingURL=field.cjs.map

package/dist/field.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/field.tsx","../src/utils.ts"],"sourcesContent":["import * as React from \"react\";\n\nimport { cn } from \"./utils\";\n\ninterface FieldProps {\n  label: React.ReactNode;\n  required?: boolean;\n  /**\n   * Associates the label with a control via `htmlFor` / `id`. Prefer this for\n   * native inputs rendered as siblings (not wrapped). For composite controls\n   * (Autocomplete), omit and use `as=\"label\"` wrapping or an `aria-label`.\n   */\n  htmlFor?: string;\n  /**\n   * Render as a `<label>` (wraps a native control so clicking the text focuses\n   * it) or a `<div>` (for composite controls like Autocomplete that manage\n   * their own focus / render in a portal). Defaults to `div`.\n   */\n  as?: \"label\" | \"div\";\n  className?: string;\n  children: React.ReactNode;\n}\n\nexport function Field({\n  label,\n  required,\n  htmlFor,\n  as = \"div\",\n  className,\n  children,\n}: FieldProps) {\n  const Wrapper = as;\n  const labelNode = (\n    <>\n      {label}\n      {required ? (\n        <span className=\"text-destructive ml-0.5\" aria-hidden=\"true\">\n          *\n        </span>\n      ) : null}\n    </>\n  );\n\n  return (\n    <Wrapper className={cn(\"space-y-1 text-sm\", className)}>\n      {htmlFor && as === \"div\" ? (\n        <label htmlFor={htmlFor} className=\"text-muted-foreground\">\n          {labelNode}\n        </label>\n      ) : (\n        <span className=\"text-muted-foreground\">{labelNode}</span>\n      )}\n      {children}\n    </Wrapper>\n  );\n}\n","import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,kBAAsC;AACtC,4BAAwB;AAEjB,SAAS,MAAM,QAAsB;AAC1C,aAAO,mCAAQ,kBAAK,MAAM,CAAC;AAC7B;;;AD4BI;AAVG,SAAS,MAAM;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AAAA,EACA,KAAK;AAAA,EACL;AAAA,EACA;AACF,GAAe;AACb,QAAM,UAAU;AAChB,QAAM,YACJ,4EACG;AAAA;AAAA,IACA,WACC,4CAAC,UAAK,WAAU,2BAA0B,eAAY,QAAO,eAE7D,IACE;AAAA,KACN;AAGF,SACE,6CAAC,WAAQ,WAAW,GAAG,qBAAqB,SAAS,GAClD;AAAA,eAAW,OAAO,QACjB,4CAAC,WAAM,SAAkB,WAAU,yBAChC,qBACH,IAEA,4CAAC,UAAK,WAAU,yBAAyB,qBAAU;AAAA,IAEpD;AAAA,KACH;AAEJ;","names":[]}

package/dist/field.d.cts

@@ -0,0 +1,23 @@
+import * as React from 'react';
+
+interface FieldProps {
+    label: React.ReactNode;
+    required?: boolean;
+    /**
+     * Associates the label with a control via `htmlFor` / `id`. Prefer this for
+     * native inputs rendered as siblings (not wrapped). For composite controls
+     * (Autocomplete), omit and use `as="label"` wrapping or an `aria-label`.
+     */
+    htmlFor?: string;
+    /**
+     * Render as a `<label>` (wraps a native control so clicking the text focuses
+     * it) or a `<div>` (for composite controls like Autocomplete that manage
+     * their own focus / render in a portal). Defaults to `div`.
+     */
+    as?: "label" | "div";
+    className?: string;
+    children: React.ReactNode;
+}
+declare function Field({ label, required, htmlFor, as, className, children, }: FieldProps): React.JSX.Element;
+
+export { Field };

package/dist/field.d.ts

@@ -0,0 +1,23 @@
+import * as React from 'react';
+
+interface FieldProps {
+    label: React.ReactNode;
+    required?: boolean;
+    /**
+     * Associates the label with a control via `htmlFor` / `id`. Prefer this for
+     * native inputs rendered as siblings (not wrapped). For composite controls
+     * (Autocomplete), omit and use `as="label"` wrapping or an `aria-label`.
+     */
+    htmlFor?: string;
+    /**
+     * Render as a `<label>` (wraps a native control so clicking the text focuses
+     * it) or a `<div>` (for composite controls like Autocomplete that manage
+     * their own focus / render in a portal). Defaults to `div`.
+     */
+    as?: "label" | "div";
+    className?: string;
+    children: React.ReactNode;
+}
+declare function Field({ label, required, htmlFor, as, className, children, }: FieldProps): React.JSX.Element;
+
+export { Field };

package/dist/field.js

@@ -0,0 +1,8 @@
+import {
+  Field
+} from "./chunk-67ACNS42.js";
+import "./chunk-HCA5ODCD.js";
+export {
+  Field
+};
+//# sourceMappingURL=field.js.map

package/dist/field.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/image-uploader.cjs

@@ -0,0 +1,293 @@
+"use client";
+"use strict";
+"use client";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/image-uploader.tsx
+var image_uploader_exports = {};
+__export(image_uploader_exports, {
+  ImageUploader: () => ImageUploader
+});
+module.exports = __toCommonJS(image_uploader_exports);
+var import_lucide_react2 = require("lucide-react");
+var React3 = __toESM(require("react"), 1);
+
+// src/button.tsx
+var React = __toESM(require("react"), 1);
+var import_class_variance_authority = require("class-variance-authority");
+var import_react_slot = require("@radix-ui/react-slot");
+
+// src/spinner.tsx
+var import_lucide_react = require("lucide-react");
+
+// src/utils.ts
+var import_clsx = require("clsx");
+var import_tailwind_merge = require("tailwind-merge");
+function cn(...inputs) {
+  return (0, import_tailwind_merge.twMerge)((0, import_clsx.clsx)(inputs));
+}
+
+// src/spinner.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var SIZES = {
+  sm: "size-3.5",
+  md: "size-4",
+  lg: "size-5",
+  xl: "size-10 border-2"
+};
+function Spinner({ size = "md", className, ...props }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    import_lucide_react.Loader2,
+    {
+      "aria-hidden": true,
+      className: cn("animate-spin", SIZES[size], className),
+      ...props
+    }
+  );
+}
+
+// src/button.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var buttonVariants = (0, import_class_variance_authority.cva)(
+  "inline-flex h-9 cursor-pointer items-center justify-center gap-2 whitespace-nowrap rounded-md px-3 text-sm font-medium transition duration-200 active:scale-[0.98] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50",
+  {
+    variants: {
+      variant: {
+        default: "bg-primary text-primary-foreground hover:bg-primary/90",
+        secondary: "bg-muted text-foreground hover:bg-muted/80",
+        ghost: "hover:bg-muted",
+        destructive: "bg-destructive text-destructive-foreground hover:bg-destructive/90",
+        outline: "border border-border bg-background hover:bg-muted"
+      },
+      size: {
+        sm: "h-8 px-2.5",
+        md: "h-9 px-3",
+        lg: "h-10 px-4",
+        icon: "h-9 w-9 px-0",
+        // Square, matching `sm`'s height — for an icon-only control sitting in
+        // a table row or beside `sm` buttons, where `icon` is a row taller.
+        "icon-sm": "h-8 w-8 px-0"
+      }
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "md"
+    }
+  }
+);
+var ICON_SIZES = /* @__PURE__ */ new Set(["icon", "icon-sm"]);
+var Button = React.forwardRef(
+  ({
+    className,
+    variant,
+    size,
+    asChild = false,
+    loading,
+    disabled,
+    children,
+    ...props
+  }, ref) => {
+    const Comp = asChild ? import_react_slot.Slot : "button";
+    if (asChild) {
+      return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+        Comp,
+        {
+          ref,
+          className: cn(buttonVariants({ variant, size }), className),
+          ...props,
+          children
+        }
+      );
+    }
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
+      "button",
+      {
+        ref,
+        disabled: disabled || loading,
+        "aria-busy": loading || void 0,
+        className: cn(buttonVariants({ variant, size }), className),
+        ...props,
+        children: [
+          loading ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Spinner, { size: "sm" }) : null,
+          loading && size != null && ICON_SIZES.has(size) ? null : children
+        ]
+      }
+    );
+  }
+);
+Button.displayName = "Button";
+
+// src/input.tsx
+var React2 = __toESM(require("react"), 1);
+var import_jsx_runtime3 = require("react/jsx-runtime");
+var inputClass = "h-9 w-full rounded-md border border-border bg-background px-3 text-sm focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50";
+var Input = React2.forwardRef(
+  ({ className, ...props }, ref) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("input", { ref, className: cn(inputClass, className), ...props })
+);
+Input.displayName = "Input";
+
+// src/image-uploader.tsx
+var import_jsx_runtime4 = require("react/jsx-runtime");
+function ImageUploader({
+  value = "",
+  onChange,
+  disabled,
+  label,
+  className,
+  allowUrlPaste = true,
+  accept = "image/*,.gif",
+  uploadFile,
+  uploadFromUrl
+}) {
+  const inputRef = React3.useRef(null);
+  const [uploading, setUploading] = React3.useState(false);
+  const [error, setError] = React3.useState(null);
+  const busy = Boolean(disabled || uploading);
+  const handleFile = async (file) => {
+    if (!uploadFile) {
+      setError("File upload is not configured for this panel.");
+      return;
+    }
+    setUploading(true);
+    setError(null);
+    try {
+      onChange(await uploadFile(file));
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Upload failed");
+    } finally {
+      setUploading(false);
+      if (inputRef.current) inputRef.current.value = "";
+    }
+  };
+  const handleUrl = async (imageUrl) => {
+    const trimmed = imageUrl.trim();
+    if (!trimmed) {
+      onChange("");
+      return;
+    }
+    if (trimmed === value) return;
+    if (!uploadFromUrl || /^https?:\/\//i.test(trimmed)) {
+      setError(null);
+      onChange(trimmed);
+      return;
+    }
+    setUploading(true);
+    setError(null);
+    try {
+      onChange(await uploadFromUrl(trimmed));
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Upload failed");
+    } finally {
+      setUploading(false);
+    }
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: cn("space-y-2", className), children: [
+    label ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "text-muted-foreground text-xs font-medium", children: label }) : null,
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "flex flex-wrap items-center gap-2", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+        "input",
+        {
+          ref: inputRef,
+          type: "file",
+          accept,
+          className: "hidden",
+          disabled: busy,
+          onChange: (e) => {
+            const file = e.target.files?.[0];
+            if (file) void handleFile(file);
+          }
+        }
+      ),
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
+        Button,
+        {
+          type: "button",
+          variant: "outline",
+          size: "sm",
+          disabled: busy,
+          onClick: () => inputRef.current?.click(),
+          children: [
+            uploading ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_lucide_react2.Loader2, { className: "h-4 w-4 animate-spin" }) : /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_lucide_react2.ImagePlus, { className: "h-4 w-4" }),
+            uploading ? "Uploading\u2026" : "Upload"
+          ]
+        }
+      ),
+      value ? /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
+        Button,
+        {
+          type: "button",
+          variant: "ghost",
+          size: "sm",
+          disabled: busy,
+          onClick: () => onChange(""),
+          "aria-label": "Clear image",
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_lucide_react2.X, { className: "h-4 w-4" }),
+            "Clear"
+          ]
+        }
+      ) : null
+    ] }),
+    allowUrlPaste ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+      Input,
+      {
+        defaultValue: value,
+        disabled: busy,
+        placeholder: "Or paste image URL\u2026",
+        onBlur: (e) => {
+          void handleUrl(e.target.value);
+        },
+        onKeyDown: (e) => {
+          if (e.key === "Enter") {
+            e.preventDefault();
+            void handleUrl(e.target.value);
+          }
+        }
+      },
+      value || "empty"
+    ) : null,
+    value ? (
+      // eslint-disable-next-line @next/next/no-img-element -- CDN URLs vary
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+        "img",
+        {
+          src: value,
+          alt: "",
+          className: "border-border max-h-24 rounded border bg-white object-contain p-1"
+        }
+      )
+    ) : null,
+    error ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("p", { className: "text-destructive text-xs", role: "alert", children: error }) : null
+  ] });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ImageUploader
+});
+//# sourceMappingURL=image-uploader.cjs.map