@kahitsan/ksui 0.29.0 → 0.29.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kahitsan/ksui",
-  "version": "0.29.0",
+  "version": "0.29.1",
   "description": "ksui is a standalone set of SolidJS UI components for KahitSan/Hilinga and any SolidJS app. Published to the public npm registry and consumed as a normal dependency. Ships source under a `solid` export condition so the consumer's vite-plugin-solid compiles it with only solid-js externalized; it depends on nothing but solid-js + lucide-solid and injects its own CSS.",
   "type": "module",
   "main": "./src/index.ts",

package/src/index.ts

@@ -197,6 +197,11 @@ export { attachmentUrl, isResolvableAttachment } from "./utils/attachments";
 
 export { createObjectUrlResource } from "./utils/object-url-resource";
 export type { ObjectUrlOptions } from "./utils/object-url-resource";
+export {
+  createPendingFile,
+  revokePendingFile,
+} from "./utils/pending-file";
+export type { PendingFile } from "./utils/pending-file";
 
 export { useAccountsIndex, resolveAccount, resolveAccountName } from "./utils/accounts-index";
 

package/src/utils/pending-file.ts

@@ -0,0 +1,31 @@
+// Pre-upload pending file state — a file the user has picked or pasted but not
+// yet uploaded. The two plugins that support attachment upload (transactions,
+// timesheets/payroll) both defined this locally; extracted here so they share
+// one canonical type + helpers and avoid drift.
+
+/** A file the user picked or pasted but hasn't been uploaded yet. */
+export interface PendingFile {
+  id: string;
+  file: File;
+  previewUrl: string | null;
+}
+
+let _counter = 0;
+
+/** Wrap a picked/pasted File into a PendingFile with a stable id and optional
+ *  image preview URL. Must be called from the client (browser) — relies on
+ *  URL.createObjectURL. */
+export function createPendingFile(file: File): PendingFile {
+  const isImage = file.type.startsWith("image/");
+  return {
+    id: `pf-${++_counter}-${Date.now()}`,
+    file,
+    previewUrl: isImage ? URL.createObjectURL(file) : null,
+  };
+}
+
+/** Release the object URL held by a pending file. Call when the file is removed
+ *  from the list or after upload completes. */
+export function revokePendingFile(pf: PendingFile): void {
+  if (pf.previewUrl) URL.revokeObjectURL(pf.previewUrl);
+}