@struktur/app 2.6.0

package/AGENTS.md

@@ -0,0 +1,117 @@
+# Struktur Desktop App
+
+Native desktop application for Struktur using Electrobun.
+
+## Architecture
+
+- **Main Process**: Bun runtime at `src/bun/index.ts`
+- **Webview**: Production placeholder at `src/main/`
+- **Dev Mode**: Loads from `@struktur/web` dev server with transparent title bar
+
+## Features
+
+### Draggable Header
+The header is marked as a draggable region using the `electrobun-webkit-app-region-drag` CSS class. This allows users to drag the window by grabbing the header area. Interactive elements (buttons, links) inside the header use `electrobun-webkit-app-region-no-drag` to remain clickable.
+
+### Transparent Title Bar
+The desktop app uses a transparent title bar (`hiddenInset` style on macOS) that blends with the web UI. The native window control buttons (close/minimize/maximize) appear in the top-left corner.
+
+### Window Control Layout
+The layout is specifically arranged to accommodate the window control buttons:
+- **Header**: Reduced left padding (`pl-4`), normal right padding (`pr-6`)
+- **Logo wrapper**: Has top padding (`pt-3`) in desktop mode, positioned below the window buttons
+- **Logo**: Reduced left padding (`pl-3`)
+- **Navbar height**: Fixed at `h-16` (64px) with content centered vertically
+- **No left indent**: Logo sits directly under the window control buttons
+- **Links section**: No border-left (avoiding duplicate borders), reduced left margin
+
+## Development Workflow
+
+```bash
+# Start both web dev server and desktop app (recommended)
+bun run dev
+
+# This will:
+# 1. Start @struktur/web dev server on port 3030
+# 2. Wait 3 seconds for server to be ready
+# 3. Launch Electrobun desktop app
+# 4. Desktop app loads from http://localhost:3030?desktop=true
+# 5. Web UI adjusts layout to accommodate window controls
+```
+
+## Scripts
+
+- `bun run dev` - Run web + desktop together with hot reload
+- `bun run dev:app` - Desktop app only (requires web server running)
+- `bun run dev:web` - Web server only
+- `bun run build` - Build production app
+- `bun run package` - Package for distribution
+
+## Desktop Mode CSS Classes
+
+### Draggable Regions
+- `electrobun-webkit-app-region-drag` - Makes element a draggable window region
+- `electrobun-webkit-app-region-no-drag` - Excludes element from drag behavior (for buttons/links)
+
+Applied in the web app:
+- **Header**: Has drag class to allow window dragging
+- **Logo, Docs link, GitHub link**: Have no-drag class to remain clickable
+- **Right-side actions** (API keys, buttons): Have no-drag class
+
+## Project Structure
+
+```
+packages/app/
+├── electrobun.config.ts    # Build configuration with icon
+├── package.json            # Scripts and dependencies
+├── assets/
+│   └── icon.iconset/       # macOS app icons (all sizes)
+├── src/
+│   ├── bun/
+│   │   └── index.ts        # Main process entry
+│   └── main/               # Production webview assets
+│       ├── index.html      # HTML shell
+│       └── index.ts        # Placeholder
+└── build/                  # Build output (generated)
+```
+
+## Configuration
+
+### Window Setup with Draggable Title Bar
+
+```typescript
+const win = new BrowserWindow({
+  title: "Struktur",
+  url: isDev ? "http://localhost:3030?desktop=true" : "views://main/index.html",
+  titleBarStyle: "hiddenInset",  // Transparent title bar
+  frame: { x: 0, y: 0, width: 1400, height: 900 },
+});
+```
+
+### Desktop Mode Detection in Web UI
+
+```typescript
+const isDesktop = new URLSearchParams(window.location.search).get("desktop") === "true";
+```
+
+When in desktop mode:
+- **Logo wrapper** gets `pt-3` (12px) top padding
+- **Navbar** has fixed height `h-16` with centered content
+- **Header** is marked draggable with `electrobun-webkit-app-region-drag`
+- **Interactive elements** marked with `electrobun-webkit-app-region-no-drag`
+
+## Platform Support
+
+| Platform | Status | Notes |
+|----------|--------|-------|
+| macOS 14+ | ✅ Supported | Draggable header, transparent title bar, native window controls |
+| Windows 11+ | ⚠️ Basic | Uses WebView2, may need custom window controls |
+| Linux | ⚠️ Basic | Uses WebKitGTK, may need custom window controls |
+
+## TODO
+
+For full production integration:
+- [ ] Bundle `@struktur/web` static assets into production build
+- [ ] Implement custom window controls for Windows/Linux (since they don't have native overlay)
+- [ ] Add native menu bar integration
+- [ ] Set up CI for automated builds with proper code signing

package/LICENSE

@@ -0,0 +1,110 @@
+# Functional Source License, Version 1.1, MIT Future License
+
+## Abbreviation
+
+FSL-1.1-MIT
+
+## Notice
+
+Copyright 2026 mateffy
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT license that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT license, in which case the following will apply:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,127 @@
+# @struktur/app
+
+Struktur Desktop Application - A native desktop app for structured data extraction.
+
+## Overview
+
+This package packages `@struktur/web` as a native desktop application using Electrobun, which provides:
+
+- **Ultra-small bundle size**: ~12MB
+- **Native performance**: Uses Bun runtime and system webviews
+- **Cross-platform**: macOS 14+, Windows 11+, Linux
+- **Transparent title bar**: Seamlessly blends with the web UI
+- **Desktop mode**: Web UI adapts to provide space for window controls
+
+## Quick Start
+
+### Development (Web + Desktop together)
+
+```bash
+cd packages/app
+bun install
+bun run dev
+```
+
+This will:
+1. Start the `@struktur/web` dev server on port 3030
+2. Launch the Electrobun desktop app
+3. Load the web UI from `http://localhost:3030?desktop=true` with full hot reload
+4. The web UI automatically detects desktop mode and adds padding for window controls
+
+### Desktop Mode Features
+
+When running in the desktop app:
+- **Transparent title bar**: The native title bar is hidden, creating a seamless look
+- **Window control space**: The web UI header adds `pt-10` padding to accommodate macOS window buttons (close/minimize/maximize)
+- **Native feel**: The app feels like a native macOS app with proper window controls
+
+## Scripts
+
+| Command | Description |
+|---------|-------------|
+| `bun run dev` | Start web server + desktop app together |
+| `bun run dev:app` | Desktop app only |
+| `bun run dev:web` | Web server only |
+| `bun run build` | Build production app |
+| `bun run build:release` | Build optimized release |
+| `bun run package` | Package for distribution |
+
+## App Icon
+
+The app uses `resources/struktur-icon.png` from the root, converted to a macOS iconset at `assets/icon.iconset/`.
+
+## Project Structure
+
+```
+packages/app/
+├── electrobun.config.ts    # Build configuration with icon
+├── package.json            # Scripts and dependencies
+├── assets/
+│   └── icon.iconset/       # macOS app icons
+│       ├── icon_16x16.png
+│       ├── icon_32x32.png
+│       └── ... (all sizes)
+├── src/
+│   ├── bun/
+│   │   └── index.ts        # Main process entry (transparent title bar)
+│   └── main/               # Production webview assets
+│       ├── index.html      # HTML shell
+│       └── index.ts        # Placeholder
+└── build/                  # Build output (generated)
+```
+
+## Configuration
+
+### Window Setup
+
+```typescript
+const win = new BrowserWindow({
+  title: "Struktur",
+  url: isDev ? "http://localhost:3030?desktop=true" : "views://main/index.html",
+  titleBarStyle: "hiddenInset",  // Transparent title bar on macOS
+  frame: { x: 0, y: 0, width: 1400, height: 900 },
+});
+```
+
+### Desktop Mode Detection
+
+The web app detects desktop mode via query parameter:
+
+```typescript
+const isDesktop = new URLSearchParams(window.location.search).get("desktop") === "true";
+```
+
+When in desktop mode, the header automatically adjusts:
+
+```typescript
+<header className={`... ${isDesktop ? 'pt-10' : 'py-0'}`}>
+```
+
+## Platform Support
+
+| Platform | Status | Notes |
+|----------|--------|-------|
+| macOS 14+ | ✅ Supported | Transparent title bar, native window controls |
+| Windows 11+ | ✅ Supported | Uses WebView2 |
+| Linux | ✅ Supported | Uses WebKitGTK |
+
+## Troubleshooting
+
+### Icon not showing
+
+Make sure the iconset is properly created:
+```bash
+cd resources
+sips -z 512 512 struktur-icon.png --out ../packages/app/assets/icon.iconset/icon_512x512.png
+# ... create all sizes
+```
+
+### Dev server not found
+
+If the desktop app shows a blank window:
+1. Check that `@struktur/web` is running: `bun run --filter @struktur/web dev`
+2. Verify port 3030 is available
+
+## License
+
+FSL-1.1-MIT

package/build/dev-macos-arm64/Struktur-dev.app/Contents/Info.plist

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>CFBundleExecutable</key>
+    <string>launcher</string>
+    <key>CFBundleIdentifier</key>
+    <string>com.struktur.app</string>
+    <key>CFBundleName</key>
+    <string>Struktur-dev</string>
+    <key>CFBundleVersion</key>
+    <string>1.0.0</string>
+    <key>CFBundlePackageType</key>
+    <string>APPL</string>
+    <key>CFBundleIconFile</key>
+    <string>AppIcon</string>
+</dict>
+</plist>