Merge branch 'release/v0.19.0'

.vscode/settings.json

@@ -50,5 +50,6 @@
     "**/cypress/**",
     "**/.{idea,git,cache,output,temp}/**"
   ],
-  "typescript.tsdk": "node_modules/typescript/lib"
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "javascript.preferences.importModuleSpecifier": "relative"
 }

package.json

@@ -1,7 +1,7 @@
 {
   "name": "zeed",
   "type": "module",
-  "version": "0.18.7",
+  "version": "0.19.0",
   "description": "🌱 Simple foundation library",
   "author": {
     "name": "Dirk Holtwick",

src/browser/log/log-context-browser.ts

@@ -1,6 +1,8 @@
-import { isEmpty } from '../../common'
-import { getGlobalLogger } from '../../common/log'
+import { isEmpty } from '../../common/data/is'
+import { getGlobalLogger } from '../../common/log/log'
 import type { LogLevelAliasType, LoggerInterface } from '../../common/log/log-base'
+import type { LogConfig } from '../../common/log/log-config'
+import { _LoggerFromConfig } from '../../common/log/log-config'
 import { isBrowser } from '../../common/platform'
 import { LoggerBrowserHandler } from './log-browser'
 import { LoggerBrowserSetupDebugFactory } from './log-browser-factory'
@@ -13,3 +15,8 @@ export function Logger(name?: string, level?: LogLevelAliasType): LoggerInterfac
     }
   })(name, level)
 }
+
+/** See LogConfig */
+export function LoggerFromConfig(config: LogConfig, name: string, level?: LogLevelAliasType): LoggerInterface {
+  return _LoggerFromConfig(Logger, config, name, level)
+}

src/common/log/index.ts

@@ -1,6 +1,7 @@
 export * from './log'
 export * from './log-base'
 export * from './log-colors'
+export * from './log-config'
 export * from './log-console'
 export * from './log-console-original'
 export * from './log-console-capture'

src/common/log/log-config.ts

@@ -0,0 +1,35 @@
+import { isNumber, isString } from '../data/is'
+import { getGlobalLogger } from './log'
+import type { LogLevelAliasType, LoggerInterface } from './log-base'
+
+/**
+ * Simple log configuration for use in modular scenarios.
+ *
+ * `LogConfig` can be of various types:
+ *
+ * 1. `LoggerInterface`: Just a complete logger howeveryou like it
+ * 2. `true`: The default logger on
+ * 3. `string`: Logger with name
+ * 4. `number`: Logger with level e.g. set to `0` to see all
+ *
+ * All others turn it off.
+ */
+export type LogConfig = LoggerInterface | string | number | null | undefined | boolean
+
+/** See LogConfig */
+export function _LoggerFromConfig(
+  Logger: (name?: string, level?: LogLevelAliasType) => LoggerInterface,
+  config: LogConfig,
+  name: string,
+  level?: LogLevelAliasType,
+): LoggerInterface {
+  if (config === true)
+    return Logger(name, level)
+  if (isString(config) && config.length > 0)
+    return Logger(config, level)
+  if (isNumber(config))
+    return Logger(name, config)
+  if (typeof config === 'function')
+    return config
+  return Logger(name, false)
+}

src/node/log/log-context-node.ts

@@ -1,8 +1,10 @@
 import process from 'node:process'
-import { valueToBoolean } from '../../common'
-import { getGlobalLogger } from '../../common/log'
+import { valueToBoolean } from '../../common/data/convert'
+import type { LogConfig } from '../../common/log/log-config'
+import { getGlobalLogger } from '../../common/log/log'
 import type { LogLevelAliasType, LoggerInterface } from '../../common/log/log-base'
 import { toPath } from '../env'
+import { _LoggerFromConfig } from '../../common/log/log-config'
 import { LoggerFileHandler } from './log-file'
 import { LoggerNodeHandler } from './log-node'
 
@@ -25,3 +27,8 @@ export function Logger(name?: string, level?: LogLevelAliasType): LoggerInterfac
     context.setHandlers(handlers)
   })(name, level)
 }
+
+/** See LogConfig */
+export function LoggerFromConfig(config: LogConfig, name: string, level?: LogLevelAliasType): LoggerInterface {
+  return _LoggerFromConfig(Logger, config, name, level)
+}