dr-widget 0.1.0__tar.gz

dr_widget-0.1.0/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.3
+Name: dr-widget
+Version: 0.1.0
+Summary: Add your description here
+Author: Danielle Rothermel
+Author-email: Danielle Rothermel <danielle.rothermel@gmail.com>
+Requires-Dist: anywidget>=0.9.18
+Requires-Dist: marimo>=0.17.6
+Requires-Dist: traitlets>=5.14.3
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# dr_widget
+
+dr_widget is a hybrid Python/Svelte project for building reusable AnyWidget components that can be dropped into Marimo notebooks today and exported to full Svelte apps later. The repository currently ships a file-drop configuration browser, but the layout is designed to host additional widgets.
+
+## Quick Start
+
+```bash
+# Install JS dependencies (root + workspace)
+bun install
+
+# Live-reload the file-drop widget in a browser
+bun run dev:file-drop
+
+# Produce the optimized bundle used by AnyWidget
+bun run build
+
+# Build the Python distributions (wheel + sdist)
+uv build
+
+# Launch the Marimo demo notebook
+marimo run notebooks/file_widget.py
+```
+
+Prerequisites: Bun ≥ 1.0, Node-compatible environment, Python ≥ 3.11 with `uv`, and Marimo ≥ 0.17.6.
+
+## Repository Layout
+
+- `src/dr_widget/` – Python package exposing AnyWidget classes.
+  - `widgets/file_drop/` – widget workspace (Svelte source in `src/`, build output in `static/`).
+    - `src/FileDropWidget.svelte` – orchestration layer wiring bindings into the panel components.
+    - `src/lib/hooks/use-file-bindings.ts` – shared logic for syncing AnyWidget traitlets.
+    - `src/lib/components/` – shadcn-style UI primitives and file-drop panels, including a config viewer card with both a tree view and graph view for JSON payloads.
+- `docs/` – additional reference material (architecture, development workflows).
+- `notebooks/file_widget.py` – Marimo notebook that exercises the file-drop widget.
+
+## Documentation
+
+- [Architecture Overview](docs/architecture.md) – how Python, AnyWidget, and Svelte fit together.
+- [Development Workflow](docs/development.md) – commands for widget builds, packaging, and notebooks.
+- [Repository Guidelines](AGENTS.md) – coding standards, contracts, and contribution checklist.
+
+## Contributing
+
+1. Work inside a dedicated branch.
+2. Run `bun run build`, `npx svelte-check`, and `uv build` before opening a PR.
+3. Update the notebook and docs when you add or change widget behaviour.
+4. Follow the commit and PR practices outlined in `AGENTS.md`.
+
+Please open an issue if you hit build problems or want to discuss new widgets.

dr_widget-0.1.0/README.md

@@ -0,0 +1,49 @@
+# dr_widget
+
+dr_widget is a hybrid Python/Svelte project for building reusable AnyWidget components that can be dropped into Marimo notebooks today and exported to full Svelte apps later. The repository currently ships a file-drop configuration browser, but the layout is designed to host additional widgets.
+
+## Quick Start
+
+```bash
+# Install JS dependencies (root + workspace)
+bun install
+
+# Live-reload the file-drop widget in a browser
+bun run dev:file-drop
+
+# Produce the optimized bundle used by AnyWidget
+bun run build
+
+# Build the Python distributions (wheel + sdist)
+uv build
+
+# Launch the Marimo demo notebook
+marimo run notebooks/file_widget.py
+```
+
+Prerequisites: Bun ≥ 1.0, Node-compatible environment, Python ≥ 3.11 with `uv`, and Marimo ≥ 0.17.6.
+
+## Repository Layout
+
+- `src/dr_widget/` – Python package exposing AnyWidget classes.
+  - `widgets/file_drop/` – widget workspace (Svelte source in `src/`, build output in `static/`).
+    - `src/FileDropWidget.svelte` – orchestration layer wiring bindings into the panel components.
+    - `src/lib/hooks/use-file-bindings.ts` – shared logic for syncing AnyWidget traitlets.
+    - `src/lib/components/` – shadcn-style UI primitives and file-drop panels, including a config viewer card with both a tree view and graph view for JSON payloads.
+- `docs/` – additional reference material (architecture, development workflows).
+- `notebooks/file_widget.py` – Marimo notebook that exercises the file-drop widget.
+
+## Documentation
+
+- [Architecture Overview](docs/architecture.md) – how Python, AnyWidget, and Svelte fit together.
+- [Development Workflow](docs/development.md) – commands for widget builds, packaging, and notebooks.
+- [Repository Guidelines](AGENTS.md) – coding standards, contracts, and contribution checklist.
+
+## Contributing
+
+1. Work inside a dedicated branch.
+2. Run `bun run build`, `npx svelte-check`, and `uv build` before opening a PR.
+3. Update the notebook and docs when you add or change widget behaviour.
+4. Follow the commit and PR practices outlined in `AGENTS.md`.
+
+Please open an issue if you hit build problems or want to discuss new widgets.

dr_widget-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "dr-widget"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+authors = [
+    { name = "Danielle Rothermel", email = "danielle.rothermel@gmail.com" }
+]
+requires-python = ">=3.11"
+dependencies = [
+    "anywidget>=0.9.18",
+    "marimo>=0.17.6",
+    "traitlets>=5.14.3",
+]
+
+[build-system]
+requires = ["uv_build>=0.9.7,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+source-include = ["src/dr_widget/widgets/file_drop/static/**"]
+source-exclude = [
+    "src/dr_widget/widgets/file_drop/node_modules",
+    "src/dr_widget/widgets/file_drop/node_modules/**",
+]

dr_widget-0.1.0/src/dr_widget/__init__.py

@@ -0,0 +1,5 @@
+"""Top-level package for dr_widget."""
+
+from .widgets.file_drop import FileDropWidget
+
+__all__ = ["FileDropWidget"]

dr_widget-0.1.0/src/dr_widget/widgets/__init__.py

@@ -0,0 +1,5 @@
+"""Widget exports for dr_widget."""
+
+from .file_drop import FileDropWidget
+
+__all__ = ["FileDropWidget"]

dr_widget-0.1.0/src/dr_widget/widgets/file_drop/.gitignore

@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

dr_widget-0.1.0/src/dr_widget/widgets/file_drop/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["svelte.svelte-vscode"]
+}

dr_widget-0.1.0/src/dr_widget/widgets/file_drop/README.md

@@ -0,0 +1,43 @@
+# Svelte + Vite
+
+This template should help get you started developing with Svelte in Vite.
+
+## Recommended IDE Setup
+
+[VS Code](https://code.visualstudio.com/) + [Svelte](https://marketplace.visualstudio.com/items?itemName=svelte.svelte-vscode).
+
+## Need an official Svelte framework?
+
+Check out [SvelteKit](https://github.com/sveltejs/kit#readme), which is also powered by Vite. Deploy anywhere with its serverless-first approach and adapt to various platforms, with out of the box support for TypeScript, SCSS, and Less, and easily-added support for mdsvex, GraphQL, PostCSS, Tailwind CSS, and more.
+
+## Technical considerations
+
+**Why use this over SvelteKit?**
+
+- It brings its own routing solution which might not be preferable for some users.
+- It is first and foremost a framework that just happens to use Vite under the hood, not a Vite app.
+
+This template contains as little as possible to get started with Vite + Svelte, while taking into account the developer experience with regards to HMR and intellisense. It demonstrates capabilities on par with the other `create-vite` templates and is a good starting point for beginners dipping their toes into a Vite + Svelte project.
+
+Should you later need the extended capabilities and extensibility provided by SvelteKit, the template has been structured similarly to SvelteKit so that it is easy to migrate.
+
+**Why include `.vscode/extensions.json`?**
+
+Other templates indirectly recommend extensions via the README, but this file allows VS Code to prompt the user to install the recommended extension upon opening the project.
+
+**Why enable `checkJs` in the JS template?**
+
+It is likely that most cases of changing variable types in runtime are likely to be accidental, rather than deliberate. This provides advanced typechecking out of the box. Should you like to take advantage of the dynamically-typed nature of JavaScript, it is trivial to change the configuration.
+
+**Why is HMR not preserving my local component state?**
+
+HMR state preservation comes with a number of gotchas! It has been disabled by default in both `svelte-hmr` and `@sveltejs/vite-plugin-svelte` due to its often surprising behavior. You can read the details [here](https://github.com/sveltejs/svelte-hmr/tree/master/packages/svelte-hmr#preservation-of-local-state).
+
+If you have state that's important to retain within a component, consider creating an external store which would not be replaced by HMR.
+
+```js
+// store.js
+// An extremely simple external store
+import { writable } from 'svelte/store'
+export default writable(0)
+```

dr_widget-0.1.0/src/dr_widget/widgets/file_drop/__init__.py

@@ -0,0 +1,26 @@
+"""AnyWidget bindings for the file drop widget."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import anywidget
+import traitlets
+
+__all__ = ["FileDropWidget"]
+
+_STATIC_DIR = Path(__file__).parent / "static"
+
+
+class FileDropWidget(anywidget.AnyWidget):
+    """File drop zone widget for notebooks."""
+
+    # AnyWidget expects module references pointing at the built assets on disk.
+    _esm = _STATIC_DIR / "index.js"
+    _css = _STATIC_DIR / "style.css"
+
+    files = traitlets.Unicode("[]").tag(sync=True)
+    file_count = traitlets.Int(0).tag(sync=True)
+    error = traitlets.Unicode("").tag(sync=True)
+    max_files = traitlets.Int(5, min=1).tag(sync=True)
+    selected_config = traitlets.Unicode("").tag(sync=True)

dr_widget-0.1.0/src/dr_widget/widgets/file_drop/components.json

@@ -0,0 +1,16 @@
+{
+	"$schema": "https://shadcn-svelte.com/schema.json",
+	"tailwind": {
+		"css": "src/app.css",
+		"baseColor": "slate"
+	},
+	"aliases": {
+		"components": "$lib/components",
+		"utils": "$lib/utils",
+		"ui": "$lib/components/ui",
+		"hooks": "$lib/hooks",
+		"lib": "$lib"
+	},
+	"typescript": true,
+	"registry": "https://shadcn-svelte.com/registry"
+}

dr_widget-0.1.0/src/dr_widget/widgets/file_drop/index.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>File Drop Widget - Dev Preview</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.js"></script>
+  </body>
+</html>

dr_widget-0.1.0/src/dr_widget/widgets/file_drop/jsrepo.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://unpkg.com/jsrepo@2.5.1/schemas/project-config.json",
+  "repos": ["@ieedan/shadcn-svelte-extras"],
+  "includeTests": false,
+  "includeDocs": false,
+  "watermark": true,
+  "formatter": "prettier",
+  "configFiles": {
+    "Shadcn Svelte Extras Cursor Rules": "./../../../../.cursor/rules/shadcn-svelte-extras.mdc"
+  },
+  "paths": {
+    "*": "./src/lib",
+    "ui": "./src/lib/components/ui",
+    "actions": "./src/lib/actions",
+    "hooks": "./src/lib/hooks",
+    "utils": "./src/lib/utils"
+  }
+}

dr_widget-0.1.0/src/dr_widget/widgets/file_drop/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@dr-widget/file_drop",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite dev",
+    "preview": "vite preview",
+    "check": "svelte-check --watch --tsconfig ./tsconfig.json"
+  },
+  "dependencies": {
+    "@anywidget/svelte": "^0.1.0",
+    "@zerodevx/svelte-json-view": "^1.0.11",
+    "elkjs": "^0.11.0",
+    "lucide-svelte": "^0.552.0",
+    "react": "18.2.0",
+    "react-dom": "18.2.0",
+    "react-zoom-pan-pinch": "^3.7.0",
+    "reaflow": "^5.4.1",
+    "svelte": "^5.43.2"
+  },
+  "devDependencies": {
+    "@internationalized/date": "^3.8.1",
+    "@lucide/svelte": "^0.544.0",
+    "@sveltejs/vite-plugin-svelte": "^4.0.0",
+    "@tailwindcss/postcss": "^4.0.9",
+    "@types/bun": "latest",
+    "@types/react": "18.2.74",
+    "@types/react-dom": "18.2.25",
+    "@vitejs/plugin-react-swc": "3.7.0",
+    "autoprefixer": "^10.4.20",
+    "bits-ui": "^2.11.0",
+    "clsx": "^2.1.1",
+    "postcss": "^8.4.49",
+    "prettier": "^3.6.2",
+    "runed": "^0.31.1",
+    "svelte-check": "^4.3.3",
+    "tailwind-merge": "^3.3.1",
+    "tailwind-variants": "^3.1.1",
+    "tailwindcss": "^4.1.16",
+    "tw-animate-css": "^1.4.0",
+    "vaul-svelte": "1.0.0-next.7",
+    "vite": "^5.4.11"
+  },
+  "peerDependencies": {
+    "typescript": "^5.9.3"
+  }
+}

dr_widget-0.1.0/src/dr_widget/widgets/file_drop/postcss.config.js

@@ -0,0 +1,6 @@
+import tailwindcss from '@tailwindcss/postcss';
+import autoprefixer from 'autoprefixer';
+
+export default {
+  plugins: [tailwindcss(), autoprefixer()]
+};

dr_widget-0.1.0/src/dr_widget/widgets/file_drop/public/vite.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

dr_widget-0.1.0/src/dr_widget/widgets/file_drop/src/App.svelte

@@ -0,0 +1,72 @@
+<script>
+  import { Separator } from "./lib/components/ui/separator/";
+  import FileDropWidget from "./FileDropWidget.svelte";
+
+  // Simulate anywidget bindings for testing
+  let bindings = $state({
+    files: "",
+    file_count: 0,
+    error: "",
+    max_files: 1,
+  });
+
+  // Watch for changes to display them
+  $effect(() => {
+    console.log("Files updated:", bindings.files);
+    console.log("File count:", bindings.file_count);
+    if (bindings.error) {
+      console.error("Error:", bindings.error);
+    }
+  });
+</script>
+
+<main class="mx-auto max-w-5xl p-8 font-sans">
+  <div class="flex flex-col gap-8">
+    <div class="space-y-2">
+      <h1 class="text-3xl font-semibold text-zinc-900 dark:text-zinc-100">
+        Widget
+      </h1>
+    </div>
+
+    <FileDropWidget {bindings} max_files={1} />
+
+    <div
+      class="mt-4 rounded-lg border border-zinc-200 bg-zinc-50 p-6 dark:border-zinc-700 dark:bg-zinc-900"
+    >
+      <h2 class="text-lg font-medium text-zinc-800 dark:text-zinc-100">
+        Debug Output
+      </h2>
+
+      <div
+        class="mt-4 rounded-md bg-white p-3 text-sm shadow-sm dark:bg-zinc-800"
+      >
+        <strong class="font-semibold text-zinc-700 dark:text-zinc-200"
+          >File Count:</strong
+        >
+        <span class="ml-2 text-zinc-600 dark:text-zinc-300"
+          >{bindings.file_count}</span
+        >
+      </div>
+
+      <div
+        class="mt-4 rounded-md bg-white p-3 text-sm shadow-sm dark:bg-zinc-800"
+      >
+        <strong class="font-semibold text-zinc-700 dark:text-zinc-200"
+          >Files Data:</strong
+        >
+        <pre
+          class="mt-2 overflow-x-auto rounded-md bg-zinc-900/10 p-2 font-mono text-xs dark:bg-zinc-50/10">
+{bindings.files || "(empty)"}</pre>
+      </div>
+
+      {#if bindings.error}
+        <div
+          class="mt-4 rounded-md border border-red-200 bg-red-50 p-3 text-sm text-red-600 dark:border-red-500/40 dark:bg-red-950/40 dark:text-red-300"
+        >
+          <strong class="font-semibold">Error:</strong>
+          <span class="ml-2">{bindings.error}</span>
+        </div>
+      {/if}
+    </div>
+  </div>
+</main>