@jkumonpm/dayjs-roc 1.0.0 → 1.0.1

package/README.md

@@ -1,20 +1,22 @@
-# dayjs-roc
+# @jkumonpm/dayjs-roc
 
 > Day.js plugin for Taiwan ROC (Republic of China) calendar year. Supports `RRR`/`RR` format output and ROC date parsing.
 
 ## Install
 
 ```bash
-npm install dayjs-roc
+npm install @jkumonpm/dayjs-roc
 ```
 
 Requires [dayjs](https://day.js.org/) as a peer dependency.
 
-## Quick Start
+## Two Usage Modes
+
+### 1️⃣ Plugin Mode (Day.js Extension)
 
 ```typescript
 import dayjs from 'dayjs'
-import roc from 'dayjs-roc'
+import roc from '@jkumonpm/dayjs-roc'
 
 dayjs.extend(roc)
 
@@ -27,6 +29,41 @@ dayjs('1912-01-01').format('RRR年MM月DD日') // → '001年01月01日'
 dayjs('2026-04-04').rocYear()  // → 115
 ```
 
+### 2️⃣ Direct Function Mode (No Day.js Required)
+
+```typescript
+import { rocToAD, adToROC, isROCDate, parseROC, formatRRR, formatRR, isROC, parseROCDate } from '@jkumonpm/dayjs-roc'
+
+// Convert ROC year to AD year
+rocToAD(115)   // → 2026
+rocToAD(1)     // → 1912
+rocToAD(0)     // → null
+
+// Convert AD year to ROC year
+adToROC(2026)  // → 115
+adToROC(1912)  // → 1
+adToROC(1911)  // → null
+
+// Validate ROC date string
+isROCDate('115/04/04')  // → true
+isROCDate('115/13/01')  // → false
+isROC('115/04/04')      // → true (alias)
+
+// Parse ROC date string to native Date
+parseROC('115/04/04')   // → Date(2026, 3, 4)
+parseROC('invalid')     // → null
+
+// Parse ROC date string to Dayjs
+parseROCDate('115/04/04')?.format('YYYY-MM-DD')  // → '2026-04-04'
+parseROCDate('invalid')  // → null
+
+// Format ROC year
+formatRRR(115)  // → '115'
+formatRRR(1)    // → '001'
+formatRR(15)    // → '15'
+formatRR(1)     // → '01'
+```
+
 ## Format Tokens
 
 | Token | Output | Description |
@@ -53,7 +90,7 @@ today.format('RR/MM/DD HH:mm')   // → '15/04/04 14:30'
 Check if a string is a valid ROC date format.
 
 ```typescript
-import { isROC } from 'dayjs-roc'
+import { isROC } from '@jkumonpm/dayjs-roc'
 
 isROC('115/04/04')    // → true
 isROC('1/1/1')        // → true
@@ -68,7 +105,7 @@ isROC('abc')          // → false
 Parse a ROC date string into a Dayjs instance.
 
 ```typescript
-import { parseROCDate } from 'dayjs-roc'
+import { parseROCDate } from '@jkumonpm/dayjs-roc'
 
 const date = parseROCDate('115/04/04')
 date?.year()   // → 2026
@@ -82,7 +119,7 @@ parseROCDate('invalid')  // → null
 ### Core Functions (no Day.js required)
 
 ```typescript
-import { rocToAD, adToROC, isROCDate, parseROC, formatRRR, formatRR } from 'dayjs-roc'
+import { rocToAD, adToROC, isROCDate, parseROC, formatRRR, formatRR } from '@jkumonpm/dayjs-roc'
 
 // Convert ROC year to AD year
 rocToAD(115)   // → 2026

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 import type { PluginFunc, Dayjs } from 'dayjs';
+import { rocToAD, adToROC, isROCDate, parseROC, formatRRR, formatRR } from './roc-utils.js';
 declare module 'dayjs' {
     interface Dayjs {
         rocYear(): number | null;
     }
 }
+export { rocToAD, adToROC, isROCDate, parseROC, formatRRR, formatRR };
 /**
  * Check if a string is a valid ROC date format.
  * @param str - Date string to check

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAU9C,OAAO,QAAQ,OAAO,CAAC;IACrB,UAAU,KAAK;QACb,OAAO,IAAI,MAAM,GAAG,IAAI,CAAA;KACzB;CACF;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAItD;AAED,QAAA,MAAM,GAAG,EAAE,UA+BV,CAAA;AAED,eAAe,GAAG,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAE9C,OAAO,EACL,OAAO,EACP,OAAO,EACP,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,EACT,MAAM,gBAAgB,CAAA;AAEvB,OAAO,QAAQ,OAAO,CAAC;IACrB,UAAU,KAAK;QACb,OAAO,IAAI,MAAM,GAAG,IAAI,CAAA;KACzB;CACF;AAGD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;AAErE;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAItD;AAED,QAAA,MAAM,GAAG,EAAE,UA+BV,CAAA;AAED,eAAe,GAAG,CAAA"}

package/dist/index.js

@@ -1,5 +1,7 @@
 import dayjs from 'dayjs';
-import { adToROC, isROCDate, parseROC, formatRRR, formatRR, } from './roc-utils.js';
+import { rocToAD, adToROC, isROCDate, parseROC, formatRRR, formatRR, } from './roc-utils.js';
+// Re-export utility functions for direct use (no Day.js required)
+export { rocToAD, adToROC, isROCDate, parseROC, formatRRR, formatRR };
 /**
  * Check if a string is a valid ROC date format.
  * @param str - Date string to check

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EACL,OAAO,EACP,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,MAAM,gBAAgB,CAAA;AAQvB;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,OAAO,SAAS,CAAC,GAAG,CAAC,CAAA;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;IAC1B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAA;AACpB,CAAC;AAED,MAAM,GAAG,GAAe,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,EAAE;IAC7D,uDAAuD;IACvD,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,MAAM,CAAA;IAC7C,UAAU,CAAC,SAAS,CAAC,MAAM,GAAG,UAAU,SAAkB;QACxD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7B,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;QAE/B,0BAA0B;QAC1B,IAAI,MAAM,GAAG,SAAS,CAAA;QACtB,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;YAC9B,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;YAC5B,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACjB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;YACtC,CAAC;YACD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAChB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;YACpC,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACrC,CAAC,CAAA;IAED,kDAAkD;IAClD,UAAU,CAAC,SAAS,CAAC,OAAO,GAAG;QAC7B,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IAC7B,CAAC,CAAA;AACH,CAAC,CAAA;AAED,eAAe,GAAG,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EACL,OAAO,EACP,OAAO,EACP,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,MAAM,gBAAgB,CAAA;AAQvB,kEAAkE;AAClE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;AAErE;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,OAAO,SAAS,CAAC,GAAG,CAAC,CAAA;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;IAC1B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAA;AACpB,CAAC;AAED,MAAM,GAAG,GAAe,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,EAAE;IAC7D,uDAAuD;IACvD,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,MAAM,CAAA;IAC7C,UAAU,CAAC,SAAS,CAAC,MAAM,GAAG,UAAU,SAAkB;QACxD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7B,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;QAE/B,0BAA0B;QAC1B,IAAI,MAAM,GAAG,SAAS,CAAA;QACtB,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;YAC9B,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;YAC5B,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACjB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;YACtC,CAAC;YACD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAChB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;YACpC,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACrC,CAAC,CAAA;IAED,kDAAkD;IAClD,UAAU,CAAC,SAAS,CAAC,OAAO,GAAG;QAC7B,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IAC7B,CAAC,CAAA;AACH,CAAC,CAAA;AAED,eAAe,GAAG,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jkumonpm/dayjs-roc",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Day.js plugin for Taiwan ROC calendar year. Supports RRR/RR format and ROC date parsing.",
   "type": "module",
   "main": "./dist/index.js",