@nucleux/templates 0.0.0-stage → 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nucleux
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,54 @@
-# Temporary Holding Version
+# @nucleux/templates
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Templates — fill-in-the-blank prompt scaffolds that turn vague intent into a good question — Nucleux agentic UI for React.
+
+Part of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** — agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).
+
+Structured prompts that capture good prompting: a sentence with named slots,
+a list of fully written prompts, or a library grouped by domain. Nothing runs
+until the person picks "Use this prompt" or a template.
+
+## Exports
+
+- **`Templates`** — fill-in-the-blank (`fill-blanks`): a form with inline slot fields
+- **`TemplatesList`** — prefilled list (`prefilled-list`): one-tap prompts
+- **`TemplatesBrowser`** — categorised browser (`categorized-browser`): vertical tabs per category
+- Types: `TemplatesProps`, `PromptSegment`, `PromptSlot`, `TemplatesListProps`, `TemplatesListItem`, `TemplatesBrowserProps`, `TemplatesCategory`
+
+## Behaviour
+
+- `segments` mix literal strings and slots `{ slot, placeholder, label?, options?, required? }`. `options` give native type-ahead; the field stays free text.
+- Required slots are counted ("1 blank left", `aria-live`) and the submit waits for them. Empty optional slots fall back to their placeholder.
+- `onComplete(prompt, values)` gets the interpolated sentence. `TemplatesList`/`TemplatesBrowser` call `onSelect(prompt, item[, category])`.
+
+## Usage
+
+```tsx
+import { Templates, TemplatesList, TemplatesBrowser } from "@nucleux/templates";
+
+<Templates
+  segments={[
+    "Summarise ", { slot: "meeting", placeholder: "meeting", options: ["the standup", "the board review"], required: true },
+    " in ", { slot: "length", placeholder: "3 bullets" },
+    " for ", { slot: "audience", placeholder: "execs" }, ".",
+  ]}
+  onComplete={(prompt) => setDraft(prompt)}
+/>
+
+<TemplatesList aria-label="Templates" items={["Draft a follow-up to the at-risk accounts"]} onSelect={setDraft} />
+```
+
+## Install
+
+```bash
+pnpm add @nucleux/templates @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+Requires the theme once in your app: `import "@nucleux/tokens/styles.css";`
+and the Tailwind preset from `@nucleux/tokens/preset`.
+
+## License
+
+MIT © Nucleux

package/dist/index.cjs

@@ -0,0 +1,171 @@
+"use client";
+'use strict';
+
+var React = require('react');
+var lucideReact = require('lucide-react');
+var utils = require('@nucleux/utils');
+var button = require('@nucleux/button');
+var tabs = require('@nucleux/tabs');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+// src/index.tsx
+var Templates = React__namespace.forwardRef(
+  ({
+    segments,
+    values,
+    defaultValues = {},
+    onValuesChange,
+    onComplete,
+    submitLabel = "Use this prompt",
+    className,
+    ...props
+  }, ref) => {
+    const [internal, setInternal] = React__namespace.useState(defaultValues);
+    const current = values ?? internal;
+    const baseId = React__namespace.useId();
+    const setSlot = (slot, val) => {
+      const next = { ...current, [slot]: val };
+      if (values === void 0) setInternal(next);
+      onValuesChange?.(next);
+    };
+    const interpolate = () => segments.map((s) => typeof s === "string" ? s : current[s.slot] || s.placeholder).join("");
+    const required = segments.filter((s) => typeof s !== "string" && !!s.required);
+    const missing = required.filter((s) => !(current[s.slot] ?? "").trim()).length;
+    const statusId = `${baseId}-status`;
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "form",
+      {
+        ref,
+        onSubmit: (e) => {
+          e.preventDefault();
+          if (missing > 0) return;
+          onComplete?.(interpolate(), current);
+        },
+        className: utils.cn("flex flex-col gap-4 rounded-xl border border-border bg-background p-5", className),
+        ...props,
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-base leading-loose text-foreground", children: segments.map((segment, i) => {
+            if (typeof segment === "string") return /* @__PURE__ */ jsxRuntime.jsx(React__namespace.Fragment, { children: segment }, i);
+            const val = current[segment.slot] ?? "";
+            const listId = segment.options?.length ? `${baseId}-${segment.slot}-options` : void 0;
+            return /* @__PURE__ */ jsxRuntime.jsxs(React__namespace.Fragment, { children: [
+              /* @__PURE__ */ jsxRuntime.jsx(
+                "input",
+                {
+                  type: "text",
+                  value: val,
+                  onChange: (e) => setSlot(segment.slot, e.target.value),
+                  placeholder: segment.placeholder,
+                  "aria-label": segment.label ?? segment.placeholder,
+                  "aria-required": segment.required || void 0,
+                  list: listId,
+                  autoComplete: "off",
+                  size: Math.max((val || segment.placeholder).length, 4),
+                  className: utils.cn(
+                    "mx-0.5 inline-block rounded-md border-b-2 border-dashed border-brand/50 bg-brand-muted/40 px-1 text-center text-brand placeholder:text-brand/60 focus:border-solid focus:border-brand focus:outline-none",
+                    val && "border-solid bg-brand-muted"
+                  )
+                }
+              ),
+              listId && /* @__PURE__ */ jsxRuntime.jsx("datalist", { id: listId, children: segment.options.map((o) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: o }, o)) })
+            ] }, i);
+          }) }),
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-end gap-3", children: [
+            required.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("span", { id: statusId, "aria-live": "polite", className: "mr-auto text-sm text-muted-foreground", children: missing === 0 ? "Ready to use" : `${missing} ${missing === 1 ? "blank" : "blanks"} left` }),
+            /* @__PURE__ */ jsxRuntime.jsx(
+              button.Button,
+              {
+                type: "submit",
+                variant: "cta",
+                disabled: missing > 0,
+                "aria-describedby": required.length > 0 ? statusId : void 0,
+                children: submitLabel
+              }
+            )
+          ] })
+        ]
+      }
+    );
+  }
+);
+Templates.displayName = "Templates";
+var toListItem = (item) => typeof item === "string" ? { title: item } : item;
+var TemplatesList = React__namespace.forwardRef(
+  ({ items, onSelect, className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
+    "ul",
+    {
+      ref,
+      role: "list",
+      className: utils.cn("m-0 flex list-none flex-col gap-1 p-0", className),
+      ...props,
+      children: items.map(toListItem).map((item) => /* @__PURE__ */ jsxRuntime.jsx("li", { children: /* @__PURE__ */ jsxRuntime.jsxs(
+        "button",
+        {
+          type: "button",
+          onClick: () => onSelect?.(item.prompt ?? item.title, item),
+          className: "flex w-full items-start gap-2 rounded-md border border-border bg-muted/40 px-3 py-2 text-left text-sm text-foreground transition-colors hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+          children: [
+            /* @__PURE__ */ jsxRuntime.jsx(lucideReact.ArrowRight, { "aria-hidden": "true", className: "mt-0.5 size-4 shrink-0 text-muted-foreground" }),
+            /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 flex-col gap-0.5", children: [
+              /* @__PURE__ */ jsxRuntime.jsx("span", { children: item.title }),
+              item.description && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs text-muted-foreground", children: item.description })
+            ] })
+          ]
+        }
+      ) }, item.id ?? item.title))
+    }
+  )
+);
+TemplatesList.displayName = "TemplatesList";
+var TemplatesBrowser = React__namespace.forwardRef(
+  ({ categories, category, defaultCategory, onCategoryChange, onSelect, className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsxs(
+    tabs.Tabs,
+    {
+      ref,
+      orientation: "vertical",
+      value: category,
+      defaultValue: defaultCategory ?? categories[0]?.id ?? "",
+      onValueChange: onCategoryChange,
+      className: utils.cn("gap-3", className),
+      ...props,
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx(tabs.TabsList, { "aria-label": "Template categories", className: "h-fit shrink-0 bg-transparent p-0", children: categories.map((c) => /* @__PURE__ */ jsxRuntime.jsx(tabs.TabsTrigger, { value: c.id, className: "justify-start aria-selected:bg-muted aria-selected:shadow-none", children: c.label }, c.id)) }),
+        categories.map((c) => /* @__PURE__ */ jsxRuntime.jsx(tabs.TabsContent, { value: c.id, className: "min-w-0 flex-1", children: /* @__PURE__ */ jsxRuntime.jsx(
+          TemplatesList,
+          {
+            "aria-label": `${c.label} templates`,
+            items: c.templates,
+            onSelect: (prompt, item) => onSelect?.(prompt, item, c.id)
+          }
+        ) }, c.id))
+      ]
+    }
+  )
+);
+TemplatesBrowser.displayName = "TemplatesBrowser";
+
+exports.Templates = Templates;
+exports.TemplatesBrowser = TemplatesBrowser;
+exports.TemplatesList = TemplatesList;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["React","jsxs","cn","jsx","Button","ArrowRight","Tabs","TabsList","TabsTrigger","TabsContent"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CO,IAAM,SAAA,GAAkBA,gBAAA,CAAA,UAAA;AAAA,EAC7B,CACE;AAAA,IACE,QAAA;AAAA,IACA,MAAA;AAAA,IACA,gBAAgB,EAAC;AAAA,IACjB,cAAA;AAAA,IACA,UAAA;AAAA,IACA,WAAA,GAAc,iBAAA;AAAA,IACd,SAAA;AAAA,IACA,GAAG;AAAA,KAEL,GAAA,KACG;AACH,IAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAUA,0BAAiC,aAAa,CAAA;AACpF,IAAA,MAAM,UAAU,MAAA,IAAU,QAAA;AAC1B,IAAA,MAAM,SAAeA,gBAAA,CAAA,KAAA,EAAM;AAE3B,IAAA,MAAM,OAAA,GAAU,CAAC,IAAA,EAAc,GAAA,KAAgB;AAC7C,MAAA,MAAM,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,GAAG,GAAA,EAAI;AACvC,MAAA,IAAI,MAAA,KAAW,MAAA,EAAW,WAAA,CAAY,IAAI,CAAA;AAC1C,MAAA,cAAA,GAAiB,IAAI,CAAA;AAAA,IACvB,CAAA;AAEA,IAAA,MAAM,cAAc,MAClB,QAAA,CACG,IAAI,CAAC,CAAA,KAAO,OAAO,CAAA,KAAM,QAAA,GAAW,CAAA,GAAI,OAAA,CAAQ,EAAE,IAAI,CAAA,IAAK,EAAE,WAAY,CAAA,CACzE,KAAK,EAAE,CAAA;AAEZ,IAAA,MAAM,QAAA,GAAW,QAAA,CAAS,MAAA,CAAO,CAAC,CAAA,KAAuB,OAAO,CAAA,KAAM,QAAA,IAAY,CAAC,CAAC,CAAA,CAAE,QAAQ,CAAA;AAC9F,IAAA,MAAM,OAAA,GAAU,QAAA,CAAS,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,OAAA,CAAQ,CAAA,CAAE,IAAI,CAAA,IAAK,EAAA,EAAI,IAAA,EAAM,CAAA,CAAE,MAAA;AACxE,IAAA,MAAM,QAAA,GAAW,GAAG,MAAM,CAAA,OAAA,CAAA;AAE1B,IAAA,uBACEC,eAAA;AAAA,MAAC,MAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,QAAA,EAAU,CAAC,CAAA,KAAM;AACf,UAAA,CAAA,CAAE,cAAA,EAAe;AACjB,UAAA,IAAI,UAAU,CAAA,EAAG;AACjB,UAAA,UAAA,GAAa,WAAA,IAAe,OAAO,CAAA;AAAA,QACrC,CAAA;AAAA,QACA,SAAA,EAAWC,QAAA,CAAG,uEAAA,EAAyE,SAAS,CAAA;AAAA,QAC/F,GAAG,KAAA;AAAA,QAEJ,QAAA,EAAA;AAAA,0BAAAC,cAAA,CAAC,OAAE,SAAA,EAAU,yCAAA,EACV,mBAAS,GAAA,CAAI,CAAC,SAAS,CAAA,KAAM;AAC5B,YAAA,IAAI,OAAO,YAAY,QAAA,EAAU,sCAAcH,gBAAA,CAAA,QAAA,EAAN,EAAwB,qBAAJ,CAAY,CAAA;AACzE,YAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,OAAA,CAAQ,IAAI,CAAA,IAAK,EAAA;AACrC,YAAA,MAAM,MAAA,GAAS,QAAQ,OAAA,EAAS,MAAA,GAAS,GAAG,MAAM,CAAA,CAAA,EAAI,OAAA,CAAQ,IAAI,CAAA,QAAA,CAAA,GAAa,MAAA;AAC/E,YAAA,uBACEC,eAAA,CAAOD,2BAAN,EACC,QAAA,EAAA;AAAA,8BAAAG,cAAA;AAAA,gBAAC,OAAA;AAAA,gBAAA;AAAA,kBACC,IAAA,EAAK,MAAA;AAAA,kBACL,KAAA,EAAO,GAAA;AAAA,kBACP,QAAA,EAAU,CAAC,CAAA,KAAM,OAAA,CAAQ,QAAQ,IAAA,EAAM,CAAA,CAAE,OAAO,KAAK,CAAA;AAAA,kBACrD,aAAa,OAAA,CAAQ,WAAA;AAAA,kBACrB,YAAA,EAAY,OAAA,CAAQ,KAAA,IAAS,OAAA,CAAQ,WAAA;AAAA,kBACrC,eAAA,EAAe,QAAQ,QAAA,IAAY,MAAA;AAAA,kBACnC,IAAA,EAAM,MAAA;AAAA,kBACN,YAAA,EAAa,KAAA;AAAA,kBACb,MAAM,IAAA,CAAK,GAAA,CAAA,CAAK,OAAO,OAAA,CAAQ,WAAA,EAAa,QAAQ,CAAC,CAAA;AAAA,kBACrD,SAAA,EAAWD,QAAA;AAAA,oBACT,0MAAA;AAAA,oBACA,GAAA,IAAO;AAAA;AACT;AAAA,eACF;AAAA,cACC,0BACCC,cAAA,CAAC,UAAA,EAAA,EAAS,EAAA,EAAI,MAAA,EACX,kBAAQ,OAAA,CAAS,GAAA,CAAI,CAAC,CAAA,oCACpB,QAAA,EAAA,EAAe,KAAA,EAAO,CAAA,EAAA,EAAV,CAAa,CAC3B,CAAA,EACH;AAAA,aAAA,EAAA,EArBiB,CAuBrB,CAAA;AAAA,UAEJ,CAAC,CAAA,EACH,CAAA;AAAA,0BACAF,eAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,qCAAA,EACZ,QAAA,EAAA;AAAA,YAAA,QAAA,CAAS,MAAA,GAAS,qBACjBE,cAAA,CAAC,MAAA,EAAA,EAAK,IAAI,QAAA,EAAU,WAAA,EAAU,UAAS,SAAA,EAAU,uCAAA,EAC9C,sBAAY,CAAA,GAAI,cAAA,GAAiB,GAAG,OAAO,CAAA,CAAA,EAAI,YAAY,CAAA,GAAI,OAAA,GAAU,QAAQ,CAAA,KAAA,CAAA,EACpF,CAAA;AAAA,4BAEFA,cAAA;AAAA,cAACC,aAAA;AAAA,cAAA;AAAA,gBACC,IAAA,EAAK,QAAA;AAAA,gBACL,OAAA,EAAQ,KAAA;AAAA,gBACR,UAAU,OAAA,GAAU,CAAA;AAAA,gBACpB,kBAAA,EAAkB,QAAA,CAAS,MAAA,GAAS,CAAA,GAAI,QAAA,GAAW,MAAA;AAAA,gBAElD,QAAA,EAAA;AAAA;AAAA;AACH,WAAA,EACF;AAAA;AAAA;AAAA,KACF;AAAA,EAEJ;AACF;AACA,SAAA,CAAU,WAAA,GAAc,WAAA;AAqBxB,IAAM,UAAA,GAAa,CAAC,IAAA,KAClB,OAAO,SAAS,QAAA,GAAW,EAAE,KAAA,EAAO,IAAA,EAAK,GAAI,IAAA;AAOxC,IAAM,aAAA,GAAsBJ,gBAAA,CAAA,UAAA;AAAA,EACjC,CAAC,EAAE,KAAA,EAAO,QAAA,EAAU,WAAW,GAAG,KAAA,IAAS,GAAA,qBACzCG,cAAA;AAAA,IAAC,IAAA;AAAA,IAAA;AAAA,MACC,GAAA;AAAA,MACA,IAAA,EAAK,MAAA;AAAA,MACL,SAAA,EAAWD,QAAA,CAAG,uCAAA,EAAyC,SAAS,CAAA;AAAA,MAC/D,GAAG,KAAA;AAAA,MAEH,QAAA,EAAA,KAAA,CAAM,IAAI,UAAU,CAAA,CAAE,IAAI,CAAC,IAAA,oCACzB,IAAA,EAAA,EACC,QAAA,kBAAAD,eAAA;AAAA,QAAC,QAAA;AAAA,QAAA;AAAA,UACC,IAAA,EAAK,QAAA;AAAA,UACL,SAAS,MAAM,QAAA,GAAW,KAAK,MAAA,IAAU,IAAA,CAAK,OAAO,IAAI,CAAA;AAAA,UACzD,SAAA,EAAU,iOAAA;AAAA,UAEV,QAAA,EAAA;AAAA,4BAAAE,cAAA,CAACE,sBAAA,EAAA,EAAW,aAAA,EAAY,MAAA,EAAO,SAAA,EAAU,8CAAA,EAA+C,CAAA;AAAA,4BACxFJ,eAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,+BAAA,EACd,QAAA,EAAA;AAAA,8BAAAE,cAAA,CAAC,MAAA,EAAA,EAAM,eAAK,KAAA,EAAM,CAAA;AAAA,cACjB,KAAK,WAAA,oBAAeA,cAAA,CAAC,UAAK,SAAA,EAAU,+BAAA,EAAiC,eAAK,WAAA,EAAY;AAAA,aAAA,EACzF;AAAA;AAAA;AAAA,OACF,EAAA,EAXO,IAAA,CAAK,EAAA,IAAM,IAAA,CAAK,KAYzB,CACD;AAAA;AAAA;AAGP;AACA,aAAA,CAAc,WAAA,GAAc,eAAA;AAgCrB,IAAM,gBAAA,GAAyBH,gBAAA,CAAA,UAAA;AAAA,EACpC,CAAC,EAAE,UAAA,EAAY,QAAA,EAAU,eAAA,EAAiB,gBAAA,EAAkB,QAAA,EAAU,SAAA,EAAW,GAAG,KAAA,EAAM,EAAG,GAAA,qBAC3FC,eAAA;AAAA,IAACK,SAAA;AAAA,IAAA;AAAA,MACC,GAAA;AAAA,MACA,WAAA,EAAY,UAAA;AAAA,MACZ,KAAA,EAAO,QAAA;AAAA,MACP,YAAA,EAAc,eAAA,IAAmB,UAAA,CAAW,CAAC,GAAG,EAAA,IAAM,EAAA;AAAA,MACtD,aAAA,EAAe,gBAAA;AAAA,MACf,SAAA,EAAWJ,QAAA,CAAG,OAAA,EAAS,SAAS,CAAA;AAAA,MAC/B,GAAG,KAAA;AAAA,MAEJ,QAAA,EAAA;AAAA,wBAAAC,cAAA,CAACI,aAAA,EAAA,EAAS,cAAW,qBAAA,EAAsB,SAAA,EAAU,qCAClD,QAAA,EAAA,UAAA,CAAW,GAAA,CAAI,CAAC,CAAA,qBACfJ,cAAA,CAACK,oBAAuB,KAAA,EAAO,CAAA,CAAE,IAAI,SAAA,EAAU,gEAAA,EAC5C,YAAE,KAAA,EAAA,EADa,CAAA,CAAE,EAEpB,CACD,CAAA,EACH,CAAA;AAAA,QACC,UAAA,CAAW,GAAA,CAAI,CAAC,CAAA,qBACfL,cAAA,CAACM,oBAAuB,KAAA,EAAO,CAAA,CAAE,EAAA,EAAI,SAAA,EAAU,gBAAA,EAC7C,QAAA,kBAAAN,cAAA;AAAA,UAAC,aAAA;AAAA,UAAA;AAAA,YACC,YAAA,EAAY,CAAA,EAAG,CAAA,CAAE,KAAK,CAAA,UAAA,CAAA;AAAA,YACtB,OAAO,CAAA,CAAE,SAAA;AAAA,YACT,QAAA,EAAU,CAAC,MAAA,EAAQ,IAAA,KAAS,WAAW,MAAA,EAAQ,IAAA,EAAM,EAAE,EAAE;AAAA;AAAA,SAC3D,EAAA,EALgB,CAAA,CAAE,EAMpB,CACD;AAAA;AAAA;AAAA;AAGP;AACA,gBAAA,CAAiB,WAAA,GAAc,kBAAA","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { ArrowRight } from \"lucide-react\";\nimport { cn } from \"@nucleux/utils\";\nimport { Button } from \"@nucleux/button\";\nimport { Tabs, TabsContent, TabsList, TabsTrigger } from \"@nucleux/tabs\";\n\n/** A fill-in-the-blank slot: an id, the placeholder shown while empty, and optional type-ahead options. */\nexport interface PromptSlot {\n  /** Slot id — the key in `values`. */\n  slot: string;\n  /** Shown while the slot is empty, and used in the prompt if it stays empty. */\n  placeholder: string;\n  /** Accessible name of the slot's field. Defaults to `placeholder`. */\n  label?: string;\n  /** Type-ahead options offered while typing (the field stays free text). */\n  options?: string[];\n  /** Must be filled before the template can be used. */\n  required?: boolean;\n}\n\n/** A literal string, or a fill-in-the-blank slot. */\nexport type PromptSegment = string | PromptSlot;\n\nexport interface TemplatesProps extends Omit<React.FormHTMLAttributes<HTMLFormElement>, \"onSubmit\"> {\n  /** The template as an ordered mix of literal text and named slots. */\n  segments: PromptSegment[];\n  /** Slot values (controlled), keyed by slot id. */\n  values?: Record<string, string>;\n  /** Initial slot values (uncontrolled). */\n  defaultValues?: Record<string, string>;\n  /** Called when any slot changes. */\n  onValuesChange?: (values: Record<string, string>) => void;\n  /** Called with the interpolated prompt (and raw values) on submit. Nothing runs on its own. */\n  onComplete?: (prompt: string, values: Record<string, string>) => void;\n  /** Submit button label. Defaults to `\"Use this prompt\"`. */\n  submitLabel?: React.ReactNode;\n}\n\n/**\n * The fill-in-the-blank template: a sentence with highlighted slots the user\n * tabs through, so a good prompt reads as a sentence even before it is\n * filled. Slots are free-text fields with optional type-ahead `options`;\n * `required` slots are counted (\"1 blank left\") and must be filled before the\n * one-click \"Use this prompt\" fires `onComplete` with the interpolated text.\n * For a list of fully written prompts use {@link TemplatesList}; for a library\n * grouped by domain use {@link TemplatesBrowser}.\n */\nexport const Templates = React.forwardRef<HTMLFormElement, TemplatesProps>(\n  (\n    {\n      segments,\n      values,\n      defaultValues = {},\n      onValuesChange,\n      onComplete,\n      submitLabel = \"Use this prompt\",\n      className,\n      ...props\n    },\n    ref,\n  ) => {\n    const [internal, setInternal] = React.useState<Record<string, string>>(defaultValues);\n    const current = values ?? internal;\n    const baseId = React.useId();\n\n    const setSlot = (slot: string, val: string) => {\n      const next = { ...current, [slot]: val };\n      if (values === undefined) setInternal(next);\n      onValuesChange?.(next);\n    };\n\n    const interpolate = () =>\n      segments\n        .map((s) => (typeof s === \"string\" ? s : current[s.slot] || s.placeholder))\n        .join(\"\");\n\n    const required = segments.filter((s): s is PromptSlot => typeof s !== \"string\" && !!s.required);\n    const missing = required.filter((s) => !(current[s.slot] ?? \"\").trim()).length;\n    const statusId = `${baseId}-status`;\n\n    return (\n      <form\n        ref={ref}\n        onSubmit={(e) => {\n          e.preventDefault();\n          if (missing > 0) return;\n          onComplete?.(interpolate(), current);\n        }}\n        className={cn(\"flex flex-col gap-4 rounded-xl border border-border bg-background p-5\", className)}\n        {...props}\n      >\n        <p className=\"text-base leading-loose text-foreground\">\n          {segments.map((segment, i) => {\n            if (typeof segment === \"string\") return <React.Fragment key={i}>{segment}</React.Fragment>;\n            const val = current[segment.slot] ?? \"\";\n            const listId = segment.options?.length ? `${baseId}-${segment.slot}-options` : undefined;\n            return (\n              <React.Fragment key={i}>\n                <input\n                  type=\"text\"\n                  value={val}\n                  onChange={(e) => setSlot(segment.slot, e.target.value)}\n                  placeholder={segment.placeholder}\n                  aria-label={segment.label ?? segment.placeholder}\n                  aria-required={segment.required || undefined}\n                  list={listId}\n                  autoComplete=\"off\"\n                  size={Math.max((val || segment.placeholder).length, 4)}\n                  className={cn(\n                    \"mx-0.5 inline-block rounded-md border-b-2 border-dashed border-brand/50 bg-brand-muted/40 px-1 text-center text-brand placeholder:text-brand/60 focus:border-solid focus:border-brand focus:outline-none\",\n                    val && \"border-solid bg-brand-muted\",\n                  )}\n                />\n                {listId && (\n                  <datalist id={listId}>\n                    {segment.options!.map((o) => (\n                      <option key={o} value={o} />\n                    ))}\n                  </datalist>\n                )}\n              </React.Fragment>\n            );\n          })}\n        </p>\n        <div className=\"flex items-center justify-end gap-3\">\n          {required.length > 0 && (\n            <span id={statusId} aria-live=\"polite\" className=\"mr-auto text-sm text-muted-foreground\">\n              {missing === 0 ? \"Ready to use\" : `${missing} ${missing === 1 ? \"blank\" : \"blanks\"} left`}\n            </span>\n          )}\n          <Button\n            type=\"submit\"\n            variant=\"cta\"\n            disabled={missing > 0}\n            aria-describedby={required.length > 0 ? statusId : undefined}\n          >\n            {submitLabel}\n          </Button>\n        </div>\n      </form>\n    );\n  },\n);\nTemplates.displayName = \"Templates\";\n\n/** A fully written template in a list or browser. */\nexport interface TemplatesListItem {\n  /** Stable id. Defaults to `title`. */\n  id?: string;\n  /** What the user sees (\"Summarise yesterday's standup in 3 bullets\"). */\n  title: string;\n  /** The prompt handed to `onSelect`. Defaults to `title`. */\n  prompt?: string;\n  /** One supporting line. */\n  description?: string;\n}\n\nexport interface TemplatesListProps extends Omit<React.HTMLAttributes<HTMLUListElement>, \"onSelect\"> {\n  /** The templates, as strings or {@link TemplatesListItem}s. */\n  items: Array<string | TemplatesListItem>;\n  /** Called with the prompt and the item when one is picked. Place it in the composer — never send it. */\n  onSelect?: (prompt: string, item: TemplatesListItem) => void;\n}\n\nconst toListItem = (item: string | TemplatesListItem): TemplatesListItem =>\n  typeof item === \"string\" ? { title: item } : item;\n\n/**\n * The prefilled-list template surface: fully written prompts the user runs\n * with one tap, each a keyboard-reachable button in a labelled list. The\n * lowest-friction template surface; pass `aria-label` to name the list.\n */\nexport const TemplatesList = React.forwardRef<HTMLUListElement, TemplatesListProps>(\n  ({ items, onSelect, className, ...props }, ref) => (\n    <ul\n      ref={ref}\n      role=\"list\"\n      className={cn(\"m-0 flex list-none flex-col gap-1 p-0\", className)}\n      {...props}\n    >\n      {items.map(toListItem).map((item) => (\n        <li key={item.id ?? item.title}>\n          <button\n            type=\"button\"\n            onClick={() => onSelect?.(item.prompt ?? item.title, item)}\n            className=\"flex w-full items-start gap-2 rounded-md border border-border bg-muted/40 px-3 py-2 text-left text-sm text-foreground transition-colors hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n          >\n            <ArrowRight aria-hidden=\"true\" className=\"mt-0.5 size-4 shrink-0 text-muted-foreground\" />\n            <span className=\"flex min-w-0 flex-col gap-0.5\">\n              <span>{item.title}</span>\n              {item.description && <span className=\"text-xs text-muted-foreground\">{item.description}</span>}\n            </span>\n          </button>\n        </li>\n      ))}\n    </ul>\n  ),\n);\nTemplatesList.displayName = \"TemplatesList\";\n\n/** A named group of templates in a {@link TemplatesBrowser}. */\nexport interface TemplatesCategory {\n  /** Category id. */\n  id: string;\n  /** Tab label (\"Sales\"). */\n  label: string;\n  /** The templates in this category. */\n  templates: Array<string | TemplatesListItem>;\n}\n\nexport interface TemplatesBrowserProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, \"onSelect\" | \"defaultValue\"> {\n  /** The categories, in display order. */\n  categories: TemplatesCategory[];\n  /** Controlled active category id. */\n  category?: string;\n  /** Initial category when uncontrolled. Defaults to the first. */\n  defaultCategory?: string;\n  /** Called when the active category changes. */\n  onCategoryChange?: (id: string) => void;\n  /** Called with the prompt, the item and the category id when a template is picked. */\n  onSelect?: (prompt: string, item: TemplatesListItem, category: string) => void;\n}\n\n/**\n * The categorised template browser: a library of templates grouped by domain,\n * with a vertical tab per category (arrow keys move between them) and the\n * category's templates as a {@link TemplatesList}. Scales to many prompt\n * families.\n */\nexport const TemplatesBrowser = React.forwardRef<HTMLDivElement, TemplatesBrowserProps>(\n  ({ categories, category, defaultCategory, onCategoryChange, onSelect, className, ...props }, ref) => (\n    <Tabs\n      ref={ref}\n      orientation=\"vertical\"\n      value={category}\n      defaultValue={defaultCategory ?? categories[0]?.id ?? \"\"}\n      onValueChange={onCategoryChange}\n      className={cn(\"gap-3\", className)}\n      {...props}\n    >\n      <TabsList aria-label=\"Template categories\" className=\"h-fit shrink-0 bg-transparent p-0\">\n        {categories.map((c) => (\n          <TabsTrigger key={c.id} value={c.id} className=\"justify-start aria-selected:bg-muted aria-selected:shadow-none\">\n            {c.label}\n          </TabsTrigger>\n        ))}\n      </TabsList>\n      {categories.map((c) => (\n        <TabsContent key={c.id} value={c.id} className=\"min-w-0 flex-1\">\n          <TemplatesList\n            aria-label={`${c.label} templates`}\n            items={c.templates}\n            onSelect={(prompt, item) => onSelect?.(prompt, item, c.id)}\n          />\n        </TabsContent>\n      ))}\n    </Tabs>\n  ),\n);\nTemplatesBrowser.displayName = \"TemplatesBrowser\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,94 @@
+import * as React from 'react';
+
+/** A fill-in-the-blank slot: an id, the placeholder shown while empty, and optional type-ahead options. */
+interface PromptSlot {
+    /** Slot id — the key in `values`. */
+    slot: string;
+    /** Shown while the slot is empty, and used in the prompt if it stays empty. */
+    placeholder: string;
+    /** Accessible name of the slot's field. Defaults to `placeholder`. */
+    label?: string;
+    /** Type-ahead options offered while typing (the field stays free text). */
+    options?: string[];
+    /** Must be filled before the template can be used. */
+    required?: boolean;
+}
+/** A literal string, or a fill-in-the-blank slot. */
+type PromptSegment = string | PromptSlot;
+interface TemplatesProps extends Omit<React.FormHTMLAttributes<HTMLFormElement>, "onSubmit"> {
+    /** The template as an ordered mix of literal text and named slots. */
+    segments: PromptSegment[];
+    /** Slot values (controlled), keyed by slot id. */
+    values?: Record<string, string>;
+    /** Initial slot values (uncontrolled). */
+    defaultValues?: Record<string, string>;
+    /** Called when any slot changes. */
+    onValuesChange?: (values: Record<string, string>) => void;
+    /** Called with the interpolated prompt (and raw values) on submit. Nothing runs on its own. */
+    onComplete?: (prompt: string, values: Record<string, string>) => void;
+    /** Submit button label. Defaults to `"Use this prompt"`. */
+    submitLabel?: React.ReactNode;
+}
+/**
+ * The fill-in-the-blank template: a sentence with highlighted slots the user
+ * tabs through, so a good prompt reads as a sentence even before it is
+ * filled. Slots are free-text fields with optional type-ahead `options`;
+ * `required` slots are counted ("1 blank left") and must be filled before the
+ * one-click "Use this prompt" fires `onComplete` with the interpolated text.
+ * For a list of fully written prompts use {@link TemplatesList}; for a library
+ * grouped by domain use {@link TemplatesBrowser}.
+ */
+declare const Templates: React.ForwardRefExoticComponent<TemplatesProps & React.RefAttributes<HTMLFormElement>>;
+/** A fully written template in a list or browser. */
+interface TemplatesListItem {
+    /** Stable id. Defaults to `title`. */
+    id?: string;
+    /** What the user sees ("Summarise yesterday's standup in 3 bullets"). */
+    title: string;
+    /** The prompt handed to `onSelect`. Defaults to `title`. */
+    prompt?: string;
+    /** One supporting line. */
+    description?: string;
+}
+interface TemplatesListProps extends Omit<React.HTMLAttributes<HTMLUListElement>, "onSelect"> {
+    /** The templates, as strings or {@link TemplatesListItem}s. */
+    items: Array<string | TemplatesListItem>;
+    /** Called with the prompt and the item when one is picked. Place it in the composer — never send it. */
+    onSelect?: (prompt: string, item: TemplatesListItem) => void;
+}
+/**
+ * The prefilled-list template surface: fully written prompts the user runs
+ * with one tap, each a keyboard-reachable button in a labelled list. The
+ * lowest-friction template surface; pass `aria-label` to name the list.
+ */
+declare const TemplatesList: React.ForwardRefExoticComponent<TemplatesListProps & React.RefAttributes<HTMLUListElement>>;
+/** A named group of templates in a {@link TemplatesBrowser}. */
+interface TemplatesCategory {
+    /** Category id. */
+    id: string;
+    /** Tab label ("Sales"). */
+    label: string;
+    /** The templates in this category. */
+    templates: Array<string | TemplatesListItem>;
+}
+interface TemplatesBrowserProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onSelect" | "defaultValue"> {
+    /** The categories, in display order. */
+    categories: TemplatesCategory[];
+    /** Controlled active category id. */
+    category?: string;
+    /** Initial category when uncontrolled. Defaults to the first. */
+    defaultCategory?: string;
+    /** Called when the active category changes. */
+    onCategoryChange?: (id: string) => void;
+    /** Called with the prompt, the item and the category id when a template is picked. */
+    onSelect?: (prompt: string, item: TemplatesListItem, category: string) => void;
+}
+/**
+ * The categorised template browser: a library of templates grouped by domain,
+ * with a vertical tab per category (arrow keys move between them) and the
+ * category's templates as a {@link TemplatesList}. Scales to many prompt
+ * families.
+ */
+declare const TemplatesBrowser: React.ForwardRefExoticComponent<TemplatesBrowserProps & React.RefAttributes<HTMLDivElement>>;
+
+export { type PromptSegment, type PromptSlot, Templates, TemplatesBrowser, type TemplatesBrowserProps, type TemplatesCategory, TemplatesList, type TemplatesListItem, type TemplatesListProps, type TemplatesProps };

package/dist/index.d.ts

@@ -0,0 +1,94 @@
+import * as React from 'react';
+
+/** A fill-in-the-blank slot: an id, the placeholder shown while empty, and optional type-ahead options. */
+interface PromptSlot {
+    /** Slot id — the key in `values`. */
+    slot: string;
+    /** Shown while the slot is empty, and used in the prompt if it stays empty. */
+    placeholder: string;
+    /** Accessible name of the slot's field. Defaults to `placeholder`. */
+    label?: string;
+    /** Type-ahead options offered while typing (the field stays free text). */
+    options?: string[];
+    /** Must be filled before the template can be used. */
+    required?: boolean;
+}
+/** A literal string, or a fill-in-the-blank slot. */
+type PromptSegment = string | PromptSlot;
+interface TemplatesProps extends Omit<React.FormHTMLAttributes<HTMLFormElement>, "onSubmit"> {
+    /** The template as an ordered mix of literal text and named slots. */
+    segments: PromptSegment[];
+    /** Slot values (controlled), keyed by slot id. */
+    values?: Record<string, string>;
+    /** Initial slot values (uncontrolled). */
+    defaultValues?: Record<string, string>;
+    /** Called when any slot changes. */
+    onValuesChange?: (values: Record<string, string>) => void;
+    /** Called with the interpolated prompt (and raw values) on submit. Nothing runs on its own. */
+    onComplete?: (prompt: string, values: Record<string, string>) => void;
+    /** Submit button label. Defaults to `"Use this prompt"`. */
+    submitLabel?: React.ReactNode;
+}
+/**
+ * The fill-in-the-blank template: a sentence with highlighted slots the user
+ * tabs through, so a good prompt reads as a sentence even before it is
+ * filled. Slots are free-text fields with optional type-ahead `options`;
+ * `required` slots are counted ("1 blank left") and must be filled before the
+ * one-click "Use this prompt" fires `onComplete` with the interpolated text.
+ * For a list of fully written prompts use {@link TemplatesList}; for a library
+ * grouped by domain use {@link TemplatesBrowser}.
+ */
+declare const Templates: React.ForwardRefExoticComponent<TemplatesProps & React.RefAttributes<HTMLFormElement>>;
+/** A fully written template in a list or browser. */
+interface TemplatesListItem {
+    /** Stable id. Defaults to `title`. */
+    id?: string;
+    /** What the user sees ("Summarise yesterday's standup in 3 bullets"). */
+    title: string;
+    /** The prompt handed to `onSelect`. Defaults to `title`. */
+    prompt?: string;
+    /** One supporting line. */
+    description?: string;
+}
+interface TemplatesListProps extends Omit<React.HTMLAttributes<HTMLUListElement>, "onSelect"> {
+    /** The templates, as strings or {@link TemplatesListItem}s. */
+    items: Array<string | TemplatesListItem>;
+    /** Called with the prompt and the item when one is picked. Place it in the composer — never send it. */
+    onSelect?: (prompt: string, item: TemplatesListItem) => void;
+}
+/**
+ * The prefilled-list template surface: fully written prompts the user runs
+ * with one tap, each a keyboard-reachable button in a labelled list. The
+ * lowest-friction template surface; pass `aria-label` to name the list.
+ */
+declare const TemplatesList: React.ForwardRefExoticComponent<TemplatesListProps & React.RefAttributes<HTMLUListElement>>;
+/** A named group of templates in a {@link TemplatesBrowser}. */
+interface TemplatesCategory {
+    /** Category id. */
+    id: string;
+    /** Tab label ("Sales"). */
+    label: string;
+    /** The templates in this category. */
+    templates: Array<string | TemplatesListItem>;
+}
+interface TemplatesBrowserProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onSelect" | "defaultValue"> {
+    /** The categories, in display order. */
+    categories: TemplatesCategory[];
+    /** Controlled active category id. */
+    category?: string;
+    /** Initial category when uncontrolled. Defaults to the first. */
+    defaultCategory?: string;
+    /** Called when the active category changes. */
+    onCategoryChange?: (id: string) => void;
+    /** Called with the prompt, the item and the category id when a template is picked. */
+    onSelect?: (prompt: string, item: TemplatesListItem, category: string) => void;
+}
+/**
+ * The categorised template browser: a library of templates grouped by domain,
+ * with a vertical tab per category (arrow keys move between them) and the
+ * category's templates as a {@link TemplatesList}. Scales to many prompt
+ * families.
+ */
+declare const TemplatesBrowser: React.ForwardRefExoticComponent<TemplatesBrowserProps & React.RefAttributes<HTMLDivElement>>;
+
+export { type PromptSegment, type PromptSlot, Templates, TemplatesBrowser, type TemplatesBrowserProps, type TemplatesCategory, TemplatesList, type TemplatesListItem, type TemplatesListProps, type TemplatesProps };

package/dist/index.js

@@ -0,0 +1,147 @@
+"use client";
+import * as React from 'react';
+import { ArrowRight } from 'lucide-react';
+import { cn } from '@nucleux/utils';
+import { Button } from '@nucleux/button';
+import { Tabs, TabsList, TabsTrigger, TabsContent } from '@nucleux/tabs';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var Templates = React.forwardRef(
+  ({
+    segments,
+    values,
+    defaultValues = {},
+    onValuesChange,
+    onComplete,
+    submitLabel = "Use this prompt",
+    className,
+    ...props
+  }, ref) => {
+    const [internal, setInternal] = React.useState(defaultValues);
+    const current = values ?? internal;
+    const baseId = React.useId();
+    const setSlot = (slot, val) => {
+      const next = { ...current, [slot]: val };
+      if (values === void 0) setInternal(next);
+      onValuesChange?.(next);
+    };
+    const interpolate = () => segments.map((s) => typeof s === "string" ? s : current[s.slot] || s.placeholder).join("");
+    const required = segments.filter((s) => typeof s !== "string" && !!s.required);
+    const missing = required.filter((s) => !(current[s.slot] ?? "").trim()).length;
+    const statusId = `${baseId}-status`;
+    return /* @__PURE__ */ jsxs(
+      "form",
+      {
+        ref,
+        onSubmit: (e) => {
+          e.preventDefault();
+          if (missing > 0) return;
+          onComplete?.(interpolate(), current);
+        },
+        className: cn("flex flex-col gap-4 rounded-xl border border-border bg-background p-5", className),
+        ...props,
+        children: [
+          /* @__PURE__ */ jsx("p", { className: "text-base leading-loose text-foreground", children: segments.map((segment, i) => {
+            if (typeof segment === "string") return /* @__PURE__ */ jsx(React.Fragment, { children: segment }, i);
+            const val = current[segment.slot] ?? "";
+            const listId = segment.options?.length ? `${baseId}-${segment.slot}-options` : void 0;
+            return /* @__PURE__ */ jsxs(React.Fragment, { children: [
+              /* @__PURE__ */ jsx(
+                "input",
+                {
+                  type: "text",
+                  value: val,
+                  onChange: (e) => setSlot(segment.slot, e.target.value),
+                  placeholder: segment.placeholder,
+                  "aria-label": segment.label ?? segment.placeholder,
+                  "aria-required": segment.required || void 0,
+                  list: listId,
+                  autoComplete: "off",
+                  size: Math.max((val || segment.placeholder).length, 4),
+                  className: cn(
+                    "mx-0.5 inline-block rounded-md border-b-2 border-dashed border-brand/50 bg-brand-muted/40 px-1 text-center text-brand placeholder:text-brand/60 focus:border-solid focus:border-brand focus:outline-none",
+                    val && "border-solid bg-brand-muted"
+                  )
+                }
+              ),
+              listId && /* @__PURE__ */ jsx("datalist", { id: listId, children: segment.options.map((o) => /* @__PURE__ */ jsx("option", { value: o }, o)) })
+            ] }, i);
+          }) }),
+          /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-end gap-3", children: [
+            required.length > 0 && /* @__PURE__ */ jsx("span", { id: statusId, "aria-live": "polite", className: "mr-auto text-sm text-muted-foreground", children: missing === 0 ? "Ready to use" : `${missing} ${missing === 1 ? "blank" : "blanks"} left` }),
+            /* @__PURE__ */ jsx(
+              Button,
+              {
+                type: "submit",
+                variant: "cta",
+                disabled: missing > 0,
+                "aria-describedby": required.length > 0 ? statusId : void 0,
+                children: submitLabel
+              }
+            )
+          ] })
+        ]
+      }
+    );
+  }
+);
+Templates.displayName = "Templates";
+var toListItem = (item) => typeof item === "string" ? { title: item } : item;
+var TemplatesList = React.forwardRef(
+  ({ items, onSelect, className, ...props }, ref) => /* @__PURE__ */ jsx(
+    "ul",
+    {
+      ref,
+      role: "list",
+      className: cn("m-0 flex list-none flex-col gap-1 p-0", className),
+      ...props,
+      children: items.map(toListItem).map((item) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs(
+        "button",
+        {
+          type: "button",
+          onClick: () => onSelect?.(item.prompt ?? item.title, item),
+          className: "flex w-full items-start gap-2 rounded-md border border-border bg-muted/40 px-3 py-2 text-left text-sm text-foreground transition-colors hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+          children: [
+            /* @__PURE__ */ jsx(ArrowRight, { "aria-hidden": "true", className: "mt-0.5 size-4 shrink-0 text-muted-foreground" }),
+            /* @__PURE__ */ jsxs("span", { className: "flex min-w-0 flex-col gap-0.5", children: [
+              /* @__PURE__ */ jsx("span", { children: item.title }),
+              item.description && /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: item.description })
+            ] })
+          ]
+        }
+      ) }, item.id ?? item.title))
+    }
+  )
+);
+TemplatesList.displayName = "TemplatesList";
+var TemplatesBrowser = React.forwardRef(
+  ({ categories, category, defaultCategory, onCategoryChange, onSelect, className, ...props }, ref) => /* @__PURE__ */ jsxs(
+    Tabs,
+    {
+      ref,
+      orientation: "vertical",
+      value: category,
+      defaultValue: defaultCategory ?? categories[0]?.id ?? "",
+      onValueChange: onCategoryChange,
+      className: cn("gap-3", className),
+      ...props,
+      children: [
+        /* @__PURE__ */ jsx(TabsList, { "aria-label": "Template categories", className: "h-fit shrink-0 bg-transparent p-0", children: categories.map((c) => /* @__PURE__ */ jsx(TabsTrigger, { value: c.id, className: "justify-start aria-selected:bg-muted aria-selected:shadow-none", children: c.label }, c.id)) }),
+        categories.map((c) => /* @__PURE__ */ jsx(TabsContent, { value: c.id, className: "min-w-0 flex-1", children: /* @__PURE__ */ jsx(
+          TemplatesList,
+          {
+            "aria-label": `${c.label} templates`,
+            items: c.templates,
+            onSelect: (prompt, item) => onSelect?.(prompt, item, c.id)
+          }
+        ) }, c.id))
+      ]
+    }
+  )
+);
+TemplatesBrowser.displayName = "TemplatesBrowser";
+
+export { Templates, TemplatesBrowser, TemplatesList };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { ArrowRight } from \"lucide-react\";\nimport { cn } from \"@nucleux/utils\";\nimport { Button } from \"@nucleux/button\";\nimport { Tabs, TabsContent, TabsList, TabsTrigger } from \"@nucleux/tabs\";\n\n/** A fill-in-the-blank slot: an id, the placeholder shown while empty, and optional type-ahead options. */\nexport interface PromptSlot {\n  /** Slot id — the key in `values`. */\n  slot: string;\n  /** Shown while the slot is empty, and used in the prompt if it stays empty. */\n  placeholder: string;\n  /** Accessible name of the slot's field. Defaults to `placeholder`. */\n  label?: string;\n  /** Type-ahead options offered while typing (the field stays free text). */\n  options?: string[];\n  /** Must be filled before the template can be used. */\n  required?: boolean;\n}\n\n/** A literal string, or a fill-in-the-blank slot. */\nexport type PromptSegment = string | PromptSlot;\n\nexport interface TemplatesProps extends Omit<React.FormHTMLAttributes<HTMLFormElement>, \"onSubmit\"> {\n  /** The template as an ordered mix of literal text and named slots. */\n  segments: PromptSegment[];\n  /** Slot values (controlled), keyed by slot id. */\n  values?: Record<string, string>;\n  /** Initial slot values (uncontrolled). */\n  defaultValues?: Record<string, string>;\n  /** Called when any slot changes. */\n  onValuesChange?: (values: Record<string, string>) => void;\n  /** Called with the interpolated prompt (and raw values) on submit. Nothing runs on its own. */\n  onComplete?: (prompt: string, values: Record<string, string>) => void;\n  /** Submit button label. Defaults to `\"Use this prompt\"`. */\n  submitLabel?: React.ReactNode;\n}\n\n/**\n * The fill-in-the-blank template: a sentence with highlighted slots the user\n * tabs through, so a good prompt reads as a sentence even before it is\n * filled. Slots are free-text fields with optional type-ahead `options`;\n * `required` slots are counted (\"1 blank left\") and must be filled before the\n * one-click \"Use this prompt\" fires `onComplete` with the interpolated text.\n * For a list of fully written prompts use {@link TemplatesList}; for a library\n * grouped by domain use {@link TemplatesBrowser}.\n */\nexport const Templates = React.forwardRef<HTMLFormElement, TemplatesProps>(\n  (\n    {\n      segments,\n      values,\n      defaultValues = {},\n      onValuesChange,\n      onComplete,\n      submitLabel = \"Use this prompt\",\n      className,\n      ...props\n    },\n    ref,\n  ) => {\n    const [internal, setInternal] = React.useState<Record<string, string>>(defaultValues);\n    const current = values ?? internal;\n    const baseId = React.useId();\n\n    const setSlot = (slot: string, val: string) => {\n      const next = { ...current, [slot]: val };\n      if (values === undefined) setInternal(next);\n      onValuesChange?.(next);\n    };\n\n    const interpolate = () =>\n      segments\n        .map((s) => (typeof s === \"string\" ? s : current[s.slot] || s.placeholder))\n        .join(\"\");\n\n    const required = segments.filter((s): s is PromptSlot => typeof s !== \"string\" && !!s.required);\n    const missing = required.filter((s) => !(current[s.slot] ?? \"\").trim()).length;\n    const statusId = `${baseId}-status`;\n\n    return (\n      <form\n        ref={ref}\n        onSubmit={(e) => {\n          e.preventDefault();\n          if (missing > 0) return;\n          onComplete?.(interpolate(), current);\n        }}\n        className={cn(\"flex flex-col gap-4 rounded-xl border border-border bg-background p-5\", className)}\n        {...props}\n      >\n        <p className=\"text-base leading-loose text-foreground\">\n          {segments.map((segment, i) => {\n            if (typeof segment === \"string\") return <React.Fragment key={i}>{segment}</React.Fragment>;\n            const val = current[segment.slot] ?? \"\";\n            const listId = segment.options?.length ? `${baseId}-${segment.slot}-options` : undefined;\n            return (\n              <React.Fragment key={i}>\n                <input\n                  type=\"text\"\n                  value={val}\n                  onChange={(e) => setSlot(segment.slot, e.target.value)}\n                  placeholder={segment.placeholder}\n                  aria-label={segment.label ?? segment.placeholder}\n                  aria-required={segment.required || undefined}\n                  list={listId}\n                  autoComplete=\"off\"\n                  size={Math.max((val || segment.placeholder).length, 4)}\n                  className={cn(\n                    \"mx-0.5 inline-block rounded-md border-b-2 border-dashed border-brand/50 bg-brand-muted/40 px-1 text-center text-brand placeholder:text-brand/60 focus:border-solid focus:border-brand focus:outline-none\",\n                    val && \"border-solid bg-brand-muted\",\n                  )}\n                />\n                {listId && (\n                  <datalist id={listId}>\n                    {segment.options!.map((o) => (\n                      <option key={o} value={o} />\n                    ))}\n                  </datalist>\n                )}\n              </React.Fragment>\n            );\n          })}\n        </p>\n        <div className=\"flex items-center justify-end gap-3\">\n          {required.length > 0 && (\n            <span id={statusId} aria-live=\"polite\" className=\"mr-auto text-sm text-muted-foreground\">\n              {missing === 0 ? \"Ready to use\" : `${missing} ${missing === 1 ? \"blank\" : \"blanks\"} left`}\n            </span>\n          )}\n          <Button\n            type=\"submit\"\n            variant=\"cta\"\n            disabled={missing > 0}\n            aria-describedby={required.length > 0 ? statusId : undefined}\n          >\n            {submitLabel}\n          </Button>\n        </div>\n      </form>\n    );\n  },\n);\nTemplates.displayName = \"Templates\";\n\n/** A fully written template in a list or browser. */\nexport interface TemplatesListItem {\n  /** Stable id. Defaults to `title`. */\n  id?: string;\n  /** What the user sees (\"Summarise yesterday's standup in 3 bullets\"). */\n  title: string;\n  /** The prompt handed to `onSelect`. Defaults to `title`. */\n  prompt?: string;\n  /** One supporting line. */\n  description?: string;\n}\n\nexport interface TemplatesListProps extends Omit<React.HTMLAttributes<HTMLUListElement>, \"onSelect\"> {\n  /** The templates, as strings or {@link TemplatesListItem}s. */\n  items: Array<string | TemplatesListItem>;\n  /** Called with the prompt and the item when one is picked. Place it in the composer — never send it. */\n  onSelect?: (prompt: string, item: TemplatesListItem) => void;\n}\n\nconst toListItem = (item: string | TemplatesListItem): TemplatesListItem =>\n  typeof item === \"string\" ? { title: item } : item;\n\n/**\n * The prefilled-list template surface: fully written prompts the user runs\n * with one tap, each a keyboard-reachable button in a labelled list. The\n * lowest-friction template surface; pass `aria-label` to name the list.\n */\nexport const TemplatesList = React.forwardRef<HTMLUListElement, TemplatesListProps>(\n  ({ items, onSelect, className, ...props }, ref) => (\n    <ul\n      ref={ref}\n      role=\"list\"\n      className={cn(\"m-0 flex list-none flex-col gap-1 p-0\", className)}\n      {...props}\n    >\n      {items.map(toListItem).map((item) => (\n        <li key={item.id ?? item.title}>\n          <button\n            type=\"button\"\n            onClick={() => onSelect?.(item.prompt ?? item.title, item)}\n            className=\"flex w-full items-start gap-2 rounded-md border border-border bg-muted/40 px-3 py-2 text-left text-sm text-foreground transition-colors hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n          >\n            <ArrowRight aria-hidden=\"true\" className=\"mt-0.5 size-4 shrink-0 text-muted-foreground\" />\n            <span className=\"flex min-w-0 flex-col gap-0.5\">\n              <span>{item.title}</span>\n              {item.description && <span className=\"text-xs text-muted-foreground\">{item.description}</span>}\n            </span>\n          </button>\n        </li>\n      ))}\n    </ul>\n  ),\n);\nTemplatesList.displayName = \"TemplatesList\";\n\n/** A named group of templates in a {@link TemplatesBrowser}. */\nexport interface TemplatesCategory {\n  /** Category id. */\n  id: string;\n  /** Tab label (\"Sales\"). */\n  label: string;\n  /** The templates in this category. */\n  templates: Array<string | TemplatesListItem>;\n}\n\nexport interface TemplatesBrowserProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, \"onSelect\" | \"defaultValue\"> {\n  /** The categories, in display order. */\n  categories: TemplatesCategory[];\n  /** Controlled active category id. */\n  category?: string;\n  /** Initial category when uncontrolled. Defaults to the first. */\n  defaultCategory?: string;\n  /** Called when the active category changes. */\n  onCategoryChange?: (id: string) => void;\n  /** Called with the prompt, the item and the category id when a template is picked. */\n  onSelect?: (prompt: string, item: TemplatesListItem, category: string) => void;\n}\n\n/**\n * The categorised template browser: a library of templates grouped by domain,\n * with a vertical tab per category (arrow keys move between them) and the\n * category's templates as a {@link TemplatesList}. Scales to many prompt\n * families.\n */\nexport const TemplatesBrowser = React.forwardRef<HTMLDivElement, TemplatesBrowserProps>(\n  ({ categories, category, defaultCategory, onCategoryChange, onSelect, className, ...props }, ref) => (\n    <Tabs\n      ref={ref}\n      orientation=\"vertical\"\n      value={category}\n      defaultValue={defaultCategory ?? categories[0]?.id ?? \"\"}\n      onValueChange={onCategoryChange}\n      className={cn(\"gap-3\", className)}\n      {...props}\n    >\n      <TabsList aria-label=\"Template categories\" className=\"h-fit shrink-0 bg-transparent p-0\">\n        {categories.map((c) => (\n          <TabsTrigger key={c.id} value={c.id} className=\"justify-start aria-selected:bg-muted aria-selected:shadow-none\">\n            {c.label}\n          </TabsTrigger>\n        ))}\n      </TabsList>\n      {categories.map((c) => (\n        <TabsContent key={c.id} value={c.id} className=\"min-w-0 flex-1\">\n          <TemplatesList\n            aria-label={`${c.label} templates`}\n            items={c.templates}\n            onSelect={(prompt, item) => onSelect?.(prompt, item, c.id)}\n          />\n        </TabsContent>\n      ))}\n    </Tabs>\n  ),\n);\nTemplatesBrowser.displayName = \"TemplatesBrowser\";\n"]}

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@nucleux/templates",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.7.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Templates — fill-in-the-blank prompt scaffolds that turn vague intent into a good question — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "templates"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "dependencies": {
+    "@nucleux/button": "0.7.0",
+    "@nucleux/tabs": "0.7.0",
+    "@nucleux/utils": "0.7.0",
+    "lucide-react": "^0.469.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "@types/react": "^18.3.18",
+    "react": "^18.3.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelligaia-open-labs/nucleux.git",
+    "directory": "packages/templates"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
 }