@crossbind/extension-page-files 0.0.0-stage → 2.0.0-beta.69

package/LICENSE

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

package/README.md

@@ -1,3 +1,19 @@
-# Temporary Holding Version
+# @crossbind/extension-page-files
 
-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.
+The system's picker for a page's file input, on macOS and Android.
+
+An app has it by having `@crossbind/core-app-host`, which lists it as a dependency: there is nothing to install or list.
+
+## What it does
+
+A page's file input opens the system's picker, with the types and the multiple choice the input asks for.
+
+## Platforms
+
+macOS and Android; the other webviews show their own picker.
+
+## Replace or leave out
+
+It holds the role `page-files`. An extension that gives `replaces: 'page-files'` takes it; `app: { without: ['page-files'] }` in `crossbind.config.js` leaves it out. [The guide](https://crossbind.dev/guide/extensions/#replace) shows how, and [extensions.md](https://github.com/crossbind/crossbind/blob/main/docs/api/extensions.md#the-hosts-own-extensions) what a replacement answers.
+
+[extensions.md](https://github.com/crossbind/crossbind/blob/main/docs/api/extensions.md#the-pages-requests) has the hooks a replacement answers.

package/crossbind.extension.js

@@ -0,0 +1,11 @@
+export default function pageFiles() {
+    return {
+        name: 'page-files',
+        contract: 1,
+        root: import.meta.dirname,
+        app: {
+            macos: { sources: ['native/darwin.mm'] },
+            android: { java: 'native/android', class: 'dev.crossbind.extension.pagefiles.PageFilesExtension' },
+        },
+    };
+}

package/native/android/dev/crossbind/extension/pagefiles/PageFilesExtension.java

@@ -0,0 +1,47 @@
+package dev.crossbind.extension.pagefiles;
+
+import android.app.Activity;
+import android.content.ActivityNotFoundException;
+import android.content.ClipData;
+import android.content.Intent;
+import android.net.Uri;
+import android.util.Log;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.json.JSONObject;
+
+import dev.crossbind.app.Extension;
+import dev.crossbind.app.ExtensionHost;
+
+// The host's page-files on Android: a file input opens the system's picker for its accept types, with several files
+// where the input takes them.
+public final class PageFilesExtension implements Extension {
+    @Override
+    public void call(ExtensionHost host, String function, JSONObject options, Call call) {
+        call.reject("crossbind: page-files has no function " + function);
+    }
+
+    @Override
+    public void onFileInput(ExtensionHost host, FileInput input) {
+        Intent intent = input.params().createIntent();
+        if (input.allowsMultiple()) intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true);
+        try {
+            host.startForResult(intent, (result, data) -> input.pick(picked(result, data)));
+        } catch (ActivityNotFoundException none) {
+            Log.w("crossbind", "nothing on this device picks a file");
+            input.useDefault();
+        }
+    }
+
+    // What the picker chose, several files as clip data.
+    private static Uri[] picked(int result, Intent data) {
+        if (result != Activity.RESULT_OK || data == null) return null;
+        List<Uri> picked = new ArrayList<>();
+        ClipData clip = data.getClipData();
+        if (clip == null) picked.add(data.getData());
+        else for (int i = 0; i < clip.getItemCount(); i += 1) picked.add(clip.getItemAt(i).getUri());
+        return picked.toArray(new Uri[0]);
+    }
+}

package/native/darwin.mm

@@ -0,0 +1,33 @@
+#import <Cocoa/Cocoa.h>
+
+#include "crossbind/extension.h"
+
+#include <string>
+#include <vector>
+
+// The host's page-files on macOS: a file input's picker, as a sheet on the page's window, which takes folders where the
+// input does. WKWebView tells none of the input's accept types.
+void crossbind_extension_page_files(crossbind::Registry &registry) {
+    registry.onFileInput([](crossbind::FileInput input) {
+        NSOpenPanel *panel = [NSOpenPanel openPanel];
+        panel.canChooseFiles = YES;
+        panel.canChooseDirectories = input.allowsFolders();
+        panel.allowsMultipleSelection = input.allowsMultiple();
+        void (^done)(NSModalResponse) = ^(NSModalResponse response) {
+            if (response != NSModalResponseOK) {
+                input.cancel();
+                return;
+            }
+            std::vector<std::string> paths;
+            for (NSURL *url in panel.URLs) paths.emplace_back(url.path.UTF8String ?: "");
+            input.pick(paths);
+        };
+        const std::optional<crossbind::Window> open = crossbind::windowOf(input.page().windowId());
+        NSWindow *window = (__bridge NSWindow *)(open ? open->native() : crossbind::appWindow());
+        if (window) {
+            [panel beginSheetModalForWindow:window completionHandler:done];
+        } else {
+            done([panel runModal]);
+        }
+    });
+}

package/package.json

@@ -1,6 +1,29 @@
 {
   "name": "@crossbind/extension-page-files",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "2.0.0-beta.69",
+  "description": "crossbind app extension: the system's picker for a page's file input, on macOS and Android.",
+  "homepage": "https://github.com/crossbind/crossbind/tree/main/extensions/page-files#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/crossbind/crossbind.git"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    "./crossbind.extension.js": "./crossbind.extension.js"
+  },
+  "files": [
+    "crossbind.extension.js",
+    "native"
+  ],
+  "crossbind": {
+    "extension": "./crossbind.extension.js"
+  },
+  "keywords": [
+    "crossbind-extension",
+    "crossbind",
+    "page",
+    "files",
+    "app"
+  ]
 }