@octane-xplat/files 0.10.0 → 0.11.1

package/dist/native/FileInput.js

@@ -0,0 +1,434 @@
+import { files } from "./files.js";
+import { cx, formatFileSize, normalizePicked, validateFiles } from "./file-input-utils.js";
+import { defineUniversalComponent, hookSlots, universalChildren, universalComponent, universalPlan, universalProps, universalValue, useId, useImperativeHandle, useRef, useState, withSlot } from "@nativescript-community/octane";
+import { Field, Icon, Pressable, useFieldControl } from "@octane-xplat/ui";
+//#region src/FileInput.tsrx
+var _hs$ = /* @__PURE__ */ hookSlots(8);
+var _h$0 = /* @__PURE__ */ Symbol(_hs$);
+var _h$1 = /* @__PURE__ */ Symbol(_hs$ + 1);
+var _h$2 = /* @__PURE__ */ Symbol(_hs$ + 2);
+var _h$3 = /* @__PURE__ */ Symbol(_hs$ + 3);
+var _h$4 = /* @__PURE__ */ Symbol(_hs$ + 4);
+var _h$5 = /* @__PURE__ */ Symbol(_hs$ + 5);
+var _h$6 = /* @__PURE__ */ Symbol(_hs$ + 6);
+var _h$7 = /* @__PURE__ */ Symbol(_hs$ + 7);
+var __octaneUniversalPlan0 = universalPlan("nativescript", {
+	"kind": "host",
+	"type": "label",
+	"props": { "className": "vx-fileinput-itemsize" },
+	"bindings": [["text", 0]]
+});
+var __octaneUniversalPlan1 = universalPlan("nativescript", {
+	"kind": "host",
+	"type": "label",
+	"props": { "text": "×" }
+});
+var __octaneUniversalPlan2 = universalPlan("nativescript", {
+	"kind": "slot",
+	"slot": 0
+});
+var __octaneUniversalPlan3 = universalPlan("nativescript", {
+	"kind": "host",
+	"type": "flexboxlayout",
+	"propsSlot": 0,
+	"children": [
+		{
+			"kind": "slot",
+			"slot": 1
+		},
+		{
+			"kind": "host",
+			"type": "label",
+			"props": { "className": "vx-fileinput-itemname" },
+			"bindings": [["text", 2]]
+		},
+		{
+			"kind": "slot",
+			"slot": 3
+		},
+		{
+			"kind": "slot",
+			"slot": 4
+		}
+	]
+});
+var __octaneUniversalPlan4 = universalPlan("nativescript", {
+	"kind": "host",
+	"type": "flexboxlayout",
+	"props": {
+		"flexDirection": "column",
+		"className": "vx-fileinput-list"
+	},
+	"children": [{
+		"kind": "slot",
+		"slot": 0
+	}]
+});
+var __octaneUniversalPlan5 = universalPlan("nativescript", {
+	"kind": "host",
+	"type": "flexboxlayout",
+	"props": {
+		"flexDirection": "row",
+		"alignItems": "center"
+	},
+	"children": [{
+		"kind": "slot",
+		"slot": 0
+	}, {
+		"kind": "host",
+		"type": "label",
+		"bindings": [["text", 1]]
+	}]
+});
+var __octaneUniversalPlan6 = universalPlan("nativescript", {
+	"kind": "host",
+	"type": "label",
+	"props": { "text": "×" }
+});
+var __octaneUniversalPlan7 = universalPlan("nativescript", {
+	"kind": "slot",
+	"slot": 0
+});
+var __octaneUniversalPlan8 = universalPlan("nativescript", {
+	"kind": "host",
+	"type": "label",
+	"bindings": [
+		["className", 0],
+		["text", 1],
+		["accessibilityLabel", 2]
+	]
+});
+var __octaneUniversalPlan9 = universalPlan("nativescript", {
+	"kind": "host",
+	"type": "label",
+	"bindings": [["className", 0], ["text", 1]]
+});
+var __octaneUniversalPlan10 = universalPlan("nativescript", {
+	"kind": "host",
+	"type": "flexboxlayout",
+	"props": { "flexDirection": "column" },
+	"bindings": [["className", 0], ["style", 1]],
+	"children": [
+		{
+			"kind": "slot",
+			"slot": 2
+		},
+		{
+			"kind": "slot",
+			"slot": 3
+		},
+		{
+			"kind": "slot",
+			"slot": 4
+		},
+		{
+			"kind": "slot",
+			"slot": 5
+		},
+		{
+			"kind": "slot",
+			"slot": 6
+		}
+	]
+});
+var __octaneUniversalPlan11 = universalPlan("nativescript", {
+	"kind": "slot",
+	"slot": 0
+});
+var __octaneUniversalPlan12 = universalPlan("nativescript", {
+	"kind": "slot",
+	"slot": 0
+});
+var __octaneUniversalPlan13 = universalPlan("nativescript", {
+	"kind": "range",
+	"children": [{
+		"kind": "slot",
+		"slot": 0
+	}]
+});
+var STATUS_TEXT = {
+	error: "⚠",
+	warning: "⚠",
+	success: "✓"
+};
+var FileInputControl = defineUniversalComponent("nativescript", function FileInputControl(inputProps) {
+	const hostRef = useRef(null, _h$0);
+	const { props } = withSlot(_h$1, useFieldControl, inputProps);
+	const generatedId = useId(_h$2);
+	const inputId = props.id ?? generatedId;
+	const [busy, setBusy] = useState(false, _h$3);
+	const [validationErrors, setValidationErrors] = useState([], _h$4);
+	const files$1 = props.value == null ? [] : Array.isArray(props.value) ? props.value : [props.value];
+	const isDisabled = !!props.isDisabled || !!props.isReadOnly;
+	const isBusy = !!props.isLoading || busy;
+	const statusType = validationErrors.length ? "error" : props.status?.type;
+	const statusMessage = validationErrors.length ? validationErrors.join(" ") : props.status?.message;
+	const emitValue = (next) => props.isMultiple ? next : next[0] ?? null;
+	const fireChange = (next) => {
+		const emitted = emitValue(next);
+		props.onChange?.(emitted);
+		if (props.changeAction) {
+			setBusy(true);
+			Promise.resolve(props.changeAction(emitted)).finally(() => setBusy(false));
+		}
+	};
+	const acceptRefs = (picked) => {
+		if (isDisabled || isBusy || !picked.length) return;
+		const merged = props.isMultiple ? [...files$1, ...picked] : picked;
+		const { valid, errors } = validateFiles(merged, {
+			accept: props.accept,
+			maxSize: props.maxSize,
+			maxFiles: props.maxFiles
+		});
+		setValidationErrors(errors);
+		const next = !props.isMultiple && errors.length ? files$1 : valid;
+		if (next.length !== files$1.length || next.some((file, index) => file.uri !== files$1[index]?.uri)) fireChange(next);
+	};
+	const removeAt = (index) => {
+		if (isDisabled || isBusy) return;
+		setValidationErrors([]);
+		fireChange(files$1.filter((_, i) => i !== index));
+	};
+	const pick = () => {
+		if (isDisabled || isBusy) return;
+		const options = {
+			accept: props.accept,
+			multiple: props.isMultiple
+		};
+		const picked = props.pick ? props.pick(options) : props.isMultiple ? files.pickMultiple(props.accept) : files.pick(props.accept);
+		Promise.resolve(picked).then((result) => acceptRefs(normalizePicked(result))).catch((error) => setValidationErrors([String(error?.message ?? error)]));
+	};
+	const dropzone = props.mode === "dropzone";
+	const statusText = statusType ? STATUS_TEXT[statusType] : null;
+	useImperativeHandle(props.ref, () => ({
+		open: pick,
+		native: hostRef.current
+	}), void 0, _h$5);
+	return universalValue(__octaneUniversalPlan10, [
+		cx("vx-fileinput", dropzone && "vx-fileinput--dropzone", isDisabled && "vx-fileinput--disabled", isBusy && "vx-fileinput--loading", statusType && `vx-fileinput--status-${statusType}`, props.size && `vx-fileinput--size-${props.size}`, props.className),
+		props.style,
+		files$1.length ? universalValue(__octaneUniversalPlan4, [files$1.map((f, i) => universalValue(__octaneUniversalPlan3, [
+			universalProps([
+				[
+					"set",
+					"key",
+					`${f.uri}-${i}`
+				],
+				[
+					"set",
+					"flexDirection",
+					"row"
+				],
+				[
+					"set",
+					"alignItems",
+					"center"
+				],
+				[
+					"set",
+					"className",
+					"vx-fileinput-item"
+				]
+			]),
+			universalComponent("nativescript", Icon, universalProps([[
+				"set",
+				"name",
+				"xplat-upload"
+			], [
+				"set",
+				"size",
+				14
+			]])),
+			f.name,
+			f.size != null ? universalValue(__octaneUniversalPlan0, [formatFileSize(f.size)]) : null,
+			!isDisabled && !isBusy ? universalValue(__octaneUniversalPlan2, [universalComponent("nativescript", Pressable, universalProps([
+				[
+					"set",
+					"className",
+					"vx-fileinput-itemremove"
+				],
+				[
+					"set",
+					"accessibilityLabel",
+					`Remove ${f.name}`
+				],
+				[
+					"set",
+					"onPress",
+					() => removeAt(i)
+				]
+			], universalChildren("nativescript", () => {
+				return universalValue(__octaneUniversalPlan1, []);
+			})))]) : null
+		]))]) : null,
+		universalComponent("nativescript", Pressable, universalProps([
+			[
+				"set",
+				"ref",
+				(v) => {
+					hostRef.current = v;
+				}
+			],
+			[
+				"set",
+				"id",
+				inputId
+			],
+			[
+				"set",
+				"className",
+				"vx-fileinput-trigger"
+			],
+			[
+				"set",
+				"disabled",
+				isDisabled || isBusy
+			],
+			[
+				"set",
+				"accessibilityLabel",
+				props.accessibilityLabel ?? props.ariaLabel ?? props.fieldLabel ?? props.label
+			],
+			[
+				"set",
+				"accessibilityHint",
+				props.accessibilityHint
+			],
+			[
+				"set",
+				"accessibilityState",
+				{
+					disabled: isDisabled,
+					busy: isBusy
+				}
+			],
+			[
+				"set",
+				"onPress",
+				pick
+			]
+		], universalChildren("nativescript", () => {
+			return universalValue(__octaneUniversalPlan5, [universalComponent("nativescript", Icon, universalProps([[
+				"set",
+				"name",
+				"xplat-upload"
+			], [
+				"set",
+				"size",
+				14
+			]])), files$1.length ? "Choose more files" : "Choose files"]);
+		}))),
+		files$1.length > 0 && !isDisabled && !isBusy ? universalValue(__octaneUniversalPlan7, [universalComponent("nativescript", Pressable, universalProps([
+			[
+				"set",
+				"className",
+				"vx-fileinput-clear"
+			],
+			[
+				"set",
+				"accessibilityLabel",
+				`Clear ${props.fieldLabel ?? props.label ?? "files"}`
+			],
+			[
+				"set",
+				"onPress",
+				() => {
+					setValidationErrors([]);
+					fireChange([]);
+				}
+			]
+		], universalChildren("nativescript", () => {
+			return universalValue(__octaneUniversalPlan6, []);
+		})))]) : null,
+		statusText != null ? universalValue(__octaneUniversalPlan8, [
+			cx("vx-field-icon", `vx-field-icon--${statusType}`),
+			statusText,
+			props.statusVariant === "tooltip" ? statusMessage : void 0
+		]) : null,
+		statusMessage && props.statusVariant !== "tooltip" ? universalValue(__octaneUniversalPlan9, [cx("vx-field-status", `vx-field-status--${statusType}`), statusMessage]) : null
+	]);
+}, { "module": "@nativescript-community/octane" });
+var FileInput = defineUniversalComponent("nativescript", function FileInput(props) {
+	const { inField } = withSlot(_h$6, useFieldControl, props);
+	const cid = useId(_h$7);
+	const control = universalValue(__octaneUniversalPlan11, [universalComponent("nativescript", FileInputControl, universalProps([["spread", props]]))]);
+	return universalValue(__octaneUniversalPlan13, [inField ? control : universalValue(__octaneUniversalPlan12, [universalComponent("nativescript", Field, universalProps([
+		[
+			"set",
+			"inputID",
+			props.id ?? cid
+		],
+		[
+			"set",
+			"label",
+			props.label
+		],
+		[
+			"set",
+			"isLabelHidden",
+			props.isLabelHidden
+		],
+		[
+			"set",
+			"description",
+			props.description
+		],
+		[
+			"set",
+			"isDisabled",
+			props.isDisabled
+		],
+		[
+			"set",
+			"disabledMessage",
+			props.disabledMessage
+		],
+		[
+			"set",
+			"isReadOnly",
+			props.isReadOnly
+		],
+		[
+			"set",
+			"isLoading",
+			props.isLoading
+		],
+		[
+			"set",
+			"isRequired",
+			props.isRequired
+		],
+		[
+			"set",
+			"isOptional",
+			props.isOptional
+		],
+		[
+			"set",
+			"size",
+			props.size
+		],
+		[
+			"set",
+			"status",
+			props.status
+		],
+		[
+			"set",
+			"statusVariant",
+			props.statusVariant
+		],
+		[
+			"set",
+			"labelTooltip",
+			props.labelTooltip
+		],
+		[
+			"set",
+			"width",
+			props.width
+		]
+	], control))])]);
+}, { "module": "@nativescript-community/octane" });
+//#endregion
+export { FileInput };

package/dist/native/file-bytes.js

@@ -0,0 +1,45 @@
+//#region src/file-bytes.ts
+/**
+* Shared helpers for the binary file primitives (readBytes/writeBytes/export).
+* DOM-free so the native leaf can use it too.
+*/
+/** File names used for sandbox writes and export temp files must be bare
+*  names, not paths — a `/`, `\`, or `..` segment escapes the sandbox. */
+function assertSafeFileName(name) {
+	if (typeof name !== "string" || name.length === 0 || name === "." || name === ".." || name.includes("/") || name.includes("\\") || name.includes("\0")) throw new Error(`Unsafe file name: ${JSON.stringify(name)}`);
+}
+function fileTooLarge(name, maxBytes) {
+	return /* @__PURE__ */ new Error(`${name}: file exceeds the ${maxBytes}-byte limit`);
+}
+/** Named rejection for a second `files.export` while one is in flight. */
+function exportBusy() {
+	const error = /* @__PURE__ */ new Error("files.export: an export is already in progress");
+	error.name = "ExportBusyError";
+	return error;
+}
+function throwIfAborted(signal) {
+	if (!signal?.aborted) return;
+	const thrower = signal.throwIfAborted;
+	if (typeof thrower === "function") thrower.call(signal);
+	const error = /* @__PURE__ */ new Error("The operation was aborted");
+	error.name = "AbortError";
+	throw error;
+}
+/** Concatenate Uint8Array chunks into one exact-length array. */
+function concatBytes(chunks, total) {
+	const out = new Uint8Array(total);
+	let offset = 0;
+	for (const chunk of chunks) {
+		out.set(chunk, offset);
+		offset += chunk.byteLength;
+	}
+	return out;
+}
+/** Return an ArrayBuffer covering exactly this view's byte range — native
+*  marshallers treat the argument as the whole buffer. */
+function exactBuffer(bytes) {
+	if (bytes.byteOffset === 0 && bytes.byteLength === bytes.buffer.byteLength) return bytes.buffer;
+	return bytes.slice().buffer;
+}
+//#endregion
+export { assertSafeFileName, concatBytes, exactBuffer, exportBusy, fileTooLarge, throwIfAborted };

package/dist/native/file-input-utils.js

@@ -0,0 +1,52 @@
+//#region src/file-input-utils.ts
+function cx(...values) {
+	return values.filter(Boolean).join(" ");
+}
+function normalizePicked(result) {
+	if (result == null) return [];
+	return Array.isArray(result) ? result : [result];
+}
+function fileAccepts(file, accept) {
+	if (!accept) return true;
+	const tokens = accept.split(",").map((t) => t.trim().toLowerCase()).filter(Boolean);
+	if (!tokens.length) return true;
+	const name = file.name.toLowerCase();
+	const mime = (file.mimeType ?? "").toLowerCase();
+	return tokens.some((token) => {
+		if (token === "*/*") return true;
+		if (token.startsWith(".")) return name.endsWith(token);
+		if (token.endsWith("/*")) return mime.startsWith(token.slice(0, -1));
+		return mime === token;
+	});
+}
+function formatFileSize(bytes) {
+	if (bytes < 1024) return `${bytes} B`;
+	if (bytes < 1048576) return `${(bytes / 1024).toFixed(1)} KB`;
+	if (bytes < 1073741824) return `${(bytes / 1048576).toFixed(1)} MB`;
+	return `${(bytes / 1073741824).toFixed(1)} GB`;
+}
+function validateFiles(files, opts) {
+	const errors = [];
+	const valid = [];
+	for (const file of files) {
+		if (!fileAccepts(file, opts.accept)) {
+			errors.push(`${file.name}: file type not accepted`);
+			continue;
+		}
+		if (opts.maxSize != null && file.size != null && file.size > opts.maxSize) {
+			errors.push(`${file.name}: file exceeds ${formatFileSize(opts.maxSize)}`);
+			continue;
+		}
+		valid.push(file);
+	}
+	if (opts.maxFiles != null && valid.length > opts.maxFiles) {
+		const extra = valid.splice(opts.maxFiles);
+		for (const file of extra) errors.push(`${file.name}: exceeds the ${opts.maxFiles}-file limit`);
+	}
+	return {
+		valid,
+		errors
+	};
+}
+//#endregion
+export { cx, fileAccepts, formatFileSize, normalizePicked, validateFiles };