@karni/ai-ui 0.0.0-stage → 0.5.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   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.

package/README.md

@@ -1,3 +1,81 @@
-# Temporary Holding Version
+# @karni/ai-ui
 
-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.
+React components for the Karni AI extraction module: ExtractButton and the useExtract hook.
+
+[![npm](https://img.shields.io/npm/v/@karni/ai-ui)](https://www.npmjs.com/package/@karni/ai-ui) [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue)](https://github.com/cbsshekhawat18-lab/karni/blob/main/LICENSE) [![Docs](https://img.shields.io/badge/docs-online-FB5D08)](https://cbsshekhawat18-lab.github.io/karni/ai-extraction/)
+
+Experimental. It composes [`@karni/ui`](https://www.npmjs.com/package/@karni/ui) for the [karni-ai](https://pypi.org/project/karni-ai/) module (`karni add ai`):
+
+- **`ExtractButton`**: a button that opens a dialog, reads rows of a resource
+  from a text, a web page or a PDF (`POST /api/ai/extract/`), shows the import
+  preview (proposed rows, a problem per field, the counts), and commits through
+  the import's own confirmation. Nothing is saved before the commit.
+- **`useExtract(resource)`**: the mutation behind it, for a flow of your own.
+- **`ExtractPreview`**: the preview and its commit, for a flow of your own.
+
+## Install
+
+```bash
+npm install @karni/ai-ui @karni/ui @tanstack/react-query@5
+```
+
+Peer dependencies: `react` / `react-dom` (`^18 || ^19`), `@karni/ui` at this package's version (every Karni package is released at one version),
+`@tanstack/react-query` (`^5`). Wrap your app in `<KarniProvider>` as the
+`@karni/ui` README describes. The client's `baseUrl` carries `/api`.
+
+## ExtractButton
+
+```tsx
+import { ExtractButton } from "@karni/ai-ui";
+
+<ExtractButton
+  resource="products"
+  resourceLabel="products"
+  sources={["text", "pdf"]}
+  onDone={(job) => toast({ title: `${job.result?.created ?? 0} products added` })}
+/>;
+```
+
+| Prop                  | Meaning                                                           |
+| --------------------- | ----------------------------------------------------------------- |
+| `resource`            | the router prefix (`products`)                                    |
+| `resourceLabel`       | the resource in words, plural. Default: `resource`                |
+| `sources`             | the forms offered: `text`, `url`, `pdf` (default: all three)      |
+| `onExtracted(result)` | the preview arrived                                               |
+| `onDone(job)`         | the commit saved the rows                                         |
+| `slots`               | replace `Error`, `Rows`, `Problems`, `Summary` or `ConfirmCommit` |
+
+Every other `@karni/ui` Button prop goes to the trigger. A refusal (an AI code:
+a source that cannot be read, a refused address, a spent budget) shows the
+backend's own words.
+
+## useExtract
+
+```tsx
+import { useImportActions } from "@karni/ui";
+import { useExtract } from "@karni/ai-ui";
+
+const extract = useExtract("products");
+const { commit } = useImportActions("products");
+
+const preview = await extract.mutateAsync({ text }); // or { url } or { file }
+// preview.rows, preview.problems, preview.result: nothing is saved yet
+commit.mutate(preview.id); // the import's own commit
+```
+
+`extractRefusal(error)` returns `{code, detail}` for a refused extraction.
+
+## Tests
+
+```bash
+npm test
+```
+
+## Links
+
+- AI extraction: <https://cbsshekhawat18-lab.github.io/karni/ai-extraction/>
+- The Python module: <https://pypi.org/project/karni-ai/>
+- Karni, the framework this package is part of: <https://github.com/cbsshekhawat18-lab/karni>
+- Changelog: <https://github.com/cbsshekhawat18-lab/karni/blob/main/CHANGELOG.md>
+- Issues: <https://github.com/cbsshekhawat18-lab/karni/issues>
+- License: Apache-2.0. @karni/ai-ui is released with every other Karni package, at one version.

package/dist/index.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,s)=>(s=n==null?{}:e(i(n)),o(r||!n||!n.__esModule||!a.call(n,`default`)?t(s,`default`,{value:n,enumerable:!0}):s,n));let c=require("@karni/ui");c=s(c,1);let l=require("react");l=s(l,1);let u=require("react/jsx-runtime"),d=require("@tanstack/react-query");var f=[{role:`extract-button`,component:`ExtractButton`,package:`@karni/ai-ui`,description:`Reads rows of a resource from a text, a web page or a PDF into the import preview, then commits them.`}];function p(e=c){if(typeof e!=`object`||!e)return!1;let t=e.registerComponentRole;if(typeof t!=`function`)return!1;for(let e of f)t(e.role,e);return!0}function m(e,t,n){return`${e.toLocaleString()} ${e===1?t:n}`}function h(e){return e==null||e===``?(0,u.jsx)(c.EmptyValue,{}):Array.isArray(e)?e.map(String).join(`, `):typeof e==`boolean`?e?`Yes`:`No`:typeof e==`object`?JSON.stringify(e):String(e)}function g(e){let t=[];for(let n of e)for(let e of Object.keys(n))t.includes(e)||t.push(e);return t}function _({rows:e,fields:t}){return(0,u.jsx)(`div`,{className:`overflow-x-auto rounded-md border border-border`,children:(0,u.jsxs)(`table`,{className:`w-full text-sm`,children:[(0,u.jsx)(`caption`,{className:`px-3 py-2 text-left text-sm font-medium text-foreground`,children:`Proposed rows`}),(0,u.jsx)(`thead`,{className:`bg-muted text-left text-xs uppercase text-muted-foreground`,children:(0,u.jsxs)(`tr`,{children:[(0,u.jsx)(`th`,{scope:`col`,className:`px-3 py-2 font-medium`,children:`Row`}),t.map(e=>(0,u.jsx)(`th`,{scope:`col`,className:`px-3 py-2 font-medium`,children:e},e))]})}),(0,u.jsx)(`tbody`,{children:e.map((e,n)=>(0,u.jsxs)(`tr`,{className:`border-t border-border`,children:[(0,u.jsx)(`th`,{scope:`row`,className:`px-3 py-2 text-left font-normal tabular-nums`,children:n+1}),t.map(t=>(0,u.jsx)(`td`,{className:`px-3 py-2`,children:h(e[t])},t))]},n))})]})})}var v={schema:`Reading`,preview:`Preview`};function y({problems:e}){return(0,u.jsx)(`div`,{className:`overflow-x-auto rounded-md border border-border`,children:(0,u.jsxs)(`table`,{className:`w-full text-sm`,children:[(0,u.jsx)(`caption`,{className:`px-3 py-2 text-left text-sm font-medium text-foreground`,children:`Problems`}),(0,u.jsx)(`thead`,{className:`bg-muted text-left text-xs uppercase text-muted-foreground`,children:(0,u.jsxs)(`tr`,{children:[(0,u.jsx)(`th`,{scope:`col`,className:`px-3 py-2 font-medium`,children:`Row`}),(0,u.jsx)(`th`,{scope:`col`,className:`px-3 py-2 font-medium`,children:`Field`}),(0,u.jsx)(`th`,{scope:`col`,className:`px-3 py-2 font-medium`,children:`Problem`}),(0,u.jsx)(`th`,{scope:`col`,className:`px-3 py-2 font-medium`,children:`Found by`})]})}),(0,u.jsx)(`tbody`,{children:e.map((e,t)=>(0,u.jsxs)(`tr`,{className:`border-t border-border`,children:[(0,u.jsx)(`th`,{scope:`row`,className:`px-3 py-2 text-left font-normal tabular-nums`,children:e.row>0?e.row:(0,u.jsx)(c.EmptyValue,{label:`every row`})}),(0,u.jsx)(`td`,{className:`px-3 py-2 font-mono text-xs`,children:e.field||(0,u.jsx)(c.EmptyValue,{label:`the whole row`})}),(0,u.jsx)(`td`,{className:`px-3 py-2`,children:e.message}),(0,u.jsx)(`td`,{className:`px-3 py-2 text-muted-foreground`,children:v[e.source]})]},`${e.row}-${e.field}-${t}`))})]})})}var b={Rows:_,Problems:y,Summary:c.defaultResourceImportSlots.Summary,ConfirmCommit:c.defaultResourceImportSlots.ConfirmCommit,Progress:c.defaultResourceImportSlots.Progress};function x({result:e,resourceLabel:t,onDone:n,onStartOver:r,slots:i}){let a={...b,...i},o=t??e.resource,s=(0,c.useImportJob)(e.resource,e.id).data??e.job,{commit:d}=(0,c.useImportActions)(e.resource),[f,p]=l.useState(!1),h=s.status===`done`,_=s.result??e.result,v=l.useMemo(()=>g(e.rows),[e.rows]);return l.useEffect(()=>{h&&n?.(s)},[h,s.id]),(0,u.jsxs)(`section`,{className:`space-y-3`,"aria-label":`Extraction preview`,"data-step":s.status,children:[(0,u.jsx)(`p`,{role:`status`,className:`text-sm text-muted-foreground`,children:h?`Saved to ${o}: ${m((_?.created??0)+(_?.updated??0),`row`,`rows`)}.`:`Read ${m(e.rows.length,`row`,`rows`)} from ${e.source.label}. Nothing is saved yet.`}),e.rows.length>0?(0,u.jsx)(a.Rows,{rows:e.rows,fields:v}):null,(0,c.isImportInFlight)(s)?(0,u.jsx)(a.Progress,{job:s}):null,_===null?null:(0,u.jsx)(a.Summary,{job:s,result:_}),e.problems.length>0&&!h?(0,u.jsx)(a.Problems,{problems:e.problems}):null,(0,u.jsxs)(`div`,{className:`flex flex-wrap gap-2`,children:[h?null:(0,u.jsx)(c.Button,{onClick:()=>{d.reset(),p(!0)},disabled:d.isPending||_===null||s.status!==`previewed`,children:`Commit`}),r===void 0?null:(0,u.jsx)(c.Button,{variant:`outline`,onClick:r,disabled:d.isPending,children:`Read another source`})]}),!h&&_!==null?(0,u.jsx)(a.ConfirmCommit,{open:f,onOpenChange:e=>{d.isPending||p(e)},job:s,result:_,resourceLabel:o,pending:d.isPending,error:d.error,onConfirm:()=>d.mutate(s.id,{onSuccess:()=>p(!1)})}):null]})}var S=`/ai/extract/`;function C(e){if(!(e instanceof c.KarniApiError)||typeof e.data!=`object`||e.data===null)return;let t=e.data,n=t.code,r=t.detail;if(typeof n==`string`&&/^AI\d{3}$/.test(n)&&typeof r==`string`)return{code:n,detail:r}}function w(e){let t=(0,c.useKarniClient)(),n=(0,d.useQueryClient)();return(0,d.useMutation)({mutationFn:n=>{if(`file`in n){let r=new FormData;return r.append(`resource`,e),r.append(`file`,n.file),t.request(S,{method:`POST`,body:r})}return t.request(S,{method:`POST`,body:{resource:e,...n}})},onSuccess:t=>{n.setQueryData((0,c.importJobKey)(e,t.id),t.job),n.invalidateQueries({queryKey:c.karniKeys.resource(`ai`)})}})}var T={text:`Text`,url:`Web page`,pdf:`PDF`},E={text:`a text`,url:`a web page`,pdf:`a PDF`};function D(e){let t=e.map(e=>E[e]);return t.length<=1?t[0]??`a source`:`${t.slice(0,-1).join(`, `)} or ${t[t.length-1]}`}var O={AI008:`This resource can't be extracted into`,AI009:`You can't add these rows`,AI010:`This source can't be read`,AI011:`This address can't be fetched`,AI012:`This page can't be read`,AI013:`Your monthly budget is spent`,AI014:`The monthly budget is spent`};function k({error:e,resourceLabel:t}){let n=C(e);return n===void 0?(0,u.jsx)(c.ErrorState,{variant:`inline`,error:e,context:{action:`extract`,resource:t}}):(0,u.jsxs)(`div`,{role:`alert`,className:`rounded-md border border-destructive-border bg-destructive-subtle p-3 text-sm`,children:[(0,u.jsx)(`p`,{className:`font-medium text-foreground`,children:O[n.code]??`The extraction failed`}),(0,u.jsx)(`p`,{className:`text-muted-foreground`,children:n.detail})]})}function A({sources:e,pending:t,onSubmit:n}){let r={text:l.useId(),url:l.useId(),pdf:l.useId()},[i,a]=l.useState(e[0]??`text`),[o,s]=l.useState(``),[d,f]=l.useState(``),[p,m]=l.useState(null),h=e=>{e.preventDefault(),i===`text`?n({text:o}):i===`url`?n({url:d}):p!==null&&n({file:p})},g=e=>e===`text`?(0,u.jsxs)(`div`,{className:`grid gap-1.5`,children:[(0,u.jsx)(c.Label,{htmlFor:r.text,children:`Text to read`}),(0,u.jsx)(c.Textarea,{id:r.text,rows:8,required:!0,value:o,onChange:e=>s(e.target.value)})]}):e===`url`?(0,u.jsxs)(`div`,{className:`grid gap-1.5`,children:[(0,u.jsx)(c.Label,{htmlFor:r.url,children:`Address of the page`}),(0,u.jsx)(c.Input,{id:r.url,type:`url`,required:!0,placeholder:`https://`,value:d,onChange:e=>f(e.target.value)})]}):(0,u.jsxs)(`div`,{className:`grid gap-1.5`,children:[(0,u.jsx)(c.Label,{htmlFor:r.pdf,children:`PDF file`}),(0,u.jsx)(c.Input,{id:r.pdf,type:`file`,accept:`application/pdf,.pdf`,className:`cursor-pointer`,onChange:e=>m(e.target.files?.[0]??null)})]});return(0,u.jsxs)(`form`,{onSubmit:h,className:`space-y-3`,"aria-label":`Source to read`,children:[e.length>1?(0,u.jsxs)(c.Tabs,{value:i,onValueChange:e=>a(e),children:[(0,u.jsx)(c.TabsList,{children:e.map(e=>(0,u.jsx)(c.TabsTrigger,{value:e,children:T[e]},e))}),e.map(e=>(0,u.jsx)(c.TabsContent,{value:e,children:g(e)},e))]}):g(i),(0,u.jsx)(c.PendingButton,{type:`submit`,pending:t,pendingLabel:`Reading…`,disabled:i===`pdf`&&p===null,children:`Extract`})]})}function j(e){let{resource:t,resourceLabel:n,sources:r=[`text`,`url`,`pdf`],onExtracted:i,onDone:a,slots:o,children:s,...d}=e,f=n??t,p=o?.Error??k,[m,h]=l.useState(!1),[g,_]=l.useState(void 0),v=w(t),y=()=>{_(void 0),v.reset()};return(0,u.jsx)(c.Modal,{open:m,onOpenChange:e=>{h(e),e||y()},title:`Extract ${f}`,description:`Read ${f} from ${D(r)}. Nothing is saved until you commit the preview.`,className:`max-w-3xl`,trigger:(0,u.jsx)(c.Button,{"data-karni-role":`extract-button`,...d,children:s??`Extract with AI`}),children:g===void 0?(0,u.jsxs)(`div`,{className:`space-y-3`,children:[(0,u.jsx)(A,{sources:r,pending:v.isPending,onSubmit:e=>v.mutate(e,{onSuccess:e=>{_(e),i?.(e)}})}),v.error!==null&&v.error!==void 0?(0,u.jsx)(p,{error:v.error,resourceLabel:f}):null]}):(0,u.jsx)(x,{result:g,resourceLabel:f,onDone:a,onStartOver:y,slots:o})})}p(),exports.AI_COMPONENT_ROLES=f,exports.EXTRACT_PATH=S,exports.ExtractButton=j,exports.ExtractPreview=x,exports.defaultExtractPreviewSlots=b,exports.extractRefusal=C,exports.registerAiRoles=p,exports.rowFields=g,exports.useExtract=w;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["karniUi","EmptyValue","defaultResourceImportSlots","useImportJob","useImportActions","React","isImportInFlight","Button","KarniApiError","useKarniClient","useQueryClient","useMutation","importJobKey","karniKeys","ErrorState","React","Label","Textarea","Input","Tabs","TabsList","TabsTrigger","TabsContent","PendingButton","Modal","Button","__create","__defProp","__getOwnPropDesc","__getOwnPropNames","__getProtoOf","__hasOwnProp","__copyProps","from","keys","i","n","key","to","except","k","desc","__toESM","mod","isNodeMode","target","_karni_ui","react","react_jsx_runtime","_tanstack_react_query","AI_COMPONENT_ROLES","registerAiRoles","registry","candidate","\"registerComponentRole\"","definition","plural","count","one","many","cell","value","rowFields","seen","row","rows","DefaultRows","fields","field","index","FOUND_BY","DefaultProblems","problems","problem","defaultExtractPreviewSlots","ExtractPreview","Slots","slots","label","resourceLabel","result","job","confirmOpen","setConfirmOpen","done","counts","onDone","commit","onStartOver","open","EXTRACT_PATH","extractRefusal","error","data","code","\"code\"","detail","\"detail\"","useExtract","client","queryClient","input","form","resource","SOURCE_LABELS","SOURCE_WORDS","sourceWords","words","sources","source","REFUSAL_TITLES","DefaultExtractError","refusal","SourceForm","ids","kind","setKind","text","setText","url","setUrl","file","setFile","submit","event","onSubmit","ExtractButton","buttonProps","props","ErrorSlot","setOpen","setResult","extract","startOver","next","children","answer","onExtracted"],"sources":["../src/roles.ts","../src/ExtractPreview.tsx","../src/hooks.ts","../src/ExtractButton.tsx","../src/index.ts"],"sourcesContent":["/** Component-role registration, feature-detected on @karni/ui's registry. */\nimport * as karniUi from \"@karni/ui\";\n\nexport interface ComponentRoleDefinition {\n  role: string;\n  component: string;\n  package: string;\n  description: string;\n}\n\nexport const AI_COMPONENT_ROLES: readonly ComponentRoleDefinition[] = [\n  {\n    role: \"extract-button\",\n    component: \"ExtractButton\",\n    package: \"@karni/ai-ui\",\n    description:\n      \"Reads rows of a resource from a text, a web page or a PDF into the import preview, then commits them.\",\n  },\n];\n\ntype RegisterComponentRole = (role: string, definition: ComponentRoleDefinition) => void;\n\n/** Experimental. Registers the package's components in @karni/ui's role registry, if any. */\nexport function registerAiRoles(registry: unknown = karniUi): boolean {\n  if (typeof registry !== \"object\" || registry === null) return false;\n  const candidate = (registry as Record<string, unknown>)[\"registerComponentRole\"];\n  if (typeof candidate !== \"function\") return false;\n  for (const definition of AI_COMPONENT_ROLES) {\n    (candidate as RegisterComponentRole)(definition.role, definition);\n  }\n  return true;\n}\n","/**\n * <ExtractPreview>: the import preview of an extraction, and its commit. Experimental.\n *\n * Shows the proposed rows, a problem per field (found while reading the\n * answer, or by the import's dry run), the preview's counts, and Commit,\n * which confirms through `@karni/ui`'s `useImportActions(resource).commit`:\n * the import's own commit path. Nothing is saved before that.\n *\n * The counts and the confirmation reuse `@karni/ui`'s import slots\n * (`defaultResourceImportSlots.Summary` and `.ConfirmCommit`), so an\n * extraction reads like a file import. Escape hatch: replace any part with\n * `slots` (Rows, Problems, Summary, ConfirmCommit, Progress).\n */\nimport {\n  Button,\n  EmptyValue,\n  defaultResourceImportSlots,\n  isImportInFlight,\n  useImportActions,\n  useImportJob,\n  type ImportConfirmProps,\n  type ImportJob,\n  type ImportProgressProps,\n  type ImportSummaryProps,\n} from \"@karni/ui\";\nimport * as React from \"react\";\nimport type { ExtractProblem, ExtractResult } from \"./types\";\n\n/** Experimental. What the `Rows` slot receives: the proposed rows and their fields. */\nexport interface ExtractRowsProps {\n  rows: ReadonlyArray<Record<string, unknown>>;\n  fields: readonly string[];\n}\n\n/** Experimental. What the `Problems` slot receives: one problem per field, rows from 1. */\nexport interface ExtractProblemsProps {\n  problems: readonly ExtractProblem[];\n}\n\n/** Experimental. The replaceable parts of ExtractPreview. */\nexport interface ExtractPreviewSlots {\n  Rows: React.ComponentType<ExtractRowsProps>;\n  Problems: React.ComponentType<ExtractProblemsProps>;\n  Summary: React.ComponentType<ImportSummaryProps>;\n  ConfirmCommit: React.ComponentType<ImportConfirmProps>;\n  /** A preview or commit running in Celery (more rows than KARNI_IMPORT_INLINE_ROWS). */\n  Progress: React.ComponentType<ImportProgressProps>;\n}\n\nexport interface ExtractPreviewProps {\n  /** The answer of `useExtract`. */\n  result: ExtractResult;\n  /** The resource in words, plural (\"products\"). Default: the router prefix. */\n  resourceLabel?: string;\n  /** Called once the commit saved the rows (the job is `done`). */\n  onDone?: (job: ImportJob) => void;\n  /** Shown as \"Read another source\" when given. */\n  onStartOver?: () => void;\n  slots?: Partial<ExtractPreviewSlots>;\n}\n\nfunction plural(count: number, one: string, many: string): string {\n  return `${count.toLocaleString()} ${count === 1 ? one : many}`;\n}\n\nfunction cell(value: unknown): React.ReactNode {\n  if (value === undefined || value === null || value === \"\") return <EmptyValue />;\n  if (Array.isArray(value)) return value.map(String).join(\", \");\n  if (typeof value === \"boolean\") return value ? \"Yes\" : \"No\";\n  if (typeof value === \"object\") return JSON.stringify(value);\n  return String(value);\n}\n\n/** Experimental. The fields the rows use, in the order they first appear. */\nexport function rowFields(rows: ReadonlyArray<Record<string, unknown>>): string[] {\n  const seen: string[] = [];\n  for (const row of rows) {\n    for (const key of Object.keys(row)) if (!seen.includes(key)) seen.push(key);\n  }\n  return seen;\n}\n\nfunction DefaultRows({ rows, fields }: ExtractRowsProps): React.ReactElement {\n  return (\n    <div className=\"overflow-x-auto rounded-md border border-border\">\n      <table className=\"w-full text-sm\">\n        <caption className=\"px-3 py-2 text-left text-sm font-medium text-foreground\">\n          Proposed rows\n        </caption>\n        <thead className=\"bg-muted text-left text-xs uppercase text-muted-foreground\">\n          <tr>\n            <th scope=\"col\" className=\"px-3 py-2 font-medium\">\n              Row\n            </th>\n            {fields.map((field) => (\n              <th key={field} scope=\"col\" className=\"px-3 py-2 font-medium\">\n                {field}\n              </th>\n            ))}\n          </tr>\n        </thead>\n        <tbody>\n          {rows.map((row, index) => (\n            <tr key={index} className=\"border-t border-border\">\n              <th scope=\"row\" className=\"px-3 py-2 text-left font-normal tabular-nums\">\n                {index + 1}\n              </th>\n              {fields.map((field) => (\n                <td key={field} className=\"px-3 py-2\">\n                  {cell(row[field])}\n                </td>\n              ))}\n            </tr>\n          ))}\n        </tbody>\n      </table>\n    </div>\n  );\n}\n\nconst FOUND_BY: Record<ExtractProblem[\"source\"], string> = {\n  schema: \"Reading\",\n  preview: \"Preview\",\n};\n\nfunction DefaultProblems({ problems }: ExtractProblemsProps): React.ReactElement {\n  return (\n    <div className=\"overflow-x-auto rounded-md border border-border\">\n      <table className=\"w-full text-sm\">\n        <caption className=\"px-3 py-2 text-left text-sm font-medium text-foreground\">\n          Problems\n        </caption>\n        <thead className=\"bg-muted text-left text-xs uppercase text-muted-foreground\">\n          <tr>\n            <th scope=\"col\" className=\"px-3 py-2 font-medium\">\n              Row\n            </th>\n            <th scope=\"col\" className=\"px-3 py-2 font-medium\">\n              Field\n            </th>\n            <th scope=\"col\" className=\"px-3 py-2 font-medium\">\n              Problem\n            </th>\n            <th scope=\"col\" className=\"px-3 py-2 font-medium\">\n              Found by\n            </th>\n          </tr>\n        </thead>\n        <tbody>\n          {problems.map((problem, index) => (\n            <tr key={`${problem.row}-${problem.field}-${index}`} className=\"border-t border-border\">\n              <th scope=\"row\" className=\"px-3 py-2 text-left font-normal tabular-nums\">\n                {problem.row > 0 ? problem.row : <EmptyValue label=\"every row\" />}\n              </th>\n              <td className=\"px-3 py-2 font-mono text-xs\">\n                {problem.field || <EmptyValue label=\"the whole row\" />}\n              </td>\n              <td className=\"px-3 py-2\">{problem.message}</td>\n              <td className=\"px-3 py-2 text-muted-foreground\">{FOUND_BY[problem.source]}</td>\n            </tr>\n          ))}\n        </tbody>\n      </table>\n    </div>\n  );\n}\n\n/** Experimental. Karni's own slots, exported so a project can wrap one instead of rewriting it. */\nexport const defaultExtractPreviewSlots: ExtractPreviewSlots = {\n  Rows: DefaultRows,\n  Problems: DefaultProblems,\n  Summary: defaultResourceImportSlots.Summary,\n  ConfirmCommit: defaultResourceImportSlots.ConfirmCommit,\n  Progress: defaultResourceImportSlots.Progress,\n};\n\n/** Experimental. The preview of an extraction, with the import's own commit. */\nexport function ExtractPreview({\n  result,\n  resourceLabel,\n  onDone,\n  onStartOver,\n  slots,\n}: ExtractPreviewProps): React.ReactElement {\n  const Slots: ExtractPreviewSlots = { ...defaultExtractPreviewSlots, ...slots };\n  const label = resourceLabel ?? result.resource;\n  const jobQuery = useImportJob(result.resource, result.id);\n  const job = jobQuery.data ?? result.job;\n  const { commit } = useImportActions(result.resource);\n  const [confirmOpen, setConfirmOpen] = React.useState(false);\n  const done = job.status === \"done\";\n  const counts = job.result ?? result.result;\n  const fields = React.useMemo(() => rowFields(result.rows), [result.rows]);\n\n  React.useEffect(() => {\n    if (done) onDone?.(job);\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- fire once per completion\n  }, [done, job.id]);\n\n  return (\n    <section className=\"space-y-3\" aria-label=\"Extraction preview\" data-step={job.status}>\n      <p role=\"status\" className=\"text-sm text-muted-foreground\">\n        {done\n          ? `Saved to ${label}: ${plural(\n              (counts?.created ?? 0) + (counts?.updated ?? 0),\n              \"row\",\n              \"rows\",\n            )}.`\n          : `Read ${plural(result.rows.length, \"row\", \"rows\")} from ${result.source.label}. Nothing is saved yet.`}\n      </p>\n      {result.rows.length > 0 ? <Slots.Rows rows={result.rows} fields={fields} /> : null}\n      {isImportInFlight(job) ? <Slots.Progress job={job} /> : null}\n      {counts !== null ? <Slots.Summary job={job} result={counts} /> : null}\n      {result.problems.length > 0 && !done ? <Slots.Problems problems={result.problems} /> : null}\n      <div className=\"flex flex-wrap gap-2\">\n        {done ? null : (\n          <Button\n            onClick={() => {\n              commit.reset();\n              setConfirmOpen(true);\n            }}\n            disabled={commit.isPending || counts === null || job.status !== \"previewed\"}\n          >\n            Commit\n          </Button>\n        )}\n        {onStartOver !== undefined ? (\n          <Button variant=\"outline\" onClick={onStartOver} disabled={commit.isPending}>\n            Read another source\n          </Button>\n        ) : null}\n      </div>\n      {!done && counts !== null ? (\n        <Slots.ConfirmCommit\n          open={confirmOpen}\n          onOpenChange={(open) => {\n            if (!commit.isPending) setConfirmOpen(open);\n          }}\n          job={job}\n          result={counts}\n          resourceLabel={label}\n          pending={commit.isPending}\n          error={commit.error}\n          onConfirm={() => commit.mutate(job.id, { onSuccess: () => setConfirmOpen(false) })}\n        />\n      ) : null}\n    </section>\n  );\n}\n","/**\n * `useExtract(resource)`: a mutation that posts one source to `POST /api/ai/extract/`\n * and resolves with the import preview of the rows read from it. Experimental.\n *\n * Nothing is saved: confirm the preview with `@karni/ui`'s\n * `useImportActions(resource).commit` (the import's own commit). The answer's\n * import job is put in `@karni/ui`'s import job cache, so `useImportJob(resource, id)`\n * has it without a request.\n */\nimport { importJobKey, KarniApiError, karniKeys, useKarniClient } from \"@karni/ui\";\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\nimport type { ExtractInput, ExtractRefusal, ExtractResult } from \"./types\";\n\n/** Experimental. The extraction endpoint, relative to the client's base URL (it carries `/api`). */\nexport const EXTRACT_PATH = \"/ai/extract/\";\n\n/** Experimental. The refusal an extraction answered with (`{code, detail}`), else undefined. */\nexport function extractRefusal(error: unknown): ExtractRefusal | undefined {\n  if (!(error instanceof KarniApiError) || typeof error.data !== \"object\" || error.data === null) {\n    return undefined;\n  }\n  const data = error.data as Record<string, unknown>;\n  const code = data[\"code\"];\n  const detail = data[\"detail\"];\n  if (typeof code === \"string\" && /^AI\\d{3}$/.test(code) && typeof detail === \"string\") {\n    return { code, detail };\n  }\n  return undefined;\n}\n\n/** Experimental. Posts one source for `resource` (a router prefix) and resolves with the preview. */\nexport function useExtract(\n  resource: string,\n): UseMutationResult<ExtractResult, unknown, ExtractInput> {\n  const client = useKarniClient();\n  const queryClient = useQueryClient();\n  return useMutation<ExtractResult, unknown, ExtractInput>({\n    mutationFn: (input) => {\n      if (\"file\" in input) {\n        const form = new FormData();\n        form.append(\"resource\", resource);\n        form.append(\"file\", input.file);\n        return client.request<ExtractResult>(EXTRACT_PATH, { method: \"POST\", body: form });\n      }\n      return client.request<ExtractResult>(EXTRACT_PATH, {\n        method: \"POST\",\n        body: { resource, ...input },\n      });\n    },\n    onSuccess: (result) => {\n      queryClient.setQueryData(importJobKey(resource, result.id), result.job);\n      // The caller's usage list (GET /api/ai/) has one more call.\n      void queryClient.invalidateQueries({ queryKey: karniKeys.resource(\"ai\") });\n    },\n  });\n}\n","/**\n * <ExtractButton>: read rows of a resource from a text, a web page or a PDF. Experimental.\n *\n * The button opens a dialog with one form per source. Extract posts it to\n * `POST /api/ai/extract/` (`useExtract`) and the dialog then shows the\n * import preview of the rows (`<ExtractPreview>`). Commit saves them through\n * the import's own commit, after the same confirmation a file import asks\n * for. Nothing is saved before.\n *\n * The backend decides everything that matters: who may extract into the\n * resource, which fields the model fills, what each row's problems are. A\n * refusal (an AI code: the source, the URL, the budget) is shown in the\n * backend's words.\n *\n * Escape hatches: every `@karni/ui` Button prop passes through to the\n * trigger. `sources` limits the forms. `slots` replaces the error display\n * and the preview's parts. `useExtract` and `<ExtractPreview>` build another\n * flow.\n */\nimport {\n  Button,\n  ErrorState,\n  Input,\n  Label,\n  Modal,\n  PendingButton,\n  Tabs,\n  TabsContent,\n  TabsList,\n  TabsTrigger,\n  Textarea,\n  type ButtonProps,\n  type ImportJob,\n} from \"@karni/ui\";\nimport * as React from \"react\";\nimport { ExtractPreview, type ExtractPreviewSlots } from \"./ExtractPreview\";\nimport { extractRefusal, useExtract } from \"./hooks\";\nimport type { ExtractInput, ExtractResult, ExtractSourceKind } from \"./types\";\n\n/** Experimental. What the `Error` slot receives: why the extraction was refused or failed. */\nexport interface ExtractErrorProps {\n  error: unknown;\n  resourceLabel: string;\n}\n\nexport interface ExtractButtonSlots extends ExtractPreviewSlots {\n  Error: React.ComponentType<ExtractErrorProps>;\n}\n\nexport interface ExtractButtonProps extends Omit<ButtonProps, \"onClick\" | \"onError\"> {\n  /** The resource's router prefix (\"products\"). */\n  resource: string;\n  /** The resource in words, plural (\"products\"). Default: the router prefix. */\n  resourceLabel?: string;\n  /** The forms offered, in order. Default: text, a web page, a PDF. */\n  sources?: readonly ExtractSourceKind[];\n  /** Called with the preview once the rows are read. */\n  onExtracted?: (result: ExtractResult) => void;\n  /** Called once the commit saved the rows. */\n  onDone?: (job: ImportJob) => void;\n  slots?: Partial<ExtractButtonSlots>;\n}\n\nconst SOURCE_LABELS: Record<ExtractSourceKind, string> = {\n  text: \"Text\",\n  url: \"Web page\",\n  pdf: \"PDF\",\n};\n\nconst SOURCE_WORDS: Record<ExtractSourceKind, string> = {\n  text: \"a text\",\n  url: \"a web page\",\n  pdf: \"a PDF\",\n};\n\n/** \"a text, a web page or a PDF\" for the sources offered. */\nfunction sourceWords(sources: readonly ExtractSourceKind[]): string {\n  const words = sources.map((source) => SOURCE_WORDS[source]);\n  if (words.length <= 1) return words[0] ?? \"a source\";\n  return `${words.slice(0, -1).join(\", \")} or ${words[words.length - 1]}`;\n}\n\nconst REFUSAL_TITLES: Record<string, string> = {\n  AI008: \"This resource can't be extracted into\",\n  AI009: \"You can't add these rows\",\n  AI010: \"This source can't be read\",\n  AI011: \"This address can't be fetched\",\n  AI012: \"This page can't be read\",\n  AI013: \"Your monthly budget is spent\",\n  AI014: \"The monthly budget is spent\",\n};\n\n/** The default `Error` slot: an AI refusal in the backend's words, anything else as ErrorState. */\nfunction DefaultExtractError({ error, resourceLabel }: ExtractErrorProps): React.ReactElement {\n  const refusal = extractRefusal(error);\n  if (refusal === undefined) {\n    return (\n      <ErrorState\n        variant=\"inline\"\n        error={error}\n        context={{ action: \"extract\", resource: resourceLabel }}\n      />\n    );\n  }\n  return (\n    <div\n      role=\"alert\"\n      className=\"rounded-md border border-destructive-border bg-destructive-subtle p-3 text-sm\"\n    >\n      <p className=\"font-medium text-foreground\">\n        {REFUSAL_TITLES[refusal.code] ?? \"The extraction failed\"}\n      </p>\n      <p className=\"text-muted-foreground\">{refusal.detail}</p>\n    </div>\n  );\n}\n\ninterface SourceFormProps {\n  sources: readonly ExtractSourceKind[];\n  pending: boolean;\n  onSubmit: (input: ExtractInput) => void;\n}\n\nfunction SourceForm({ sources, pending, onSubmit }: SourceFormProps): React.ReactElement {\n  const ids = {\n    text: React.useId(),\n    url: React.useId(),\n    pdf: React.useId(),\n  };\n  const [kind, setKind] = React.useState<ExtractSourceKind>(sources[0] ?? \"text\");\n  const [text, setText] = React.useState(\"\");\n  const [url, setUrl] = React.useState(\"\");\n  const [file, setFile] = React.useState<File | null>(null);\n\n  const submit = (event: React.FormEvent<HTMLFormElement>): void => {\n    event.preventDefault();\n    if (kind === \"text\") onSubmit({ text });\n    else if (kind === \"url\") onSubmit({ url });\n    else if (file !== null) onSubmit({ file });\n  };\n\n  const field = (source: ExtractSourceKind): React.ReactElement => {\n    if (source === \"text\") {\n      return (\n        <div className=\"grid gap-1.5\">\n          <Label htmlFor={ids.text}>Text to read</Label>\n          <Textarea\n            id={ids.text}\n            rows={8}\n            required\n            value={text}\n            onChange={(event) => setText(event.target.value)}\n          />\n        </div>\n      );\n    }\n    if (source === \"url\") {\n      return (\n        <div className=\"grid gap-1.5\">\n          <Label htmlFor={ids.url}>Address of the page</Label>\n          <Input\n            id={ids.url}\n            type=\"url\"\n            required\n            placeholder=\"https://\"\n            value={url}\n            onChange={(event) => setUrl(event.target.value)}\n          />\n        </div>\n      );\n    }\n    return (\n      <div className=\"grid gap-1.5\">\n        <Label htmlFor={ids.pdf}>PDF file</Label>\n        <Input\n          id={ids.pdf}\n          type=\"file\"\n          accept=\"application/pdf,.pdf\"\n          className=\"cursor-pointer\"\n          onChange={(event) => setFile(event.target.files?.[0] ?? null)}\n        />\n      </div>\n    );\n  };\n\n  return (\n    <form onSubmit={submit} className=\"space-y-3\" aria-label=\"Source to read\">\n      {sources.length > 1 ? (\n        <Tabs value={kind} onValueChange={(value) => setKind(value as ExtractSourceKind)}>\n          <TabsList>\n            {sources.map((source) => (\n              <TabsTrigger key={source} value={source}>\n                {SOURCE_LABELS[source]}\n              </TabsTrigger>\n            ))}\n          </TabsList>\n          {sources.map((source) => (\n            <TabsContent key={source} value={source}>\n              {field(source)}\n            </TabsContent>\n          ))}\n        </Tabs>\n      ) : (\n        field(kind)\n      )}\n      <PendingButton\n        type=\"submit\"\n        pending={pending}\n        pendingLabel=\"Reading…\"\n        disabled={kind === \"pdf\" && file === null}\n      >\n        Extract\n      </PendingButton>\n    </form>\n  );\n}\n\n/** Experimental. A button that reads rows from a source into the import preview. */\nexport function ExtractButton(props: ExtractButtonProps): React.ReactElement {\n  const {\n    resource,\n    resourceLabel,\n    sources = [\"text\", \"url\", \"pdf\"],\n    onExtracted,\n    onDone,\n    slots,\n    children,\n    ...buttonProps\n  } = props;\n  const label = resourceLabel ?? resource;\n  const ErrorSlot = slots?.Error ?? DefaultExtractError;\n  const [open, setOpen] = React.useState(false);\n  const [result, setResult] = React.useState<ExtractResult | undefined>(undefined);\n  const extract = useExtract(resource);\n\n  const startOver = (): void => {\n    setResult(undefined);\n    extract.reset();\n  };\n\n  return (\n    <Modal\n      open={open}\n      onOpenChange={(next) => {\n        setOpen(next);\n        if (!next) startOver();\n      }}\n      title={`Extract ${label}`}\n      description={`Read ${label} from ${sourceWords(sources)}. Nothing is saved until you commit the preview.`}\n      className=\"max-w-3xl\"\n      trigger={\n        <Button data-karni-role=\"extract-button\" {...buttonProps}>\n          {children ?? \"Extract with AI\"}\n        </Button>\n      }\n    >\n      {result === undefined ? (\n        <div className=\"space-y-3\">\n          <SourceForm\n            sources={sources}\n            pending={extract.isPending}\n            onSubmit={(input) =>\n              extract.mutate(input, {\n                onSuccess: (answer) => {\n                  setResult(answer);\n                  onExtracted?.(answer);\n                },\n              })\n            }\n          />\n          {extract.error !== null && extract.error !== undefined ? (\n            <ErrorSlot error={extract.error} resourceLabel={label} />\n          ) : null}\n        </div>\n      ) : (\n        <ExtractPreview\n          result={result}\n          resourceLabel={label}\n          onDone={onDone}\n          onStartOver={startOver}\n          slots={slots}\n        />\n      )}\n    </Modal>\n  );\n}\n","/** @karni/ai-ui public barrel: explicit exports only. Experimental. */\nimport { registerAiRoles } from \"./roles\";\n\nexport { ExtractButton } from \"./ExtractButton\";\nexport type { ExtractButtonProps, ExtractButtonSlots, ExtractErrorProps } from \"./ExtractButton\";\n\nexport { ExtractPreview, defaultExtractPreviewSlots, rowFields } from \"./ExtractPreview\";\nexport type {\n  ExtractPreviewProps,\n  ExtractPreviewSlots,\n  ExtractProblemsProps,\n  ExtractRowsProps,\n} from \"./ExtractPreview\";\n\nexport { EXTRACT_PATH, extractRefusal, useExtract } from \"./hooks\";\n\nexport type {\n  ExtractInput,\n  ExtractProblem,\n  ExtractRefusal,\n  ExtractResult,\n  ExtractSourceKind,\n  ExtractUsage,\n} from \"./types\";\n\nexport { AI_COMPONENT_ROLES, registerAiRoles } from \"./roles\";\nexport type { ComponentRoleDefinition } from \"./roles\";\n\nregisterAiRoles();\n"],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,395 @@
+import * as e from "@karni/ui";
+import { Button as t, EmptyValue as n, ErrorState as r, Input as i, KarniApiError as a, Label as o, Modal as s, PendingButton as c, Tabs as l, TabsContent as u, TabsList as d, TabsTrigger as f, Textarea as p, defaultResourceImportSlots as m, importJobKey as h, isImportInFlight as g, karniKeys as _, useImportActions as v, useImportJob as y, useKarniClient as b } from "@karni/ui";
+import * as x from "react";
+import { jsx as S, jsxs as C } from "react/jsx-runtime";
+import { useMutation as w, useQueryClient as T } from "@tanstack/react-query";
+//#region src/roles.ts
+var E = [{
+	role: "extract-button",
+	component: "ExtractButton",
+	package: "@karni/ai-ui",
+	description: "Reads rows of a resource from a text, a web page or a PDF into the import preview, then commits them."
+}];
+function D(t = e) {
+	if (typeof t != "object" || !t) return !1;
+	let n = t.registerComponentRole;
+	if (typeof n != "function") return !1;
+	for (let e of E) n(e.role, e);
+	return !0;
+}
+//#endregion
+//#region src/ExtractPreview.tsx
+function O(e, t, n) {
+	return `${e.toLocaleString()} ${e === 1 ? t : n}`;
+}
+function k(e) {
+	return e == null || e === "" ? /* @__PURE__ */ S(n, {}) : Array.isArray(e) ? e.map(String).join(", ") : typeof e == "boolean" ? e ? "Yes" : "No" : typeof e == "object" ? JSON.stringify(e) : String(e);
+}
+function A(e) {
+	let t = [];
+	for (let n of e) for (let e of Object.keys(n)) t.includes(e) || t.push(e);
+	return t;
+}
+function j({ rows: e, fields: t }) {
+	return /* @__PURE__ */ S("div", {
+		className: "overflow-x-auto rounded-md border border-border",
+		children: /* @__PURE__ */ C("table", {
+			className: "w-full text-sm",
+			children: [
+				/* @__PURE__ */ S("caption", {
+					className: "px-3 py-2 text-left text-sm font-medium text-foreground",
+					children: "Proposed rows"
+				}),
+				/* @__PURE__ */ S("thead", {
+					className: "bg-muted text-left text-xs uppercase text-muted-foreground",
+					children: /* @__PURE__ */ C("tr", { children: [/* @__PURE__ */ S("th", {
+						scope: "col",
+						className: "px-3 py-2 font-medium",
+						children: "Row"
+					}), t.map((e) => /* @__PURE__ */ S("th", {
+						scope: "col",
+						className: "px-3 py-2 font-medium",
+						children: e
+					}, e))] })
+				}),
+				/* @__PURE__ */ S("tbody", { children: e.map((e, n) => /* @__PURE__ */ C("tr", {
+					className: "border-t border-border",
+					children: [/* @__PURE__ */ S("th", {
+						scope: "row",
+						className: "px-3 py-2 text-left font-normal tabular-nums",
+						children: n + 1
+					}), t.map((t) => /* @__PURE__ */ S("td", {
+						className: "px-3 py-2",
+						children: k(e[t])
+					}, t))]
+				}, n)) })
+			]
+		})
+	});
+}
+var M = {
+	schema: "Reading",
+	preview: "Preview"
+};
+function N({ problems: e }) {
+	return /* @__PURE__ */ S("div", {
+		className: "overflow-x-auto rounded-md border border-border",
+		children: /* @__PURE__ */ C("table", {
+			className: "w-full text-sm",
+			children: [
+				/* @__PURE__ */ S("caption", {
+					className: "px-3 py-2 text-left text-sm font-medium text-foreground",
+					children: "Problems"
+				}),
+				/* @__PURE__ */ S("thead", {
+					className: "bg-muted text-left text-xs uppercase text-muted-foreground",
+					children: /* @__PURE__ */ C("tr", { children: [
+						/* @__PURE__ */ S("th", {
+							scope: "col",
+							className: "px-3 py-2 font-medium",
+							children: "Row"
+						}),
+						/* @__PURE__ */ S("th", {
+							scope: "col",
+							className: "px-3 py-2 font-medium",
+							children: "Field"
+						}),
+						/* @__PURE__ */ S("th", {
+							scope: "col",
+							className: "px-3 py-2 font-medium",
+							children: "Problem"
+						}),
+						/* @__PURE__ */ S("th", {
+							scope: "col",
+							className: "px-3 py-2 font-medium",
+							children: "Found by"
+						})
+					] })
+				}),
+				/* @__PURE__ */ S("tbody", { children: e.map((e, t) => /* @__PURE__ */ C("tr", {
+					className: "border-t border-border",
+					children: [
+						/* @__PURE__ */ S("th", {
+							scope: "row",
+							className: "px-3 py-2 text-left font-normal tabular-nums",
+							children: e.row > 0 ? e.row : /* @__PURE__ */ S(n, { label: "every row" })
+						}),
+						/* @__PURE__ */ S("td", {
+							className: "px-3 py-2 font-mono text-xs",
+							children: e.field || /* @__PURE__ */ S(n, { label: "the whole row" })
+						}),
+						/* @__PURE__ */ S("td", {
+							className: "px-3 py-2",
+							children: e.message
+						}),
+						/* @__PURE__ */ S("td", {
+							className: "px-3 py-2 text-muted-foreground",
+							children: M[e.source]
+						})
+					]
+				}, `${e.row}-${e.field}-${t}`)) })
+			]
+		})
+	});
+}
+var P = {
+	Rows: j,
+	Problems: N,
+	Summary: m.Summary,
+	ConfirmCommit: m.ConfirmCommit,
+	Progress: m.Progress
+};
+function F({ result: e, resourceLabel: n, onDone: r, onStartOver: i, slots: a }) {
+	let o = {
+		...P,
+		...a
+	}, s = n ?? e.resource, c = y(e.resource, e.id).data ?? e.job, { commit: l } = v(e.resource), [u, d] = x.useState(!1), f = c.status === "done", p = c.result ?? e.result, m = x.useMemo(() => A(e.rows), [e.rows]);
+	return x.useEffect(() => {
+		f && r?.(c);
+	}, [f, c.id]), /* @__PURE__ */ C("section", {
+		className: "space-y-3",
+		"aria-label": "Extraction preview",
+		"data-step": c.status,
+		children: [
+			/* @__PURE__ */ S("p", {
+				role: "status",
+				className: "text-sm text-muted-foreground",
+				children: f ? `Saved to ${s}: ${O((p?.created ?? 0) + (p?.updated ?? 0), "row", "rows")}.` : `Read ${O(e.rows.length, "row", "rows")} from ${e.source.label}. Nothing is saved yet.`
+			}),
+			e.rows.length > 0 ? /* @__PURE__ */ S(o.Rows, {
+				rows: e.rows,
+				fields: m
+			}) : null,
+			g(c) ? /* @__PURE__ */ S(o.Progress, { job: c }) : null,
+			p === null ? null : /* @__PURE__ */ S(o.Summary, {
+				job: c,
+				result: p
+			}),
+			e.problems.length > 0 && !f ? /* @__PURE__ */ S(o.Problems, { problems: e.problems }) : null,
+			/* @__PURE__ */ C("div", {
+				className: "flex flex-wrap gap-2",
+				children: [f ? null : /* @__PURE__ */ S(t, {
+					onClick: () => {
+						l.reset(), d(!0);
+					},
+					disabled: l.isPending || p === null || c.status !== "previewed",
+					children: "Commit"
+				}), i === void 0 ? null : /* @__PURE__ */ S(t, {
+					variant: "outline",
+					onClick: i,
+					disabled: l.isPending,
+					children: "Read another source"
+				})]
+			}),
+			!f && p !== null ? /* @__PURE__ */ S(o.ConfirmCommit, {
+				open: u,
+				onOpenChange: (e) => {
+					l.isPending || d(e);
+				},
+				job: c,
+				result: p,
+				resourceLabel: s,
+				pending: l.isPending,
+				error: l.error,
+				onConfirm: () => l.mutate(c.id, { onSuccess: () => d(!1) })
+			}) : null
+		]
+	});
+}
+//#endregion
+//#region src/hooks.ts
+var I = "/ai/extract/";
+function L(e) {
+	if (!(e instanceof a) || typeof e.data != "object" || e.data === null) return;
+	let t = e.data, n = t.code, r = t.detail;
+	if (typeof n == "string" && /^AI\d{3}$/.test(n) && typeof r == "string") return {
+		code: n,
+		detail: r
+	};
+}
+function R(e) {
+	let t = b(), n = T();
+	return w({
+		mutationFn: (n) => {
+			if ("file" in n) {
+				let r = new FormData();
+				return r.append("resource", e), r.append("file", n.file), t.request(I, {
+					method: "POST",
+					body: r
+				});
+			}
+			return t.request(I, {
+				method: "POST",
+				body: {
+					resource: e,
+					...n
+				}
+			});
+		},
+		onSuccess: (t) => {
+			n.setQueryData(h(e, t.id), t.job), n.invalidateQueries({ queryKey: _.resource("ai") });
+		}
+	});
+}
+//#endregion
+//#region src/ExtractButton.tsx
+var z = {
+	text: "Text",
+	url: "Web page",
+	pdf: "PDF"
+}, B = {
+	text: "a text",
+	url: "a web page",
+	pdf: "a PDF"
+};
+function V(e) {
+	let t = e.map((e) => B[e]);
+	return t.length <= 1 ? t[0] ?? "a source" : `${t.slice(0, -1).join(", ")} or ${t[t.length - 1]}`;
+}
+var H = {
+	AI008: "This resource can't be extracted into",
+	AI009: "You can't add these rows",
+	AI010: "This source can't be read",
+	AI011: "This address can't be fetched",
+	AI012: "This page can't be read",
+	AI013: "Your monthly budget is spent",
+	AI014: "The monthly budget is spent"
+};
+function U({ error: e, resourceLabel: t }) {
+	let n = L(e);
+	return n === void 0 ? /* @__PURE__ */ S(r, {
+		variant: "inline",
+		error: e,
+		context: {
+			action: "extract",
+			resource: t
+		}
+	}) : /* @__PURE__ */ C("div", {
+		role: "alert",
+		className: "rounded-md border border-destructive-border bg-destructive-subtle p-3 text-sm",
+		children: [/* @__PURE__ */ S("p", {
+			className: "font-medium text-foreground",
+			children: H[n.code] ?? "The extraction failed"
+		}), /* @__PURE__ */ S("p", {
+			className: "text-muted-foreground",
+			children: n.detail
+		})]
+	});
+}
+function W({ sources: e, pending: t, onSubmit: n }) {
+	let r = {
+		text: x.useId(),
+		url: x.useId(),
+		pdf: x.useId()
+	}, [a, s] = x.useState(e[0] ?? "text"), [m, h] = x.useState(""), [g, _] = x.useState(""), [v, y] = x.useState(null), b = (e) => {
+		e.preventDefault(), a === "text" ? n({ text: m }) : a === "url" ? n({ url: g }) : v !== null && n({ file: v });
+	}, w = (e) => e === "text" ? /* @__PURE__ */ C("div", {
+		className: "grid gap-1.5",
+		children: [/* @__PURE__ */ S(o, {
+			htmlFor: r.text,
+			children: "Text to read"
+		}), /* @__PURE__ */ S(p, {
+			id: r.text,
+			rows: 8,
+			required: !0,
+			value: m,
+			onChange: (e) => h(e.target.value)
+		})]
+	}) : e === "url" ? /* @__PURE__ */ C("div", {
+		className: "grid gap-1.5",
+		children: [/* @__PURE__ */ S(o, {
+			htmlFor: r.url,
+			children: "Address of the page"
+		}), /* @__PURE__ */ S(i, {
+			id: r.url,
+			type: "url",
+			required: !0,
+			placeholder: "https://",
+			value: g,
+			onChange: (e) => _(e.target.value)
+		})]
+	}) : /* @__PURE__ */ C("div", {
+		className: "grid gap-1.5",
+		children: [/* @__PURE__ */ S(o, {
+			htmlFor: r.pdf,
+			children: "PDF file"
+		}), /* @__PURE__ */ S(i, {
+			id: r.pdf,
+			type: "file",
+			accept: "application/pdf,.pdf",
+			className: "cursor-pointer",
+			onChange: (e) => y(e.target.files?.[0] ?? null)
+		})]
+	});
+	return /* @__PURE__ */ C("form", {
+		onSubmit: b,
+		className: "space-y-3",
+		"aria-label": "Source to read",
+		children: [e.length > 1 ? /* @__PURE__ */ C(l, {
+			value: a,
+			onValueChange: (e) => s(e),
+			children: [/* @__PURE__ */ S(d, { children: e.map((e) => /* @__PURE__ */ S(f, {
+				value: e,
+				children: z[e]
+			}, e)) }), e.map((e) => /* @__PURE__ */ S(u, {
+				value: e,
+				children: w(e)
+			}, e))]
+		}) : w(a), /* @__PURE__ */ S(c, {
+			type: "submit",
+			pending: t,
+			pendingLabel: "Reading…",
+			disabled: a === "pdf" && v === null,
+			children: "Extract"
+		})]
+	});
+}
+function G(e) {
+	let { resource: n, resourceLabel: r, sources: i = [
+		"text",
+		"url",
+		"pdf"
+	], onExtracted: a, onDone: o, slots: c, children: l, ...u } = e, d = r ?? n, f = c?.Error ?? U, [p, m] = x.useState(!1), [h, g] = x.useState(void 0), _ = R(n), v = () => {
+		g(void 0), _.reset();
+	};
+	return /* @__PURE__ */ S(s, {
+		open: p,
+		onOpenChange: (e) => {
+			m(e), e || v();
+		},
+		title: `Extract ${d}`,
+		description: `Read ${d} from ${V(i)}. Nothing is saved until you commit the preview.`,
+		className: "max-w-3xl",
+		trigger: /* @__PURE__ */ S(t, {
+			"data-karni-role": "extract-button",
+			...u,
+			children: l ?? "Extract with AI"
+		}),
+		children: h === void 0 ? /* @__PURE__ */ C("div", {
+			className: "space-y-3",
+			children: [/* @__PURE__ */ S(W, {
+				sources: i,
+				pending: _.isPending,
+				onSubmit: (e) => _.mutate(e, { onSuccess: (e) => {
+					g(e), a?.(e);
+				} })
+			}), _.error !== null && _.error !== void 0 ? /* @__PURE__ */ S(f, {
+				error: _.error,
+				resourceLabel: d
+			}) : null]
+		}) : /* @__PURE__ */ S(F, {
+			result: h,
+			resourceLabel: d,
+			onDone: o,
+			onStartOver: v,
+			slots: c
+		})
+	});
+}
+//#endregion
+//#region src/index.ts
+D();
+//#endregion
+export { E as AI_COMPONENT_ROLES, I as EXTRACT_PATH, G as ExtractButton, F as ExtractPreview, P as defaultExtractPreviewSlots, L as extractRefusal, D as registerAiRoles, A as rowFields, R as useExtract };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["karniUi","React","AI_COMPONENT_ROLES","registerAiRoles","registry","candidate","\"registerComponentRole\"","definition","plural","count","one","many","cell","value","EmptyValue","rowFields","seen","row","rows","key","DefaultRows","fields","field","index","FOUND_BY","DefaultProblems","problems","problem","defaultExtractPreviewSlots","defaultResourceImportSlots","ExtractPreview","Slots","slots","label","resourceLabel","result","job","useImportJob","useImportActions","confirmOpen","setConfirmOpen","done","counts","onDone","isImportInFlight","Button","commit","onStartOver","open","EXTRACT_PATH","extractRefusal","error","KarniApiError","data","code","\"code\"","detail","\"detail\"","useExtract","client","useKarniClient","queryClient","useQueryClient","useMutation","input","form","resource","importJobKey","karniKeys","SOURCE_LABELS","SOURCE_WORDS","sourceWords","words","sources","source","REFUSAL_TITLES","DefaultExtractError","refusal","ErrorState","SourceForm","ids","kind","setKind","text","setText","url","setUrl","file","setFile","submit","event","onSubmit","Label","Textarea","Input","Tabs","TabsList","TabsTrigger","TabsContent","PendingButton","ExtractButton","buttonProps","props","ErrorSlot","setOpen","setResult","extract","startOver","Modal","next","children","answer","onExtracted"],"sources":["../src/roles.ts","../src/ExtractPreview.tsx","../src/hooks.ts","../src/ExtractButton.tsx","../src/index.ts"],"sourcesContent":["/** Component-role registration, feature-detected on @karni/ui's registry. */\nimport * as karniUi from \"@karni/ui\";\n\nexport interface ComponentRoleDefinition {\n  role: string;\n  component: string;\n  package: string;\n  description: string;\n}\n\nexport const AI_COMPONENT_ROLES: readonly ComponentRoleDefinition[] = [\n  {\n    role: \"extract-button\",\n    component: \"ExtractButton\",\n    package: \"@karni/ai-ui\",\n    description:\n      \"Reads rows of a resource from a text, a web page or a PDF into the import preview, then commits them.\",\n  },\n];\n\ntype RegisterComponentRole = (role: string, definition: ComponentRoleDefinition) => void;\n\n/** Experimental. Registers the package's components in @karni/ui's role registry, if any. */\nexport function registerAiRoles(registry: unknown = karniUi): boolean {\n  if (typeof registry !== \"object\" || registry === null) return false;\n  const candidate = (registry as Record<string, unknown>)[\"registerComponentRole\"];\n  if (typeof candidate !== \"function\") return false;\n  for (const definition of AI_COMPONENT_ROLES) {\n    (candidate as RegisterComponentRole)(definition.role, definition);\n  }\n  return true;\n}\n","/**\n * <ExtractPreview>: the import preview of an extraction, and its commit. Experimental.\n *\n * Shows the proposed rows, a problem per field (found while reading the\n * answer, or by the import's dry run), the preview's counts, and Commit,\n * which confirms through `@karni/ui`'s `useImportActions(resource).commit`:\n * the import's own commit path. Nothing is saved before that.\n *\n * The counts and the confirmation reuse `@karni/ui`'s import slots\n * (`defaultResourceImportSlots.Summary` and `.ConfirmCommit`), so an\n * extraction reads like a file import. Escape hatch: replace any part with\n * `slots` (Rows, Problems, Summary, ConfirmCommit, Progress).\n */\nimport {\n  Button,\n  EmptyValue,\n  defaultResourceImportSlots,\n  isImportInFlight,\n  useImportActions,\n  useImportJob,\n  type ImportConfirmProps,\n  type ImportJob,\n  type ImportProgressProps,\n  type ImportSummaryProps,\n} from \"@karni/ui\";\nimport * as React from \"react\";\nimport type { ExtractProblem, ExtractResult } from \"./types\";\n\n/** Experimental. What the `Rows` slot receives: the proposed rows and their fields. */\nexport interface ExtractRowsProps {\n  rows: ReadonlyArray<Record<string, unknown>>;\n  fields: readonly string[];\n}\n\n/** Experimental. What the `Problems` slot receives: one problem per field, rows from 1. */\nexport interface ExtractProblemsProps {\n  problems: readonly ExtractProblem[];\n}\n\n/** Experimental. The replaceable parts of ExtractPreview. */\nexport interface ExtractPreviewSlots {\n  Rows: React.ComponentType<ExtractRowsProps>;\n  Problems: React.ComponentType<ExtractProblemsProps>;\n  Summary: React.ComponentType<ImportSummaryProps>;\n  ConfirmCommit: React.ComponentType<ImportConfirmProps>;\n  /** A preview or commit running in Celery (more rows than KARNI_IMPORT_INLINE_ROWS). */\n  Progress: React.ComponentType<ImportProgressProps>;\n}\n\nexport interface ExtractPreviewProps {\n  /** The answer of `useExtract`. */\n  result: ExtractResult;\n  /** The resource in words, plural (\"products\"). Default: the router prefix. */\n  resourceLabel?: string;\n  /** Called once the commit saved the rows (the job is `done`). */\n  onDone?: (job: ImportJob) => void;\n  /** Shown as \"Read another source\" when given. */\n  onStartOver?: () => void;\n  slots?: Partial<ExtractPreviewSlots>;\n}\n\nfunction plural(count: number, one: string, many: string): string {\n  return `${count.toLocaleString()} ${count === 1 ? one : many}`;\n}\n\nfunction cell(value: unknown): React.ReactNode {\n  if (value === undefined || value === null || value === \"\") return <EmptyValue />;\n  if (Array.isArray(value)) return value.map(String).join(\", \");\n  if (typeof value === \"boolean\") return value ? \"Yes\" : \"No\";\n  if (typeof value === \"object\") return JSON.stringify(value);\n  return String(value);\n}\n\n/** Experimental. The fields the rows use, in the order they first appear. */\nexport function rowFields(rows: ReadonlyArray<Record<string, unknown>>): string[] {\n  const seen: string[] = [];\n  for (const row of rows) {\n    for (const key of Object.keys(row)) if (!seen.includes(key)) seen.push(key);\n  }\n  return seen;\n}\n\nfunction DefaultRows({ rows, fields }: ExtractRowsProps): React.ReactElement {\n  return (\n    <div className=\"overflow-x-auto rounded-md border border-border\">\n      <table className=\"w-full text-sm\">\n        <caption className=\"px-3 py-2 text-left text-sm font-medium text-foreground\">\n          Proposed rows\n        </caption>\n        <thead className=\"bg-muted text-left text-xs uppercase text-muted-foreground\">\n          <tr>\n            <th scope=\"col\" className=\"px-3 py-2 font-medium\">\n              Row\n            </th>\n            {fields.map((field) => (\n              <th key={field} scope=\"col\" className=\"px-3 py-2 font-medium\">\n                {field}\n              </th>\n            ))}\n          </tr>\n        </thead>\n        <tbody>\n          {rows.map((row, index) => (\n            <tr key={index} className=\"border-t border-border\">\n              <th scope=\"row\" className=\"px-3 py-2 text-left font-normal tabular-nums\">\n                {index + 1}\n              </th>\n              {fields.map((field) => (\n                <td key={field} className=\"px-3 py-2\">\n                  {cell(row[field])}\n                </td>\n              ))}\n            </tr>\n          ))}\n        </tbody>\n      </table>\n    </div>\n  );\n}\n\nconst FOUND_BY: Record<ExtractProblem[\"source\"], string> = {\n  schema: \"Reading\",\n  preview: \"Preview\",\n};\n\nfunction DefaultProblems({ problems }: ExtractProblemsProps): React.ReactElement {\n  return (\n    <div className=\"overflow-x-auto rounded-md border border-border\">\n      <table className=\"w-full text-sm\">\n        <caption className=\"px-3 py-2 text-left text-sm font-medium text-foreground\">\n          Problems\n        </caption>\n        <thead className=\"bg-muted text-left text-xs uppercase text-muted-foreground\">\n          <tr>\n            <th scope=\"col\" className=\"px-3 py-2 font-medium\">\n              Row\n            </th>\n            <th scope=\"col\" className=\"px-3 py-2 font-medium\">\n              Field\n            </th>\n            <th scope=\"col\" className=\"px-3 py-2 font-medium\">\n              Problem\n            </th>\n            <th scope=\"col\" className=\"px-3 py-2 font-medium\">\n              Found by\n            </th>\n          </tr>\n        </thead>\n        <tbody>\n          {problems.map((problem, index) => (\n            <tr key={`${problem.row}-${problem.field}-${index}`} className=\"border-t border-border\">\n              <th scope=\"row\" className=\"px-3 py-2 text-left font-normal tabular-nums\">\n                {problem.row > 0 ? problem.row : <EmptyValue label=\"every row\" />}\n              </th>\n              <td className=\"px-3 py-2 font-mono text-xs\">\n                {problem.field || <EmptyValue label=\"the whole row\" />}\n              </td>\n              <td className=\"px-3 py-2\">{problem.message}</td>\n              <td className=\"px-3 py-2 text-muted-foreground\">{FOUND_BY[problem.source]}</td>\n            </tr>\n          ))}\n        </tbody>\n      </table>\n    </div>\n  );\n}\n\n/** Experimental. Karni's own slots, exported so a project can wrap one instead of rewriting it. */\nexport const defaultExtractPreviewSlots: ExtractPreviewSlots = {\n  Rows: DefaultRows,\n  Problems: DefaultProblems,\n  Summary: defaultResourceImportSlots.Summary,\n  ConfirmCommit: defaultResourceImportSlots.ConfirmCommit,\n  Progress: defaultResourceImportSlots.Progress,\n};\n\n/** Experimental. The preview of an extraction, with the import's own commit. */\nexport function ExtractPreview({\n  result,\n  resourceLabel,\n  onDone,\n  onStartOver,\n  slots,\n}: ExtractPreviewProps): React.ReactElement {\n  const Slots: ExtractPreviewSlots = { ...defaultExtractPreviewSlots, ...slots };\n  const label = resourceLabel ?? result.resource;\n  const jobQuery = useImportJob(result.resource, result.id);\n  const job = jobQuery.data ?? result.job;\n  const { commit } = useImportActions(result.resource);\n  const [confirmOpen, setConfirmOpen] = React.useState(false);\n  const done = job.status === \"done\";\n  const counts = job.result ?? result.result;\n  const fields = React.useMemo(() => rowFields(result.rows), [result.rows]);\n\n  React.useEffect(() => {\n    if (done) onDone?.(job);\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- fire once per completion\n  }, [done, job.id]);\n\n  return (\n    <section className=\"space-y-3\" aria-label=\"Extraction preview\" data-step={job.status}>\n      <p role=\"status\" className=\"text-sm text-muted-foreground\">\n        {done\n          ? `Saved to ${label}: ${plural(\n              (counts?.created ?? 0) + (counts?.updated ?? 0),\n              \"row\",\n              \"rows\",\n            )}.`\n          : `Read ${plural(result.rows.length, \"row\", \"rows\")} from ${result.source.label}. Nothing is saved yet.`}\n      </p>\n      {result.rows.length > 0 ? <Slots.Rows rows={result.rows} fields={fields} /> : null}\n      {isImportInFlight(job) ? <Slots.Progress job={job} /> : null}\n      {counts !== null ? <Slots.Summary job={job} result={counts} /> : null}\n      {result.problems.length > 0 && !done ? <Slots.Problems problems={result.problems} /> : null}\n      <div className=\"flex flex-wrap gap-2\">\n        {done ? null : (\n          <Button\n            onClick={() => {\n              commit.reset();\n              setConfirmOpen(true);\n            }}\n            disabled={commit.isPending || counts === null || job.status !== \"previewed\"}\n          >\n            Commit\n          </Button>\n        )}\n        {onStartOver !== undefined ? (\n          <Button variant=\"outline\" onClick={onStartOver} disabled={commit.isPending}>\n            Read another source\n          </Button>\n        ) : null}\n      </div>\n      {!done && counts !== null ? (\n        <Slots.ConfirmCommit\n          open={confirmOpen}\n          onOpenChange={(open) => {\n            if (!commit.isPending) setConfirmOpen(open);\n          }}\n          job={job}\n          result={counts}\n          resourceLabel={label}\n          pending={commit.isPending}\n          error={commit.error}\n          onConfirm={() => commit.mutate(job.id, { onSuccess: () => setConfirmOpen(false) })}\n        />\n      ) : null}\n    </section>\n  );\n}\n","/**\n * `useExtract(resource)`: a mutation that posts one source to `POST /api/ai/extract/`\n * and resolves with the import preview of the rows read from it. Experimental.\n *\n * Nothing is saved: confirm the preview with `@karni/ui`'s\n * `useImportActions(resource).commit` (the import's own commit). The answer's\n * import job is put in `@karni/ui`'s import job cache, so `useImportJob(resource, id)`\n * has it without a request.\n */\nimport { importJobKey, KarniApiError, karniKeys, useKarniClient } from \"@karni/ui\";\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\nimport type { ExtractInput, ExtractRefusal, ExtractResult } from \"./types\";\n\n/** Experimental. The extraction endpoint, relative to the client's base URL (it carries `/api`). */\nexport const EXTRACT_PATH = \"/ai/extract/\";\n\n/** Experimental. The refusal an extraction answered with (`{code, detail}`), else undefined. */\nexport function extractRefusal(error: unknown): ExtractRefusal | undefined {\n  if (!(error instanceof KarniApiError) || typeof error.data !== \"object\" || error.data === null) {\n    return undefined;\n  }\n  const data = error.data as Record<string, unknown>;\n  const code = data[\"code\"];\n  const detail = data[\"detail\"];\n  if (typeof code === \"string\" && /^AI\\d{3}$/.test(code) && typeof detail === \"string\") {\n    return { code, detail };\n  }\n  return undefined;\n}\n\n/** Experimental. Posts one source for `resource` (a router prefix) and resolves with the preview. */\nexport function useExtract(\n  resource: string,\n): UseMutationResult<ExtractResult, unknown, ExtractInput> {\n  const client = useKarniClient();\n  const queryClient = useQueryClient();\n  return useMutation<ExtractResult, unknown, ExtractInput>({\n    mutationFn: (input) => {\n      if (\"file\" in input) {\n        const form = new FormData();\n        form.append(\"resource\", resource);\n        form.append(\"file\", input.file);\n        return client.request<ExtractResult>(EXTRACT_PATH, { method: \"POST\", body: form });\n      }\n      return client.request<ExtractResult>(EXTRACT_PATH, {\n        method: \"POST\",\n        body: { resource, ...input },\n      });\n    },\n    onSuccess: (result) => {\n      queryClient.setQueryData(importJobKey(resource, result.id), result.job);\n      // The caller's usage list (GET /api/ai/) has one more call.\n      void queryClient.invalidateQueries({ queryKey: karniKeys.resource(\"ai\") });\n    },\n  });\n}\n","/**\n * <ExtractButton>: read rows of a resource from a text, a web page or a PDF. Experimental.\n *\n * The button opens a dialog with one form per source. Extract posts it to\n * `POST /api/ai/extract/` (`useExtract`) and the dialog then shows the\n * import preview of the rows (`<ExtractPreview>`). Commit saves them through\n * the import's own commit, after the same confirmation a file import asks\n * for. Nothing is saved before.\n *\n * The backend decides everything that matters: who may extract into the\n * resource, which fields the model fills, what each row's problems are. A\n * refusal (an AI code: the source, the URL, the budget) is shown in the\n * backend's words.\n *\n * Escape hatches: every `@karni/ui` Button prop passes through to the\n * trigger. `sources` limits the forms. `slots` replaces the error display\n * and the preview's parts. `useExtract` and `<ExtractPreview>` build another\n * flow.\n */\nimport {\n  Button,\n  ErrorState,\n  Input,\n  Label,\n  Modal,\n  PendingButton,\n  Tabs,\n  TabsContent,\n  TabsList,\n  TabsTrigger,\n  Textarea,\n  type ButtonProps,\n  type ImportJob,\n} from \"@karni/ui\";\nimport * as React from \"react\";\nimport { ExtractPreview, type ExtractPreviewSlots } from \"./ExtractPreview\";\nimport { extractRefusal, useExtract } from \"./hooks\";\nimport type { ExtractInput, ExtractResult, ExtractSourceKind } from \"./types\";\n\n/** Experimental. What the `Error` slot receives: why the extraction was refused or failed. */\nexport interface ExtractErrorProps {\n  error: unknown;\n  resourceLabel: string;\n}\n\nexport interface ExtractButtonSlots extends ExtractPreviewSlots {\n  Error: React.ComponentType<ExtractErrorProps>;\n}\n\nexport interface ExtractButtonProps extends Omit<ButtonProps, \"onClick\" | \"onError\"> {\n  /** The resource's router prefix (\"products\"). */\n  resource: string;\n  /** The resource in words, plural (\"products\"). Default: the router prefix. */\n  resourceLabel?: string;\n  /** The forms offered, in order. Default: text, a web page, a PDF. */\n  sources?: readonly ExtractSourceKind[];\n  /** Called with the preview once the rows are read. */\n  onExtracted?: (result: ExtractResult) => void;\n  /** Called once the commit saved the rows. */\n  onDone?: (job: ImportJob) => void;\n  slots?: Partial<ExtractButtonSlots>;\n}\n\nconst SOURCE_LABELS: Record<ExtractSourceKind, string> = {\n  text: \"Text\",\n  url: \"Web page\",\n  pdf: \"PDF\",\n};\n\nconst SOURCE_WORDS: Record<ExtractSourceKind, string> = {\n  text: \"a text\",\n  url: \"a web page\",\n  pdf: \"a PDF\",\n};\n\n/** \"a text, a web page or a PDF\" for the sources offered. */\nfunction sourceWords(sources: readonly ExtractSourceKind[]): string {\n  const words = sources.map((source) => SOURCE_WORDS[source]);\n  if (words.length <= 1) return words[0] ?? \"a source\";\n  return `${words.slice(0, -1).join(\", \")} or ${words[words.length - 1]}`;\n}\n\nconst REFUSAL_TITLES: Record<string, string> = {\n  AI008: \"This resource can't be extracted into\",\n  AI009: \"You can't add these rows\",\n  AI010: \"This source can't be read\",\n  AI011: \"This address can't be fetched\",\n  AI012: \"This page can't be read\",\n  AI013: \"Your monthly budget is spent\",\n  AI014: \"The monthly budget is spent\",\n};\n\n/** The default `Error` slot: an AI refusal in the backend's words, anything else as ErrorState. */\nfunction DefaultExtractError({ error, resourceLabel }: ExtractErrorProps): React.ReactElement {\n  const refusal = extractRefusal(error);\n  if (refusal === undefined) {\n    return (\n      <ErrorState\n        variant=\"inline\"\n        error={error}\n        context={{ action: \"extract\", resource: resourceLabel }}\n      />\n    );\n  }\n  return (\n    <div\n      role=\"alert\"\n      className=\"rounded-md border border-destructive-border bg-destructive-subtle p-3 text-sm\"\n    >\n      <p className=\"font-medium text-foreground\">\n        {REFUSAL_TITLES[refusal.code] ?? \"The extraction failed\"}\n      </p>\n      <p className=\"text-muted-foreground\">{refusal.detail}</p>\n    </div>\n  );\n}\n\ninterface SourceFormProps {\n  sources: readonly ExtractSourceKind[];\n  pending: boolean;\n  onSubmit: (input: ExtractInput) => void;\n}\n\nfunction SourceForm({ sources, pending, onSubmit }: SourceFormProps): React.ReactElement {\n  const ids = {\n    text: React.useId(),\n    url: React.useId(),\n    pdf: React.useId(),\n  };\n  const [kind, setKind] = React.useState<ExtractSourceKind>(sources[0] ?? \"text\");\n  const [text, setText] = React.useState(\"\");\n  const [url, setUrl] = React.useState(\"\");\n  const [file, setFile] = React.useState<File | null>(null);\n\n  const submit = (event: React.FormEvent<HTMLFormElement>): void => {\n    event.preventDefault();\n    if (kind === \"text\") onSubmit({ text });\n    else if (kind === \"url\") onSubmit({ url });\n    else if (file !== null) onSubmit({ file });\n  };\n\n  const field = (source: ExtractSourceKind): React.ReactElement => {\n    if (source === \"text\") {\n      return (\n        <div className=\"grid gap-1.5\">\n          <Label htmlFor={ids.text}>Text to read</Label>\n          <Textarea\n            id={ids.text}\n            rows={8}\n            required\n            value={text}\n            onChange={(event) => setText(event.target.value)}\n          />\n        </div>\n      );\n    }\n    if (source === \"url\") {\n      return (\n        <div className=\"grid gap-1.5\">\n          <Label htmlFor={ids.url}>Address of the page</Label>\n          <Input\n            id={ids.url}\n            type=\"url\"\n            required\n            placeholder=\"https://\"\n            value={url}\n            onChange={(event) => setUrl(event.target.value)}\n          />\n        </div>\n      );\n    }\n    return (\n      <div className=\"grid gap-1.5\">\n        <Label htmlFor={ids.pdf}>PDF file</Label>\n        <Input\n          id={ids.pdf}\n          type=\"file\"\n          accept=\"application/pdf,.pdf\"\n          className=\"cursor-pointer\"\n          onChange={(event) => setFile(event.target.files?.[0] ?? null)}\n        />\n      </div>\n    );\n  };\n\n  return (\n    <form onSubmit={submit} className=\"space-y-3\" aria-label=\"Source to read\">\n      {sources.length > 1 ? (\n        <Tabs value={kind} onValueChange={(value) => setKind(value as ExtractSourceKind)}>\n          <TabsList>\n            {sources.map((source) => (\n              <TabsTrigger key={source} value={source}>\n                {SOURCE_LABELS[source]}\n              </TabsTrigger>\n            ))}\n          </TabsList>\n          {sources.map((source) => (\n            <TabsContent key={source} value={source}>\n              {field(source)}\n            </TabsContent>\n          ))}\n        </Tabs>\n      ) : (\n        field(kind)\n      )}\n      <PendingButton\n        type=\"submit\"\n        pending={pending}\n        pendingLabel=\"Reading…\"\n        disabled={kind === \"pdf\" && file === null}\n      >\n        Extract\n      </PendingButton>\n    </form>\n  );\n}\n\n/** Experimental. A button that reads rows from a source into the import preview. */\nexport function ExtractButton(props: ExtractButtonProps): React.ReactElement {\n  const {\n    resource,\n    resourceLabel,\n    sources = [\"text\", \"url\", \"pdf\"],\n    onExtracted,\n    onDone,\n    slots,\n    children,\n    ...buttonProps\n  } = props;\n  const label = resourceLabel ?? resource;\n  const ErrorSlot = slots?.Error ?? DefaultExtractError;\n  const [open, setOpen] = React.useState(false);\n  const [result, setResult] = React.useState<ExtractResult | undefined>(undefined);\n  const extract = useExtract(resource);\n\n  const startOver = (): void => {\n    setResult(undefined);\n    extract.reset();\n  };\n\n  return (\n    <Modal\n      open={open}\n      onOpenChange={(next) => {\n        setOpen(next);\n        if (!next) startOver();\n      }}\n      title={`Extract ${label}`}\n      description={`Read ${label} from ${sourceWords(sources)}. Nothing is saved until you commit the preview.`}\n      className=\"max-w-3xl\"\n      trigger={\n        <Button data-karni-role=\"extract-button\" {...buttonProps}>\n          {children ?? \"Extract with AI\"}\n        </Button>\n      }\n    >\n      {result === undefined ? (\n        <div className=\"space-y-3\">\n          <SourceForm\n            sources={sources}\n            pending={extract.isPending}\n            onSubmit={(input) =>\n              extract.mutate(input, {\n                onSuccess: (answer) => {\n                  setResult(answer);\n                  onExtracted?.(answer);\n                },\n              })\n            }\n          />\n          {extract.error !== null && extract.error !== undefined ? (\n            <ErrorSlot error={extract.error} resourceLabel={label} />\n          ) : null}\n        </div>\n      ) : (\n        <ExtractPreview\n          result={result}\n          resourceLabel={label}\n          onDone={onDone}\n          onStartOver={startOver}\n          slots={slots}\n        />\n      )}\n    </Modal>\n  );\n}\n","/** @karni/ai-ui public barrel: explicit exports only. Experimental. */\nimport { registerAiRoles } from \"./roles\";\n\nexport { ExtractButton } from \"./ExtractButton\";\nexport type { ExtractButtonProps, ExtractButtonSlots, ExtractErrorProps } from \"./ExtractButton\";\n\nexport { ExtractPreview, defaultExtractPreviewSlots, rowFields } from \"./ExtractPreview\";\nexport type {\n  ExtractPreviewProps,\n  ExtractPreviewSlots,\n  ExtractProblemsProps,\n  ExtractRowsProps,\n} from \"./ExtractPreview\";\n\nexport { EXTRACT_PATH, extractRefusal, useExtract } from \"./hooks\";\n\nexport type {\n  ExtractInput,\n  ExtractProblem,\n  ExtractRefusal,\n  ExtractResult,\n  ExtractSourceKind,\n  ExtractUsage,\n} from \"./types\";\n\nexport { AI_COMPONENT_ROLES, registerAiRoles } from \"./roles\";\nexport type { ComponentRoleDefinition } from \"./roles\";\n\nregisterAiRoles();\n"],"mappings":"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"}

package/dist/src/ExtractButton.d.ts

@@ -0,0 +1,27 @@
+import { ButtonProps, ImportJob } from '@karni/ui';
+import { ExtractPreviewSlots } from './ExtractPreview';
+import { ExtractResult, ExtractSourceKind } from './types';
+import * as React from "react";
+/** Experimental. What the `Error` slot receives: why the extraction was refused or failed. */
+export interface ExtractErrorProps {
+    error: unknown;
+    resourceLabel: string;
+}
+export interface ExtractButtonSlots extends ExtractPreviewSlots {
+    Error: React.ComponentType<ExtractErrorProps>;
+}
+export interface ExtractButtonProps extends Omit<ButtonProps, "onClick" | "onError"> {
+    /** The resource's router prefix ("products"). */
+    resource: string;
+    /** The resource in words, plural ("products"). Default: the router prefix. */
+    resourceLabel?: string;
+    /** The forms offered, in order. Default: text, a web page, a PDF. */
+    sources?: readonly ExtractSourceKind[];
+    /** Called with the preview once the rows are read. */
+    onExtracted?: (result: ExtractResult) => void;
+    /** Called once the commit saved the rows. */
+    onDone?: (job: ImportJob) => void;
+    slots?: Partial<ExtractButtonSlots>;
+}
+/** Experimental. A button that reads rows from a source into the import preview. */
+export declare function ExtractButton(props: ExtractButtonProps): React.ReactElement;

package/dist/src/ExtractPreview.d.ts

@@ -0,0 +1,38 @@
+import { ImportConfirmProps, ImportJob, ImportProgressProps, ImportSummaryProps } from '@karni/ui';
+import { ExtractProblem, ExtractResult } from './types';
+import * as React from "react";
+/** Experimental. What the `Rows` slot receives: the proposed rows and their fields. */
+export interface ExtractRowsProps {
+    rows: ReadonlyArray<Record<string, unknown>>;
+    fields: readonly string[];
+}
+/** Experimental. What the `Problems` slot receives: one problem per field, rows from 1. */
+export interface ExtractProblemsProps {
+    problems: readonly ExtractProblem[];
+}
+/** Experimental. The replaceable parts of ExtractPreview. */
+export interface ExtractPreviewSlots {
+    Rows: React.ComponentType<ExtractRowsProps>;
+    Problems: React.ComponentType<ExtractProblemsProps>;
+    Summary: React.ComponentType<ImportSummaryProps>;
+    ConfirmCommit: React.ComponentType<ImportConfirmProps>;
+    /** A preview or commit running in Celery (more rows than KARNI_IMPORT_INLINE_ROWS). */
+    Progress: React.ComponentType<ImportProgressProps>;
+}
+export interface ExtractPreviewProps {
+    /** The answer of `useExtract`. */
+    result: ExtractResult;
+    /** The resource in words, plural ("products"). Default: the router prefix. */
+    resourceLabel?: string;
+    /** Called once the commit saved the rows (the job is `done`). */
+    onDone?: (job: ImportJob) => void;
+    /** Shown as "Read another source" when given. */
+    onStartOver?: () => void;
+    slots?: Partial<ExtractPreviewSlots>;
+}
+/** Experimental. The fields the rows use, in the order they first appear. */
+export declare function rowFields(rows: ReadonlyArray<Record<string, unknown>>): string[];
+/** Experimental. Karni's own slots, exported so a project can wrap one instead of rewriting it. */
+export declare const defaultExtractPreviewSlots: ExtractPreviewSlots;
+/** Experimental. The preview of an extraction, with the import's own commit. */
+export declare function ExtractPreview({ result, resourceLabel, onDone, onStartOver, slots, }: ExtractPreviewProps): React.ReactElement;

package/dist/src/hooks.d.ts

@@ -0,0 +1,8 @@
+import { UseMutationResult } from '@tanstack/react-query';
+import { ExtractInput, ExtractRefusal, ExtractResult } from './types';
+/** Experimental. The extraction endpoint, relative to the client's base URL (it carries `/api`). */
+export declare const EXTRACT_PATH = "/ai/extract/";
+/** Experimental. The refusal an extraction answered with (`{code, detail}`), else undefined. */
+export declare function extractRefusal(error: unknown): ExtractRefusal | undefined;
+/** Experimental. Posts one source for `resource` (a router prefix) and resolves with the preview. */
+export declare function useExtract(resource: string): UseMutationResult<ExtractResult, unknown, ExtractInput>;

package/dist/src/index.d.ts

@@ -0,0 +1,8 @@
+export { ExtractButton } from './ExtractButton';
+export type { ExtractButtonProps, ExtractButtonSlots, ExtractErrorProps } from './ExtractButton';
+export { ExtractPreview, defaultExtractPreviewSlots, rowFields } from './ExtractPreview';
+export type { ExtractPreviewProps, ExtractPreviewSlots, ExtractProblemsProps, ExtractRowsProps, } from './ExtractPreview';
+export { EXTRACT_PATH, extractRefusal, useExtract } from './hooks';
+export type { ExtractInput, ExtractProblem, ExtractRefusal, ExtractResult, ExtractSourceKind, ExtractUsage, } from './types';
+export { AI_COMPONENT_ROLES, registerAiRoles } from './roles';
+export type { ComponentRoleDefinition } from './roles';

package/dist/src/roles.d.ts

@@ -0,0 +1,9 @@
+export interface ComponentRoleDefinition {
+    role: string;
+    component: string;
+    package: string;
+    description: string;
+}
+export declare const AI_COMPONENT_ROLES: readonly ComponentRoleDefinition[];
+/** Experimental. Registers the package's components in @karni/ui's role registry, if any. */
+export declare function registerAiRoles(registry?: unknown): boolean;

package/dist/src/types.d.ts

@@ -0,0 +1,55 @@
+import { ImportJob, ImportResult } from '@karni/ui';
+/** Experimental. Where the rows were read from. */
+export type ExtractSourceKind = "text" | "url" | "pdf";
+/** Experimental. What to read: exactly one of the three. */
+export type ExtractInput = {
+    text: string;
+} | {
+    url: string;
+} | {
+    file: File;
+};
+/**
+ * Experimental. One thing wrong with one proposed row. `row` is the row's position in `rows`, from 1.
+ * `source` is `schema` (the answer did not fit the field) or `preview` (the import refused it).
+ */
+export interface ExtractProblem {
+    row: number;
+    field: string;
+    message: string;
+    source: "schema" | "preview";
+}
+/** Experimental. The tokens and cost of the provider call (`cost` null: no price). */
+export interface ExtractUsage {
+    provider: string;
+    model: string;
+    input_tokens: number;
+    output_tokens: number;
+    cost: string | null;
+}
+/** Experimental. The answer of `POST /api/ai/extract/` (201). */
+export interface ExtractResult {
+    /** The import job's id: commit it to save the rows. */
+    id: string;
+    resource: string;
+    source: {
+        kind: ExtractSourceKind;
+        label: string;
+    };
+    status: ImportJob["status"];
+    /** The proposed rows, field to value, as the preview read them. */
+    rows: Array<Record<string, unknown>>;
+    problems: ExtractProblem[];
+    /** The preview's counts: what the commit will do. */
+    result: ImportResult | null;
+    /** The import's own commit path, relative to the site. */
+    commit: string;
+    /** The import job, as `GET /api/<resource>/import/<id>/` answers it. */
+    job: ImportJob;
+    usage: ExtractUsage;
+}
+/** Experimental. The body of a refused extraction: an AI code (AI008, AI010...) and why. */
+export interface ExtractRefusal {
+    code: string;
+    detail: string;
+}

package/package.json

@@ -1,6 +1,93 @@
 {
   "name": "@karni/ai-ui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.0",
+  "description": "React components for the Karni AI extraction module: ExtractButton and the useExtract hook. Karni is an open-source Django + React framework for building with AI coding agents. Your agent writes only your domain. The API, admin, permissions and React screens come from a package you upgrade, not code it rewrites in each project. One rule set covers every coding agent. The build fails when an agent hand-writes what Karni ships.",
+  "keywords": [
+    "react",
+    "django",
+    "ai",
+    "extraction",
+    "llm",
+    "import",
+    "karni"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cbsshekhawat18-lab/karni.git",
+    "directory": "modules/karni-ai/ui"
+  },
+  "homepage": "https://github.com/cbsshekhawat18-lab/karni/tree/main/modules/karni-ai/ui#readme",
+  "bugs": {
+    "url": "https://github.com/cbsshekhawat18-lab/karni/issues"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/src/index.d.ts",
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "tsc --noEmit && vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint . --ext .ts,.tsx,.cjs,.mjs",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
+  },
+  "peerDependencies": {
+    "@karni/ui": "^0.5.0",
+    "@tanstack/react-query": "^5.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@karni/ui": "file:../../../packages/karni-ui",
+    "@storybook/react": "^10.6.3",
+    "@tanstack/react-query": "^5.56.0",
+    "@testing-library/jest-dom": "^6.5.0",
+    "@testing-library/react": "^16.0.1",
+    "@testing-library/user-event": "^14.5.2",
+    "@types/node": "^24.0.0",
+    "@types/react": "^18.3.5",
+    "@types/react-dom": "^18.3.0",
+    "@typescript-eslint/eslint-plugin": "^8.71.2",
+    "@typescript-eslint/parser": "^8.71.2",
+    "@vitejs/plugin-react": "^6.1.2",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-react-hooks": "^4.6.2",
+    "jsdom": "^25.0.0",
+    "msw": "^2.4.4",
+    "prettier": "^3.3.3",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "storybook": "^10.6.3",
+    "typescript": "^5.6.2",
+    "vite": "^8.3.4",
+    "vite-plugin-dts": "^5.1.2",
+    "vitest": "^5.0.5"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "overrides": {
+    "minimatch@>=7.0.0 <11.0.1": "^11.0.5"
+  }
+}