@f-o-t/datetime 0.1.0 → 0.1.4

package/dist/types.d.ts

@@ -0,0 +1,96 @@
+import type { DateTime as DateTimeInstance } from "./core/datetime";
+/**
+ * Time units supported by the library
+ */
+export type TimeUnit = "millisecond" | "second" | "minute" | "hour" | "day" | "week" | "month" | "year";
+/**
+ * DateTime instance type - re-exported from the class
+ */
+export type DateTime = DateTimeInstance;
+/**
+ * Input types that can be converted to DateTime
+ */
+export type DateInput = Date | string | number | DateTime;
+/**
+ * DateTime class type (used for plugin typing)
+ * Must be defined before DateTimePlugin to avoid forward reference
+ */
+export interface DateTimeClass {
+    new (input?: DateInput): DateTime;
+    prototype: DateTime;
+    extend: (plugin: DateTimePlugin, options?: Record<string, unknown>) => void;
+    hasPlugin: (name: string) => boolean;
+    getPlugin: (name: string) => DateTimePlugin | undefined;
+}
+/**
+ * Plugin definition
+ */
+export interface DateTimePlugin {
+    /**
+     * Plugin name (must be unique)
+     */
+    name: string;
+    /**
+     * Install function that extends the DateTime class
+     * @param DateTimeClass - The DateTime class to extend
+     * @param options - Optional plugin configuration
+     */
+    install: (DateTimeClass: DateTimeClass, options?: Record<string, unknown>) => void;
+}
+/**
+ * Configuration options for DateTime instance creation
+ */
+export interface DateTimeConfig {
+    /**
+     * Timezone (IANA timezone string, e.g., "America/New_York")
+     * Defaults to system timezone
+     */
+    timezone?: string;
+    /**
+     * Locale for formatting (BCP 47 language tag, e.g., "en-US")
+     * Defaults to system locale
+     */
+    locale?: string;
+    /**
+     * Whether to use UTC mode
+     * @default false
+     */
+    utc?: boolean;
+    /**
+     * Whether parsing should be strict
+     * @default true
+     */
+    strict?: boolean;
+}
+/**
+ * Options for formatting dates
+ */
+export interface FormatOptions {
+    /**
+     * Locale for formatting (BCP 47 language tag)
+     */
+    locale?: string;
+    /**
+     * Timezone for formatting (IANA timezone string)
+     */
+    timezone?: string;
+}
+/**
+ * Options for parsing dates
+ */
+export interface ParseOptions {
+    /**
+     * Whether to use strict parsing
+     * @default true
+     */
+    strict?: boolean;
+    /**
+     * Expected format string
+     */
+    format?: string;
+    /**
+     * Timezone to parse in (IANA timezone string)
+     */
+    timezone?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,QAAQ,GACf,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,KAAK,GACL,MAAM,GACN,OAAO,GACP,MAAM,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC3B,KAAK,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAClC,SAAS,EAAE,QAAQ,CAAC;IACpB,MAAM,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC5E,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACrC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,OAAO,EAAE,CACN,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,IAAI,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC3B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/package.json

@@ -1,47 +1,52 @@
 {
-  "name": "@f-o-t/datetime",
-  "version": "0.1.0",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./plugins/timezone": {
-      "types": "./dist/plugins/timezone/index.d.ts",
-      "default": "./dist/plugins/timezone/index.js"
-    },
-    "./plugins/business-days": {
-      "types": "./dist/plugins/business-days/index.d.ts",
-      "default": "./dist/plugins/business-days/index.js"
-    },
-    "./plugins/format": {
-      "types": "./dist/plugins/format/index.d.ts",
-      "default": "./dist/plugins/format/index.js"
-    },
-    "./plugins/relative-time": {
-      "types": "./dist/plugins/relative-time/index.d.ts",
-      "default": "./dist/plugins/relative-time/index.js"
-    }
-  },
-  "scripts": {
-    "build": "bunup",
-    "dev": "bunup --watch",
-    "test": "bun test",
-    "test:coverage": "bun test --coverage",
-    "test:watch": "bun test --watch",
-    "typecheck": "tsc",
-    "check": "biome check --write ."
-  },
-  "devDependencies": {
-    "@f-o-t/cli": "workspace:*",
-    "@f-o-t/config": "workspace:*"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/F-O-T/libraries.git",
-    "directory": "libraries/datetime"
-  }
+   "name": "@f-o-t/datetime",
+   "version": "0.1.4",
+   "type": "module",
+   "files": [
+      "dist"
+   ],
+   "main": "./dist/index.js",
+   "types": "./dist/index.d.ts",
+   "exports": {
+      ".": {
+         "types": "./dist/index.d.ts",
+         "default": "./dist/index.js"
+      },
+      "./plugins/timezone": {
+         "types": "./dist/plugins/timezone/index.d.ts",
+         "default": "./dist/plugins/timezone/index.js"
+      },
+      "./plugins/business-days": {
+         "types": "./dist/plugins/business-days/index.d.ts",
+         "default": "./dist/plugins/business-days/index.js"
+      },
+      "./plugins/format": {
+         "types": "./dist/plugins/format/index.d.ts",
+         "default": "./dist/plugins/format/index.js"
+      },
+      "./plugins/relative-time": {
+         "types": "./dist/plugins/relative-time/index.d.ts",
+         "default": "./dist/plugins/relative-time/index.js"
+      }
+   },
+   "scripts": {
+      "build": "bun x --bun fot build",
+      "test": "bun x --bun fot test",
+      "lint": "bun x --bun fot lint",
+      "format": "bun x --bun fot format",
+      "typecheck": "bun x --bun fot typecheck"
+   },
+   "dependencies": {
+      "zod": "^4.3.6"
+   },
+   "devDependencies": {
+      "@f-o-t/cli": "^1.0.0",
+      "@f-o-t/config": "^1.0.0",
+      "@types/bun": "latest"
+   },
+   "repository": {
+      "type": "git",
+      "url": "https://github.com/F-O-T/libraries.git",
+      "directory": "libraries/datetime"
+   }
 }

package/CHANGELOG.md

@@ -1,13 +0,0 @@
-# Changelog
-
-## 0.1.0
-
-### Features
-
-- `DateTime` class with core datetime functionality
-- `datetime()` factory function for creating DateTime instances
-- Plugin system with `createPlugin()`, `isPlugin()`, and `isValidPluginName()`
-- Date parsing and formatting with configurable options
-- Error handling with `InvalidDateError` and `PluginError`
-- Type definitions for DateInput, TimeUnit, FormatOptions, and ParseOptions
-- DateInputSchema for validation

package/biome.json

@@ -1,39 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
-  "vcs": {
-    "enabled": true,
-    "clientKind": "git",
-    "useIgnoreFile": true,
-    "defaultBranch": "main"
-  },
-  "files": {
-    "ignoreUnknown": false,
-    "ignore": [
-      "node_modules",
-      "dist",
-      "*.config.ts"
-    ]
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "tab",
-    "indentWidth": 2,
-    "lineWidth": 80
-  },
-  "organizeImports": {
-    "enabled": true
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true
-    }
-  },
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "double",
-      "semicolons": "always",
-      "trailingCommas": "all"
-    }
-  }
-}

package/bunup.config.ts

@@ -1,14 +0,0 @@
-import { defineConfig } from "bunup";
-
-export default defineConfig({
-   dts: {
-      inferTypes: true,
-   },
-   entry: [
-      "src/index.ts",
-      "src/plugins/timezone/index.ts",
-      "src/plugins/business-days/index.ts",
-      "src/plugins/format/index.ts",
-      "src/plugins/relative-time/index.ts",
-   ],
-});

package/examples/plugins-demo.ts

@@ -1,85 +0,0 @@
-/**
- * Demo script showing all four core plugins in action
- */
-import { DateTime } from "../src/core/datetime";
-import {
-   businessDaysPlugin,
-   formatPlugin,
-   relativeTimePlugin,
-   timezonePlugin,
-} from "../src/plugins/index";
-
-// Install all plugins
-DateTime.extend(timezonePlugin);
-DateTime.extend(businessDaysPlugin);
-DateTime.extend(formatPlugin);
-DateTime.extend(relativeTimePlugin);
-
-console.log("🎉 DateTime Plugin Demo\n");
-
-// Create a DateTime instance
-const dt = new DateTime("2024-01-15T14:30:45.123Z");
-console.log("Base DateTime:", dt.toISO());
-console.log();
-
-// 1. Timezone Plugin
-console.log("📍 Timezone Plugin:");
-console.log("  Current timezone:", (dt as any).getTimezone());
-const nyTime = (dt as any).tz("America/New_York");
-console.log("  New York time:", (nyTime as any).getTimezone());
-const utcTime = (nyTime as any).utc();
-console.log("  Back to UTC:", (utcTime as any).getTimezone());
-console.log();
-
-// 2. Business Days Plugin
-console.log("💼 Business Days Plugin:");
-const monday = new DateTime("2024-01-15T12:00:00.000Z"); // Monday
-console.log("  Is Monday a weekday?", (monday as any).isWeekday());
-const saturday = new DateTime("2024-01-20T12:00:00.000Z"); // Saturday
-console.log("  Is Saturday a weekday?", (saturday as any).isWeekday());
-const plusThreeDays = (monday as any).addBusinessDays(3);
-console.log(
-   "  Monday + 3 business days:",
-   (plusThreeDays as any).format("dddd, MMMM D"),
-);
-console.log();
-
-// 3. Format Plugin
-console.log("🎨 Format Plugin:");
-console.log("  ISO format:", dt.toISO());
-console.log("  Custom format (YYYY-MM-DD):", (dt as any).format("YYYY-MM-DD"));
-console.log("  Custom format (MM/DD/YYYY):", (dt as any).format("MM/DD/YYYY"));
-console.log(
-   "  Custom format (MMMM D, YYYY):",
-   (dt as any).format("MMMM D, YYYY"),
-);
-console.log("  Custom format (h:mm A):", (dt as any).format("h:mm A"));
-console.log(
-   "  Custom format (dddd, MMMM D, YYYY [at] h:mm A):",
-   (dt as any).format("dddd, MMMM D, YYYY [at] h:mm A"),
-);
-console.log();
-
-// 4. Relative Time Plugin
-console.log("⏰ Relative Time Plugin:");
-const now = new DateTime();
-const hourAgo = now.subtractHours(1);
-const tomorrow = now.addDays(1);
-const lastWeek = now.subtractDays(7);
-
-console.log("  1 hour ago from now:", (hourAgo as any).fromNow());
-console.log("  Tomorrow from now:", (tomorrow as any).fromNow());
-console.log("  Last week from now:", (lastWeek as any).fromNow());
-console.log();
-
-// Chaining plugins together
-console.log("🔗 Chaining Plugins:");
-const chained = new DateTime("2024-01-15T12:00:00.000Z");
-const result = (chained as any)
-   .addBusinessDays(5)
-   .tz("America/New_York")
-   .format("dddd, MMMM D, YYYY [at] h:mm A");
-console.log("  Monday + 5 business days in NY:", result);
-console.log();
-
-console.log("✅ All plugins working perfectly!");

package/fot.config.ts

@@ -1,5 +0,0 @@
-import { defineFotConfig } from '@f-o-t/config';
-
-export default defineFotConfig({
-  plugins: ['timezone', 'business-days', 'format', 'relative-time'],
-});