Merge pull request #107 from knowledgecode/develop

Support literal square brackets in format strings

Author: knowledgecode

docs/api/compile.md

@@ -76,11 +76,11 @@ dates.forEach(date => {
 import { compile, format } from 'date-and-time';
 
 class Logger {
-  private timestampPattern = compile('YYYY-MM-DD HH:mm:ss.SSS');
-  
+  private timestampPattern = compile('\\[YYYY-MM-DD HH:mm:ss.SSS\\]');
+
   log(level: string, message: string) {
     const timestamp = format(new Date(), this.timestampPattern);
-    console.log(`[${timestamp}] ${level.toUpperCase()}: ${message}`);
+    console.log(`${timestamp} ${level.toUpperCase()}: ${message}`);
   }
 }
 

docs/api/format.md

@@ -274,6 +274,10 @@ format(date, 'YYYY-MM-DD[T]HH:mm:ss[Z]');
 
 format(date, '[Report generated on] YYYY/MM/DD [at] HH:mm');
 // => Report generated on 2025/08/23 at 14:30
+
+// Escape square brackets to output them literally
+format(date, '\\[YYYY-MM-DD HH:mm:ss\\]');
+// => [2025-08-23 14:30:45]
 ```
 
 ### Complex Localized Formatting

docs/api/parse.md

@@ -383,6 +383,10 @@ parse('2025-08-23T14:30:45Z', 'YYYY-MM-DD[T]HH:mm:ss[Z]');
 
 parse('Report generated on 2025/08/23 at 14:30', '[Report generated on] YYYY/MM/DD [at] HH:mm');
 // => Fri Aug 23 2025 14:30:00 GMT+0900
+
+// Escape square brackets to parse them from input string
+parse('[2025-08-23 14:30:45]', '\\[YYYY-MM-DD HH:mm:ss\\]');
+// => Fri Aug 23 2025 14:30:45 GMT+0900
 ```
 
 ### Wildcard Parsing

docs/guide/index.md

@@ -58,7 +58,7 @@
 
 - **Timezone Support** - Comprehensive timezone data from timezonedb
 - **Locale Support** - 40+ languages with native formatting
-- **Plugin System** - Extensible with microsecond/nanosecond precision
+- **Plugin System** - Extend formatters and parsers
 - **Duration Objects** - Rich time difference calculations
 
 ## Version 4.x Highlights

eslint.config.ts eslint.config.jseslint.config.ts renamed to eslint.config.js

@@ -1,14 +1,17 @@
+// @ts-check
+import { defineConfig } from 'eslint/config';
 import tseslint from 'typescript-eslint';
 
-export default tseslint.config(
-  ...tseslint.configs.strict,
-  ...tseslint.configs.stylistic,
+export default defineConfig(
+  tseslint.configs.strict,
+  tseslint.configs.stylistic,
   {
     files: ['**/*.ts'],
     languageOptions: {
       ecmaVersion: 2021,
       sourceType: 'module',
       globals: {
+        process: true
       },
       parserOptions: {
         project: './tsconfig.json',