@basmilius/utils 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Bas Milius
+
+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,3 @@
+# Utils
+
+Various utilities that are commonly used throughout personal Vue-related projects.

package/dist/defineStore.d.ts

@@ -0,0 +1,5 @@
+export default function <Id extends string, Setup extends (...args: any[]) => any, Context = ReturnType<Setup>>(id: Id, setup: Setup): UseStore<Context>;
+type UseStore<R> = {
+    (): R;
+};
+export {};

package/dist/downloadBlob.d.ts

@@ -0,0 +1 @@
+export default function (blob: Blob, filename: string): void;

package/dist/downloadString.d.ts

@@ -0,0 +1 @@
+export default function (data: string, filename: string, type: string): void;

package/dist/downloadUrl.d.ts

@@ -0,0 +1 @@
+export default function (url: string, filename: string): void;

package/dist/formatDate.d.ts

@@ -0,0 +1,2 @@
+import type { DateTime } from 'luxon';
+export default function (dateTime: DateTime): string;

package/dist/formatDateFull.d.ts

@@ -0,0 +1,2 @@
+import type { DateTime } from 'luxon';
+export default function (dateTime: DateTime): string;

package/dist/formatDateTime.d.ts

@@ -0,0 +1,2 @@
+import type { DateTime } from 'luxon';
+export default function (dateTime: DateTime): string;

package/dist/formatMonth.d.ts

@@ -0,0 +1,2 @@
+import type { DateTime } from 'luxon';
+export default function (dateTime: DateTime): string;

package/dist/formatTime.d.ts

@@ -0,0 +1,2 @@
+import type { DateTime } from 'luxon';
+export default function (dateTime: DateTime): string;

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { default as defineStore } from './defineStore';
+export { default as downloadBlob } from './downloadBlob';
+export { default as downloadString } from './downloadString';
+export { default as downloadUrl } from './downloadUrl';
+export { default as formatDate } from './formatDate';
+export { default as formatDateFull } from './formatDateFull';
+export { default as formatDateTime } from './formatDateTime';
+export { default as formatMonth } from './formatMonth';
+export { default as formatTime } from './formatTime';
+export { default as isPointInPolygon } from './isPointInPolygon';
+export { default as isToday } from './isToday';
+export { default as openUrl } from './openUrl';
+export { default as waitFor } from './waitFor';
+export declare const MDASH = "\u2014";
+export declare const NDASH = "\u2013";
+export declare const NOOP: () => any;

package/dist/isPointInPolygon.d.ts

@@ -0,0 +1,3 @@
+type Point = [number, number];
+export default function (point: Point, polygon: Point[]): boolean;
+export {};

package/dist/isToday.d.ts

@@ -0,0 +1,2 @@
+import { DateTime } from 'luxon';
+export default function (dateTime: DateTime): boolean;

package/dist/openUrl.d.ts

@@ -0,0 +1 @@
+export default function (url: string): void;

package/dist/utils.js

@@ -0,0 +1,148 @@
+// src/defineStore.ts
+import { defineStore, storeToRefs } from "pinia";
+function defineStore_default(id, setup) {
+  const storeFn = defineStore(id, setup);
+  return () => {
+    const store = storeFn();
+    const keys = Object.getOwnPropertyNames(store);
+    const refs = storeToRefs(store);
+    const result = {};
+    for (const key of keys) {
+      if (key.startsWith("$") || key.startsWith("_")) {
+        continue;
+      }
+      if (key in refs) {
+        result[key] = refs[key];
+        continue;
+      }
+      result[key] = store[key];
+    }
+    return result;
+  };
+}
+
+// src/downloadUrl.ts
+function downloadUrl_default(url, filename) {
+  const anchor = document.createElement("a");
+  anchor.download = filename;
+  anchor.href = url;
+  document.body.appendChild(anchor);
+  anchor.click();
+  document.body.removeChild(anchor);
+}
+
+// src/downloadBlob.ts
+function downloadBlob_default(blob, filename) {
+  const url = URL.createObjectURL(blob);
+  downloadUrl_default(url, filename);
+  URL.revokeObjectURL(url);
+}
+
+// src/downloadString.ts
+function downloadString_default(data, filename, type) {
+  const blob = new Blob([data], { type });
+  downloadBlob_default(blob, filename);
+}
+
+// src/formatDate.ts
+function formatDate_default(dateTime) {
+  return dateTime.toLocaleString({
+    year: "numeric",
+    month: "long",
+    day: "numeric"
+  });
+}
+
+// src/formatDateFull.ts
+function formatDateFull_default(dateTime) {
+  return dateTime.toLocaleString({
+    weekday: "long",
+    day: "numeric",
+    month: "long"
+  });
+}
+
+// src/formatDateTime.ts
+function formatDateTime_default(dateTime) {
+  return dateTime.toLocaleString({
+    year: "numeric",
+    month: "long",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+}
+
+// src/formatMonth.ts
+function formatMonth_default(dateTime) {
+  return dateTime.toLocaleString({
+    month: "long"
+  });
+}
+
+// src/formatTime.ts
+function formatTime_default(dateTime) {
+  return dateTime.toLocaleString({
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+}
+
+// src/isPointInPolygon.ts
+function isPointInPolygon_default(point, polygon) {
+  let inside = false;
+  for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {
+    const xi = polygon[i][0], yi = polygon[i][1];
+    const xj = polygon[j][0], yj = polygon[j][1];
+    const intersect = yi > point[1] != yj > point[1] && point[0] < (xj - xi) * (point[1] - yi) / (yj - yi) + xi;
+    if (intersect) {
+      inside = !inside;
+    }
+  }
+  return inside;
+}
+
+// src/isToday.ts
+import { DateTime } from "luxon";
+function isToday_default(dateTime) {
+  const today = DateTime.now();
+  return today.hasSame(dateTime, "day");
+}
+
+// src/openUrl.ts
+function openUrl_default(url) {
+  if (window.location !== window.parent.location) {
+    window.open(url, "_top");
+  } else {
+    window.location.href = url;
+  }
+}
+
+// src/waitFor.ts
+async function waitFor_default(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/index.ts
+var MDASH = "\u2014";
+var NDASH = "\u2013";
+var NOOP = () => void 0;
+export {
+  MDASH,
+  NDASH,
+  NOOP,
+  defineStore_default as defineStore,
+  downloadBlob_default as downloadBlob,
+  downloadString_default as downloadString,
+  downloadUrl_default as downloadUrl,
+  formatDate_default as formatDate,
+  formatDateFull_default as formatDateFull,
+  formatDateTime_default as formatDateTime,
+  formatMonth_default as formatMonth,
+  formatTime_default as formatTime,
+  isPointInPolygon_default as isPointInPolygon,
+  isToday_default as isToday,
+  openUrl_default as openUrl,
+  waitFor_default as waitFor
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/defineStore.ts", "../src/downloadUrl.ts", "../src/downloadBlob.ts", "../src/downloadString.ts", "../src/formatDate.ts", "../src/formatDateFull.ts", "../src/formatDateTime.ts", "../src/formatMonth.ts", "../src/formatTime.ts", "../src/isPointInPolygon.ts", "../src/isToday.ts", "../src/openUrl.ts", "../src/waitFor.ts", "../src/index.ts"],
+  "sourcesContent": ["import { defineStore, StoreGeneric, storeToRefs } from 'pinia';\n\nexport default function <Id extends string, Setup extends (...args: any[]) => any, Context = ReturnType<Setup>>(id: Id, setup: Setup): UseStore<Context> {\n    const storeFn = defineStore(id, setup);\n\n    return () => {\n        const store = storeFn();\n        const keys = Object.getOwnPropertyNames(store);\n        const refs = storeToRefs(store as StoreGeneric);\n        const result: Record<string, unknown> = {};\n\n        for (const key of keys) {\n            if (key.startsWith('$') || key.startsWith('_')) {\n                continue;\n            }\n\n            if (key in refs) {\n                result[key] = refs[key];\n                continue;\n            }\n\n            result[key] = store[key];\n        }\n\n        return result as Context;\n    };\n}\n\ntype UseStore<R> = {\n    (): R;\n}\n", "export default function (url: string, filename: string): void {\n    const anchor = document.createElement('a');\n    anchor.download = filename;\n    anchor.href = url;\n\n    document.body.appendChild(anchor);\n    anchor.click();\n    document.body.removeChild(anchor);\n}\n", "import downloadUrl from './downloadUrl';\n\nexport default function (blob: Blob, filename: string): void {\n    const url = URL.createObjectURL(blob);\n    downloadUrl(url, filename);\n    URL.revokeObjectURL(url);\n}\n", "import downloadBlob from './downloadBlob';\n\nexport default function (data: string, filename: string, type: string): void {\n    const blob = new Blob([data], {type});\n    downloadBlob(blob, filename);\n}\n", "import type { DateTime } from 'luxon';\n\nexport default function (dateTime: DateTime): string {\n    return dateTime.toLocaleString({\n        year: 'numeric',\n        month: 'long',\n        day: 'numeric',\n    });\n}\n", "import type { DateTime } from 'luxon';\n\nexport default function (dateTime: DateTime): string {\n    return dateTime.toLocaleString({\n        weekday: 'long',\n        day: 'numeric',\n        month: 'long'\n    });\n}\n", "import type { DateTime } from 'luxon';\n\nexport default function (dateTime: DateTime): string {\n    return dateTime.toLocaleString({\n        year: 'numeric',\n        month: 'long',\n        day: 'numeric',\n        hour: '2-digit',\n        minute: '2-digit'\n    });\n}\n", "import type { DateTime } from 'luxon';\n\nexport default function (dateTime: DateTime): string {\n    return dateTime.toLocaleString({\n        month: 'long',\n    });\n}\n", "import type { DateTime } from 'luxon';\n\nexport default function (dateTime: DateTime): string {\n    return dateTime.toLocaleString({\n        hour: '2-digit',\n        minute: '2-digit'\n    });\n}\n", "type Point = [number, number];\n\nexport default function (point: Point, polygon: Point[]): boolean {\n    let inside = false;\n\n    for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {\n        const xi = polygon[i][0], yi = polygon[i][1];\n        const xj = polygon[j][0], yj = polygon[j][1];\n        const intersect = ((yi > point[1]) != (yj > point[1])) && (point[0] < (xj - xi) * (point[1] - yi) / (yj - yi) + xi);\n\n        if (intersect) {\n            inside = !inside;\n        }\n    }\n\n    return inside;\n}\n", "import { DateTime } from 'luxon';\n\nexport default function (dateTime: DateTime): boolean {\n    const today = DateTime.now();\n    return today.hasSame(dateTime, 'day');\n}\n", "export default function (url: string): void {\n    if (window.location !== window.parent.location) {\n        window.open(url, '_top');\n    } else {\n        window.location.href = url;\n    }\n}\n", "export default async function (ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n}\n", "export { default as defineStore } from './defineStore';\nexport { default as downloadBlob } from './downloadBlob';\nexport { default as downloadString } from './downloadString';\nexport { default as downloadUrl } from './downloadUrl';\nexport { default as formatDate } from './formatDate';\nexport { default as formatDateFull } from './formatDateFull';\nexport { default as formatDateTime } from './formatDateTime';\nexport { default as formatMonth } from './formatMonth';\nexport { default as formatTime } from './formatTime';\nexport { default as isPointInPolygon } from './isPointInPolygon';\nexport { default as isToday } from './isToday';\nexport { default as openUrl } from './openUrl';\nexport { default as waitFor } from './waitFor';\n\nexport const MDASH = '\u2014';\nexport const NDASH = '\u2013';\nexport const NOOP = () => void 0;\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/waitFor.d.ts

@@ -0,0 +1 @@
+export default function (ms: number): Promise<void>;

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@basmilius/utils",
+  "version": "1.0.0",
+  "description": "Various utilities that are commonly used throughout personal projects.",
+  "type": "module",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/basmilius",
+  "author": {
+    "name": "Bas Milius",
+    "email": "bas@mili.us",
+    "url": "https://bas.dev"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/basmilius/utils.git"
+  },
+  "keywords": [
+    "util",
+    "utils",
+    "vue",
+    "pinia"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist/*"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "main": "./dist/utils.js",
+  "types": "./dist/index.d.ts",
+  "typings": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/utils.js"
+    }
+  },
+  "devDependencies": {
+    "@types/luxon": "^3.4.2",
+    "esbuild": "^0.24.0",
+    "luxon": "^3.5.0",
+    "pinia": "^2.2.4",
+    "tsc-alias": "^1.8.10",
+    "typescript": "^5.6.3"
+  },
+  "peerDependencies": {
+    "luxon": "^3.5.0",
+    "pinia": "^2.2.4"
+  },
+  "scripts": {
+    "build": "pnpm esbuild && pnpm gentypes",
+    "dev": "pnpm esbuild --watch",
+    "esbuild": "esbuild src/index.ts --bundle --sourcemap --external:luxon --external:pinia --platform=browser --target=esnext --format=esm --outfile=dist/utils.js",
+    "gentypes": "tsc && tsc-alias"
+  }
+}