@databricks/appkit-ui 0.0.2

package/CLAUDE.md

@@ -0,0 +1,3 @@
+# CLAUDE.md - @databricks/appkit-ui
+
+## TBD

package/DCO

@@ -0,0 +1,25 @@
+Developer's Certificate of Origin 1.1
+
+By making a contribution to this project, I certify that:
+
+(a) The contribution was created in whole or in part by me and I
+    have the right to submit it under the open source license
+    indicated in the file; or
+
+(b) The contribution is based upon previous work that, to the best
+    of my knowledge, is covered under an appropriate open source
+    license and I have the right under that license to submit that
+    work with modifications, whether created in whole or in part
+    by me, under the same open source license (unless I am
+    permitted to submit under a different license), as indicated
+    in the file; or
+
+(c) The contribution was provided directly to me by some other
+    person who certified (a), (b) or (c) and I have not modified
+    it.
+
+(d) I understand and agree that this project and the contribution
+    are public and that a record of the contribution (including all
+    personal information I submit with it, including my sign-off) is
+    maintained indefinitely and may be redistributed consistent with
+    this project or the open source license(s) involved.

package/LICENSE

@@ -0,0 +1,203 @@
+Copyright 2022 Databricks, Inc. All rights reserved.
+
+                                 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/NOTICE.md

@@ -0,0 +1,73 @@
+Copyright (2022) Databricks, Inc.
+
+This Software includes software developed at Databricks (https://www.databricks.com/) and its use is subject to the included LICENSE file.
+***
+This Software contains code from the following open source projects:
+
+| Name             | Installed version | License | Code                                                 |
+| :--------------- | :---------------- | :----------- | :--------------------------------------------------- |
+| [@hookform/resolvers](https://www.npmjs.com/package/@hookform/resolvers) | 5.2.2 | MIT | https://react-hook-form.com |
+| [@opentelemetry/api](https://www.npmjs.com/package/@opentelemetry/api) | 1.9.0 | Apache-2.0 | https://github.com/open-telemetry/opentelemetry-js/tree/main/api |
+| [@opentelemetry/api-logs](https://www.npmjs.com/package/@opentelemetry/api-logs) | 0.208.0 | Apache-2.0 | https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/packages/api-logs |
+| [@opentelemetry/auto-instrumentations-node](https://www.npmjs.com/package/@opentelemetry/auto-instrumentations-node) | 0.67.2 | Apache-2.0 | https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/packages/auto-instrumentations-node#readme |
+| [@opentelemetry/exporter-logs-otlp-proto](https://www.npmjs.com/package/@opentelemetry/exporter-logs-otlp-proto) | 0.208.0 | Apache-2.0 | https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/packages/exporter-logs-otlp-proto |
+| [@opentelemetry/exporter-metrics-otlp-proto](https://www.npmjs.com/package/@opentelemetry/exporter-metrics-otlp-proto) | 0.208.0 | Apache-2.0 | https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/packages/opentelemetry-exporter-metrics-otlp-proto |
+| [@opentelemetry/exporter-trace-otlp-proto](https://www.npmjs.com/package/@opentelemetry/exporter-trace-otlp-proto) | 0.208.0 | Apache-2.0 | https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/packages/exporter-trace-otlp-proto |
+| [@opentelemetry/instrumentation](https://www.npmjs.com/package/@opentelemetry/instrumentation) | 0.208.0 | Apache-2.0 | https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/packages/opentelemetry-instrumentation |
+| [@opentelemetry/instrumentation-express](https://www.npmjs.com/package/@opentelemetry/instrumentation-express) | 0.57.0 | Apache-2.0 | https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/packages/instrumentation-express#readme |
+| [@opentelemetry/instrumentation-http](https://www.npmjs.com/package/@opentelemetry/instrumentation-http) | 0.208.0 | Apache-2.0 | https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/packages/opentelemetry-instrumentation-http |
+| [@opentelemetry/resources](https://www.npmjs.com/package/@opentelemetry/resources) | 2.2.0 | Apache-2.0 | https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-resources |
+| [@opentelemetry/sdk-logs](https://www.npmjs.com/package/@opentelemetry/sdk-logs) | 0.208.0 | Apache-2.0 | https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/packages/sdk-logs |
+| [@opentelemetry/sdk-metrics](https://www.npmjs.com/package/@opentelemetry/sdk-metrics) | 2.2.0 | Apache-2.0 | https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/sdk-metrics |
+| [@opentelemetry/sdk-node](https://www.npmjs.com/package/@opentelemetry/sdk-node) | 0.208.0 | Apache-2.0 | https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/packages/opentelemetry-sdk-node |
+| [@opentelemetry/semantic-conventions](https://www.npmjs.com/package/@opentelemetry/semantic-conventions) | 1.38.0 | Apache-2.0 | https://github.com/open-telemetry/opentelemetry-js/tree/main/semantic-conventions |
+| [@radix-ui/react-accordion](https://www.npmjs.com/package/@radix-ui/react-accordion) | 1.2.12 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-alert-dialog](https://www.npmjs.com/package/@radix-ui/react-alert-dialog) | 1.1.15 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-aspect-ratio](https://www.npmjs.com/package/@radix-ui/react-aspect-ratio) | 1.1.8 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-avatar](https://www.npmjs.com/package/@radix-ui/react-avatar) | 1.1.11 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-checkbox](https://www.npmjs.com/package/@radix-ui/react-checkbox) | 1.3.3 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-collapsible](https://www.npmjs.com/package/@radix-ui/react-collapsible) | 1.1.12 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-context-menu](https://www.npmjs.com/package/@radix-ui/react-context-menu) | 2.2.16 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-dialog](https://www.npmjs.com/package/@radix-ui/react-dialog) | 1.1.15 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-dropdown-menu](https://www.npmjs.com/package/@radix-ui/react-dropdown-menu) | 2.1.16 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-hover-card](https://www.npmjs.com/package/@radix-ui/react-hover-card) | 1.1.15 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-label](https://www.npmjs.com/package/@radix-ui/react-label) | 2.1.8 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-menubar](https://www.npmjs.com/package/@radix-ui/react-menubar) | 1.1.16 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-navigation-menu](https://www.npmjs.com/package/@radix-ui/react-navigation-menu) | 1.2.14 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-popover](https://www.npmjs.com/package/@radix-ui/react-popover) | 1.1.15 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-progress](https://www.npmjs.com/package/@radix-ui/react-progress) | 1.1.8 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-radio-group](https://www.npmjs.com/package/@radix-ui/react-radio-group) | 1.3.8 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-scroll-area](https://www.npmjs.com/package/@radix-ui/react-scroll-area) | 1.2.10 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-select](https://www.npmjs.com/package/@radix-ui/react-select) | 2.2.6 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-separator](https://www.npmjs.com/package/@radix-ui/react-separator) | 1.1.8 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-slider](https://www.npmjs.com/package/@radix-ui/react-slider) | 1.3.6 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-slot](https://www.npmjs.com/package/@radix-ui/react-slot) | 1.2.3, 1.2.4 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-switch](https://www.npmjs.com/package/@radix-ui/react-switch) | 1.2.6 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-tabs](https://www.npmjs.com/package/@radix-ui/react-tabs) | 1.1.13 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-toggle](https://www.npmjs.com/package/@radix-ui/react-toggle) | 1.1.10 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-toggle-group](https://www.npmjs.com/package/@radix-ui/react-toggle-group) | 1.1.11 | MIT | https://radix-ui.com/primitives |
+| [@radix-ui/react-tooltip](https://www.npmjs.com/package/@radix-ui/react-tooltip) | 1.2.8 | MIT | https://radix-ui.com/primitives |
+| [@tanstack/react-table](https://www.npmjs.com/package/@tanstack/react-table) | 8.21.3 | MIT | https://tanstack.com/table |
+| [@tanstack/react-virtual](https://www.npmjs.com/package/@tanstack/react-virtual) | 3.13.12 | MIT | https://tanstack.com/virtual |
+| [class-variance-authority](https://www.npmjs.com/package/class-variance-authority) | 0.7.1 | Apache-2.0 | https://github.com/joe-bell/cva#readme |
+| [clsx](https://www.npmjs.com/package/clsx) | 2.1.1 | MIT | https://github.com/lukeed/clsx#readme |
+| [cmdk](https://www.npmjs.com/package/cmdk) | 1.1.1 | MIT | https://github.com/pacocoursey/cmdk#readme |
+| [date-fns](https://www.npmjs.com/package/date-fns) | 4.1.0 | MIT | https://github.com/date-fns/date-fns#readme |
+| [dotenv](https://www.npmjs.com/package/dotenv) | 16.6.1 | BSD-2-Clause | https://github.com/motdotla/dotenv#readme |
+| [embla-carousel-react](https://www.npmjs.com/package/embla-carousel-react) | 8.6.0 | MIT | https://www.embla-carousel.com |
+| [express](https://www.npmjs.com/package/express) | 4.22.0 | MIT | http://expressjs.com/ |
+| [fast-glob](https://www.npmjs.com/package/fast-glob) | 3.3.3 | MIT | https://github.com/mrmlnc/fast-glob#readme |
+| [input-otp](https://www.npmjs.com/package/input-otp) | 1.4.2 | MIT | https://input-otp.rodz.dev/ |
+| [lucide-react](https://www.npmjs.com/package/lucide-react) | 0.554.0 | ISC | https://lucide.dev |
+| [next-themes](https://www.npmjs.com/package/next-themes) | 0.4.6 | MIT | https://github.com/pacocoursey/next-themes#readme |
+| [pg](https://www.npmjs.com/package/pg) | 8.16.3 | MIT | https://github.com/brianc/node-postgres |
+| [react-day-picker](https://www.npmjs.com/package/react-day-picker) | 9.12.0 | MIT | https://daypicker.dev |
+| [react-hook-form](https://www.npmjs.com/package/react-hook-form) | 7.68.0 | MIT | https://react-hook-form.com |
+| [react-resizable-panels](https://www.npmjs.com/package/react-resizable-panels) | 3.0.6 | MIT | https://github.com/bvaughn/react-resizable-panels#readme |
+| [sonner](https://www.npmjs.com/package/sonner) | 2.0.7 | MIT | https://sonner.emilkowal.ski/ |
+| [tailwind-merge](https://www.npmjs.com/package/tailwind-merge) | 3.4.0 | MIT | https://github.com/dcastil/tailwind-merge |
+| [vaul](https://www.npmjs.com/package/vaul) | 1.1.2 | MIT | https://vaul.emilkowal.ski/ |
+| [ws](https://www.npmjs.com/package/ws) | 8.18.3 | MIT | https://github.com/websockets/ws |
+| [zod](https://www.npmjs.com/package/zod) | 4.1.13 | MIT | https://zod.dev |
+| [zod-to-ts](https://www.npmjs.com/package/zod-to-ts) | 2.0.0 | MIT | https://github.com/sachinraja/zod-to-ts#readme |
+

package/README.md

@@ -0,0 +1,35 @@
+# AppKit
+
+> [!WARNING]
+> ## ⚠️ PREVIEW - NOT FOR PRODUCTION USE
+>
+> **This SDK is in preview and is subject to change without notice.**
+>
+> - ❌ **Do NOT use in production environments**
+> - ⚠️ **Breaking changes may occur at any time**
+> - 🔬 **APIs are experimental and unstable**
+> - 📝 **Use for development and testing only**
+>
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and contribution guidelines.
+
+## Documentation
+
+The `docs/` directory contains the AppKit documentation site, built with Docusaurus.
+
+**Working with docs:**
+
+```bash
+# From root
+pnpm docs:dev    # Start dev server
+pnpm docs:build  # Build docs
+pnpm docs:serve  # Serve built docs
+```
+
+See [docs/README.md](./docs/README.md) for more details.
+
+👉 For AI/code assistants:  
+- Use [llms-compact.txt](./llms-compact.txt) for quick usage patterns.  
+- See [llms.txt](./llms.txt) for full guidance and anti-patterns.

package/bin/setup-claude.js

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+
+/**
+ * CLI tool to setup CLAUDE.md for Databricks AppKit packages.
+ *
+ * This bin is included in both @databricks/appkit and @databricks/appkit-ui
+ * so it's available regardless of which package the user installs.
+ *
+ * Usage:
+ *   npx appkit-setup          # Show detected packages and content
+ *   npx appkit-setup --write  # Create or update CLAUDE.md file
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+
+const PACKAGES = [
+  { name: "@databricks/appkit", description: "Backend SDK" },
+  {
+    name: "@databricks/appkit-ui",
+    description: "UI Integration, Charts, Tables, SSE, and more.",
+  },
+];
+
+const SECTION_START = "<!-- appkit-instructions-start -->";
+const SECTION_END = "<!-- appkit-instructions-end -->";
+
+/**
+ * Find which AppKit packages are installed by checking for CLAUDE.md
+ */
+function findInstalledPackages() {
+  const cwd = process.cwd();
+  const installed = [];
+
+  for (const pkg of PACKAGES) {
+    const claudePath = path.join(cwd, "node_modules", pkg.name, "CLAUDE.md");
+    if (fs.existsSync(claudePath)) {
+      installed.push(pkg);
+    }
+  }
+
+  return installed;
+}
+
+/**
+ * Generate the AppKit section content
+ */
+function generateSection(packages) {
+  const links = packages
+    .map((pkg) => {
+      const docPath = `./node_modules/${pkg.name}/CLAUDE.md`;
+      return `- **${pkg.name}** (${pkg.description}): [${docPath}](${docPath})`;
+    })
+    .join("\n");
+
+  return `${SECTION_START}
+## Databricks AppKit
+
+This project uses Databricks AppKit packages. For AI assistant guidance on using these packages, refer to:
+
+${links}
+${SECTION_END}`;
+}
+
+/**
+ * Generate standalone CLAUDE.md content (when no existing file)
+ */
+function generateStandalone(packages) {
+  const links = packages
+    .map((pkg) => {
+      const docPath = `./node_modules/${pkg.name}/CLAUDE.md`;
+      return `- **${pkg.name}** (${pkg.description}): [${docPath}](${docPath})`;
+    })
+    .join("\n");
+
+  return `# AI Assistant Instructions
+
+${SECTION_START}
+## Databricks AppKit
+
+This project uses Databricks AppKit packages. For AI assistant guidance on using these packages, refer to:
+
+${links}
+${SECTION_END}
+`;
+}
+
+/**
+ * Update existing content with AppKit section
+ */
+function updateContent(existingContent, packages) {
+  const newSection = generateSection(packages);
+
+  // Check if AppKit section already exists
+  const startIndex = existingContent.indexOf(SECTION_START);
+  const endIndex = existingContent.indexOf(SECTION_END);
+
+  if (startIndex !== -1 && endIndex !== -1) {
+    // Replace existing section
+    const before = existingContent.substring(0, startIndex);
+    const after = existingContent.substring(endIndex + SECTION_END.length);
+    return before + newSection + after;
+  }
+
+  // Append section to end
+  return `${existingContent.trimEnd()}\n\n${newSection}\n`;
+}
+
+/**
+ * Main CLI logic
+ */
+function main() {
+  const args = process.argv.slice(2);
+  const shouldWrite = args.includes("--write") || args.includes("-w");
+  const help = args.includes("--help") || args.includes("-h");
+
+  if (help) {
+    console.log(`
+Usage: npx appkit-setup [options]
+
+Options:
+  --write, -w   Create or update CLAUDE.md file in current directory
+  --help, -h    Show this help message
+
+Examples:
+  npx appkit-setup              # Show detected packages and preview content
+  npx appkit-setup --write      # Create or update CLAUDE.md
+`);
+    return;
+  }
+
+  // Find installed packages
+  const installed = findInstalledPackages();
+
+  if (installed.length === 0) {
+    console.log("No @databricks/appkit packages found in node_modules.");
+    console.log("\nMake sure you've installed at least one of:");
+    PACKAGES.forEach((pkg) => {
+      console.log(`  - ${pkg.name}`);
+    });
+    process.exit(1);
+  }
+
+  console.log("Detected packages:");
+  installed.forEach((pkg) => {
+    console.log(`  ✓ ${pkg.name}`);
+  });
+
+  const claudePath = path.join(process.cwd(), "CLAUDE.md");
+  const existingContent = fs.existsSync(claudePath)
+    ? fs.readFileSync(claudePath, "utf-8")
+    : null;
+
+  let finalContent;
+  let action;
+
+  if (existingContent) {
+    finalContent = updateContent(existingContent, installed);
+    action = existingContent.includes(SECTION_START) ? "Updated" : "Added to";
+  } else {
+    finalContent = generateStandalone(installed);
+    action = "Created";
+  }
+
+  if (shouldWrite) {
+    fs.writeFileSync(claudePath, finalContent);
+    console.log(`\n✓ ${action} CLAUDE.md`);
+    console.log(`  Path: ${claudePath}`);
+  } else {
+    console.log("\nTo create/update CLAUDE.md, run:");
+    console.log("  npx appkit-setup --write\n");
+
+    if (existingContent) {
+      console.log(
+        `This will ${
+          existingContent.includes(SECTION_START)
+            ? "update the existing"
+            : "add a new"
+        } AppKit section.\n`,
+      );
+    }
+
+    console.log("Preview of AppKit section:\n");
+    console.log("─".repeat(50));
+    console.log(generateSection(installed));
+    console.log("─".repeat(50));
+  }
+}
+
+main();

package/dist/js/arrow/arrow-client.d.ts

@@ -0,0 +1,64 @@
+import { DATE_FIELD_PATTERNS, NAME_FIELD_PATTERNS } from "../constants.js";
+import { Field, Table as Table$1 } from "apache-arrow";
+
+//#region src/js/arrow/arrow-client.d.ts
+declare class ArrowClient {
+  /**
+   * Processes an Arrow IPC buffer into a Table.
+   * Lazily loads the Apache Arrow library on first use.
+   *
+   * @param buffer - The Arrow IPC format buffer
+   * @returns Promise resolving to an Arrow Table
+   */
+  static processArrowBuffer(buffer: Uint8Array): Promise<Table$1>;
+  static fetchAndProcessArrow(url: string, headers?: Record<string, string>): Promise<Table$1>;
+  static extractArrowFields(table: Table$1): {
+    name: string;
+    type: any;
+  }[];
+  static extractArrowColumns(table: Table$1): Record<string, any>;
+  /**
+   * Extracts chart data from Arrow table.
+   * Uses get(i) to properly handle complex types like Decimal128.
+   * Applies decimal scaling for DECIMAL types.
+   *
+   * Note: This method assumes Arrow has been loaded (via processArrowBuffer).
+   *
+   * @returns xData for axis, yDataMap for series data
+   */
+  static extractChartData(table: Table$1, xKey: string, yKeys: string[]): {
+    xData: (string | number)[];
+    yDataMap: Record<string, (string | number)[]>;
+  };
+  /**
+   * Automatically detect which fields to use for chart axes from an Arrow table
+   * Uses the schema's type information for accurate field detection
+   *
+   * Note: This method assumes Arrow has been loaded (via processArrowBuffer).
+   *
+   * @param table - Arrow Table to analyze
+   * @param orientation - Chart orientation ("vertical" for time-series, "horizontal" for categorical)
+   * @returns Object containing the detected fields
+   * @example
+   * // Time-series data
+   * detectFieldsFromArrow(timeSeriesTable)
+   * // { xField: "date", yFields: ["revenue", "cost"], chartType: "timeseries" }
+   *
+   * // Categorical data
+   * detectFieldsFromArrow(categoricalTable)
+   * // { xField: "app_name", yFields: ["totalSpend"], chartType: "categorical" }
+   */
+  static detectFieldsFromArrow(table: Table$1, orientation?: "vertical" | "horizontal"): DetectedFields & {
+    chartType: "timeseries" | "categorical";
+  };
+  static fetchArrow(url: string, headers?: Record<string, string>): Promise<Uint8Array>;
+}
+interface DetectedFields {
+  /** X field */
+  xField: string;
+  /** Y fields */
+  yFields: string[];
+}
+//#endregion
+export { ArrowClient, DetectedFields, type Field, type Table$1 as Table };
+//# sourceMappingURL=arrow-client.d.ts.map

package/dist/js/arrow/arrow-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrow-client.d.ts","names":[],"sources":["../../../src/js/arrow/arrow-client.ts"],"sourcesContent":[],"mappings":";;;;AAmBa,cAAA,WAAA,CAAW;EAAA;;;;;;;SAwCW,kBAAA,CAAA,MAAA,EAhCO,UAgCP,CAAA,EAhCoB,OAgCpB,CAhC4B,OAgC5B,CAAA;SASC,oBAAA,CAAA,GAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAxBtB,MAwBsB,CAAA,MAAA,EAAA,MAAA,CAAA,CAAA,EAvB/B,OAuB+B,CAvBvB,OAuBuB,CAAA;SAAQ,kBAAA,CAAA,KAAA,EATT,OASS,CAAA,EAAA;IAuBX,IAAA,EAAA,MAAA;IA6MrB,IAAA,EAAA,GAAA;KAtJD;SAEN,mBAAA,CAAA,KAAA,EAhF+B,OAgF/B,CAAA,EAhFuC,MAgFvC,CAAA,MAAA,EAAA,GAAA,CAAA;;;;;AAsIL;;;;;iCA/LiC;;cA6MrB;;;;;;;;;;;;;;;;;;;;sCAtJD,mDAEN;;;2CA8GS,yBACT,QAAQ;;UAuBI,cAAA"}