@powerlines/core 0.9.1 → 0.9.2

package/dist/types/logging.d.cts

@@ -0,0 +1,161 @@
+import { LOG_CATEGORIES, LOG_LEVELS } from "../constants/log-level.cjs";
+import { Mode } from "./config.cjs";
+import { PartialKeys, RequiredKeys } from "@stryke/types/base";
+import { UnpluginMessage } from "unplugin";
+
+//#region src/types/logging.d.ts
+type LogLevel = (typeof LOG_LEVELS)[number];
+type LogCategory = (typeof LOG_CATEGORIES)[number];
+interface LogMeta {
+  /**
+   * A unique identifier for the log message, which can be used to correlate related log entries across different parts of the system or different executions.
+   */
+  logId: string;
+  /**
+   * The log level of the message, which indicates the severity or importance of the log entry. The log level can be used to filter log messages based on their importance, allowing users to focus on critical issues or relevant information while ignoring less important messages.
+   */
+  type: LogLevel;
+  /**
+   * The category of the log message, which can be used to classify and filter log entries based on their purpose or origin.
+   */
+  category: LogCategory;
+  /**
+   * The timestamp when the RPC message was created, represented as the number of milliseconds since the Unix epoch.
+   */
+  timestamp: number;
+  /**
+   * The name of the project or package associated with the log message, which can be used to identify the source of the log entry and provide context for the message.
+   */
+  name?: string;
+  /**
+   * A unique identifier for the current execution instance, which can be used for logging and other purposes to distinguish between different executions in the same process.
+   */
+  executionId?: string;
+  /**
+   * The zero-based index of the current execution within the sequence of executions in the same process.
+   */
+  configIndex?: number;
+  /**
+   * Optional command identifier to specify the command or task associated with the log message, which can be used to provide additional context about the operation being performed when the log entry was generated.
+   */
+  command?: string;
+  /**
+   * Optional hook name to specify the plugin hook associated with the log message, which can be used to provide additional context about the specific plugin hook being executed when the log entry was generated.
+   */
+  hook?: string;
+  /**
+   * Optional environment identifier to specify the context or environment in which the message is being processed.
+   */
+  environment?: string;
+  /**
+   * Optional plugin name to specify the source plugin of the log message.
+   */
+  plugin?: string;
+  /**
+   * The name of the logger or source of the log message, which can be used to identify the origin of the log entry.
+   */
+  source?: string;
+  /**
+   * Indicates whether the log message is related to inter-process communication (IPC).
+   *
+   * @internal
+   */
+  $$ipc?: boolean;
+}
+type LogFnOptions = Omit<Partial<LogMeta>, "logId" | "timestamp" | "name" | "type"> & {
+  mode?: Mode;
+  logLevel?: LogLevelUserConfig;
+};
+type LogFnMeta = LogLevel | PartialKeys<LogMeta, "logId" | "timestamp" | "name" | "category">;
+type LogFn = (meta: LogFnMeta, message: string) => void;
+type LoggerMeta = PartialKeys<Omit<LogMeta, "type">, "logId" | "timestamp" | "name" | "category">;
+type LoggerOptions = Omit<LoggerMeta, "logId" | "timestamp" | "type"> & {
+  mode?: Mode;
+  logLevel?: LogLevelUserConfig;
+};
+interface PowerlinesMessage<TMeta> extends UnpluginMessage {
+  meta: TMeta;
+  error?: Error;
+}
+type LogMessage = PowerlinesMessage<Partial<LogMeta>>;
+/**
+ * A type representing a log message that can be passed to the logging methods defined in the {@link Logger} interface, which includes the log metadata and message content. This type is used as the parameter for the logging methods defined in the {@link Logger} interface, allowing users to log messages with rich metadata that can be used for filtering, formatting, or other purposes in the logging implementation.
+ */
+type LoggerMessage = PowerlinesMessage<LoggerMeta>;
+/**
+ * An internal interface representing a logger instance used within Powerlines for logging messages at various log levels, including "error", "warn", "info", "debug", and "trace". This interface defines methods for logging messages at each log level, which accept a message parameter that can be either a string or an object containing the log metadata and message content. The logger instance also includes an options property that contains the configuration options used for the logger, such as the source, command, environment, plugin, log level, and other relevant metadata. This interface is intended for internal use within Powerlines and is not meant to be implemented by users directly; instead, users can provide a custom logger that implements the {@link CustomLogger} interface to integrate with Powerlines' logging system.
+ */
+interface Logger {
+  options: LoggerOptions;
+  error: (message: string | LoggerMessage | Error) => void;
+  warn: (message: string | LoggerMessage) => void;
+  info: (message: string | LoggerMessage) => void;
+  debug: (message: string | LoggerMessage) => void;
+  trace: (message: string | LoggerMessage) => void;
+  log: (type: LogLevel, message: string | LoggerMessage) => void;
+}
+/**
+ * A type representing a log message that can be passed to a custom logger, which includes the log metadata and message content. This type is used as the parameter for the logging methods defined in the {@link CustomLogger} interface, allowing users to log messages with rich metadata that can be used for filtering, formatting, or other purposes in their custom logging implementation.
+ */
+type CustomLoggerMessage = PowerlinesMessage<Omit<LogMeta, "type">>;
+/**
+ * An interface representing a custom logger that can be provided by the user to override the default logging behavior of Powerlines. This interface defines methods for logging messages at different log levels, including "error", "warn", "info", "debug", and "trace". Each method accepts a message parameter, which can be either a string or an object containing the log metadata and message content. By implementing this interface, users can integrate their own logging system with Powerlines or customize the logging behavior to suit their specific needs.
+ */
+interface CustomLogger {
+  /**
+   * A function to log messages at the "error" level, which indicates a serious issue that has caused a failure in the build process or a critical problem that needs immediate attention.
+   *
+   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the error being reported.
+   * @returns void
+   */
+  error?: (message: CustomLoggerMessage) => void;
+  /**
+   * A function to log messages at the "warn" level, which indicates a potential issue or a situation that may require attention but does not necessarily cause a failure in the build process.
+   *
+   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the warning being reported.
+   * @returns void
+   */
+  warn?: (message: CustomLoggerMessage) => void;
+  /**
+   * A function to log messages at the "info" level, which indicates general informational messages about the build process, such as the start and completion of tasks, configuration details, or other relevant information that may be useful for monitoring the build process.
+   *
+   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the informational message being reported.
+   * @returns void
+   */
+  info?: (message: CustomLoggerMessage) => void;
+  /**
+   * A function to log messages at the "debug" level, which indicates detailed debugging information that may be useful for diagnosing issues during development or troubleshooting problems in the build process.
+   *
+   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the debug information being reported.
+   * @returns void
+   */
+  debug?: (message: CustomLoggerMessage) => void;
+  /**
+   * A function to log messages at the "trace" level, which indicates very detailed tracing information that may be useful for in-depth analysis of the build process or for tracking the flow of execution through various stages of the build.
+   *
+   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the trace information being reported.
+   * @returns void
+   */
+  trace?: (message: CustomLoggerMessage) => void;
+}
+type LogLevelUserConfig = LogLevel | RequiredKeys<Partial<Record<LogCategory, LogLevel | boolean | undefined>>, "general">;
+type LogLevelResolvedConfig = Record<LogCategory, LogLevel>;
+declare type __ΩLogLevel = any[];
+declare type __ΩLogCategory = any[];
+declare type __ΩLogMeta = any[];
+declare type __ΩLogFnOptions = any[];
+declare type __ΩLogFnMeta = any[];
+declare type __ΩLogFn = any[];
+declare type __ΩLoggerMeta = any[];
+declare type __ΩLoggerOptions = any[];
+declare type __ΩPowerlinesMessage = any[];
+declare type __ΩLogMessage = any[];
+declare type __ΩLoggerMessage = any[];
+declare type __ΩLogger = any[];
+declare type __ΩCustomLoggerMessage = any[];
+declare type __ΩCustomLogger = any[];
+declare type __ΩLogLevelUserConfig = any[];
+declare type __ΩLogLevelResolvedConfig = any[];
+//#endregion
+export { CustomLogger, CustomLoggerMessage, LogCategory, LogFn, LogFnMeta, LogFnOptions, LogLevel, LogLevelResolvedConfig, LogLevelUserConfig, LogMessage, LogMeta, Logger, LoggerMessage, LoggerMeta, LoggerOptions, PowerlinesMessage, __ΩCustomLogger, __ΩCustomLoggerMessage, __ΩLogCategory, __ΩLogFn, __ΩLogFnMeta, __ΩLogFnOptions, __ΩLogLevel, __ΩLogLevelResolvedConfig, __ΩLogLevelUserConfig, __ΩLogMessage, __ΩLogMeta, __ΩLogger, __ΩLoggerMessage, __ΩLoggerMeta, __ΩLoggerOptions, __ΩPowerlinesMessage };
+//# sourceMappingURL=logging.d.cts.map

package/dist/types/logging.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.cts","names":[],"sources":["../../src/types/logging.ts"],"mappings":";;;;;;KAuBY,QAAA,WAAmB,UAAA;AAAA,KAEnB,WAAA,WAAsB,cAAA;AAAA,UAEjB,OAAA;EAJG;;;EAQlB,KAAA;EANU;;;EAUV,IAAA,EAAM,QAAA;EAVwC;AAEhD;;EAYE,QAAA,EAAU,WAAA;EAAW;;;EAIrB,SAAA;EAJA;;;EAQA,IAAA;EAIA;;;EAAA,WAAA;EAgBA;;;EAZA,WAAA;EA0BK;;AAGP;EAzBE,OAAA;;;;EAIA,IAAA;EAyBO;;;EArBP,WAAA;EAiByB;;;EAbzB,MAAA;EAiBO;;;EAbP,MAAA;EAc6B;AAG/B;;;;EAXE,KAAA;AAAA;AAAA,KAGU,YAAA,GAAe,IAAA,CACzB,OAAA,CAAQ,OAAA;EAGR,IAAA,GAAO,IAAA;EACP,QAAA,GAAW,kBAAA;AAAA;AAAA,KAGD,SAAA,GACR,QAAA,GACA,WAAA,CAAY,OAAA;AAAA,KAEJ,KAAA,IAAS,IAAA,EAAM,SAAA,EAAW,OAAA;AAAA,KAE1B,UAAA,GAAa,WAAA,CACvB,IAAA,CAAK,OAAA;AAAA,KAIK,aAAA,GAAgB,IAAA,CAAK,UAAA;EAC/B,IAAA,GAAO,IAAA;EACP,QAAA,GAAW,kBAAA;AAAA;AAAA,UAGI,iBAAA,gBAAiC,eAAA;EAChD,IAAA,EAAM,KAAA;EACN,KAAA,GAAQ,KAAA;AAAA;AAAA,KAGE,UAAA,GAAa,iBAAA,CAAkB,OAAA,CAAQ,OAAA;AAfnD;;;AAAA,KAoBY,aAAA,GAAgB,iBAAA,CAAkB,UAAA;;;;UAK7B,MAAA;EACf,OAAA,EAAS,aAAA;EACT,KAAA,GAAQ,OAAA,WAAkB,aAAA,GAAgB,KAAA;EAC1C,IAAA,GAAO,OAAA,WAAkB,aAAA;EACzB,IAAA,GAAO,OAAA,WAAkB,aAAA;EACzB,KAAA,GAAQ,OAAA,WAAkB,aAAA;EAC1B,KAAA,GAAQ,OAAA,WAAkB,aAAA;EAC1B,GAAA,GAAM,IAAA,EAAM,QAAA,EAAU,OAAA,WAAkB,aAAA;AAAA;;;;KAM9B,mBAAA,GAAsB,iBAAA,CAAkB,IAAA,CAAK,OAAA;;;;UAKxC,YAAA;EArCf;;;;;;EA4CA,KAAA,IAAS,OAAA,EAAS,mBAAA;EAxCc;;;;;;EA+ChC,IAAA,IAAQ,OAAA,EAAS,mBAAA;EA/CgB;;;;;;EAsDjC,IAAA,IAAQ,OAAA,EAAS,mBAAA;EApDJ;AAGf;;;;;EAwDE,KAAA,IAAS,OAAA,EAAS,mBAAA;EAxDsB;;;;;;EA+DxC,KAAA,IAAS,OAAA,EAAS,mBAAA;AAAA;AAAA,KAGR,kBAAA,GACR,QAAA,GACA,YAAA,CACE,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA,KAItB,sBAAA,GAAyB,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA"}

package/dist/types/logging.d.mts

@@ -0,0 +1,161 @@
+import { LOG_CATEGORIES, LOG_LEVELS } from "../constants/log-level.mjs";
+import { Mode } from "./config.mjs";
+import { UnpluginMessage } from "unplugin";
+import { PartialKeys, RequiredKeys } from "@stryke/types/base";
+
+//#region src/types/logging.d.ts
+type LogLevel = (typeof LOG_LEVELS)[number];
+type LogCategory = (typeof LOG_CATEGORIES)[number];
+interface LogMeta {
+  /**
+   * A unique identifier for the log message, which can be used to correlate related log entries across different parts of the system or different executions.
+   */
+  logId: string;
+  /**
+   * The log level of the message, which indicates the severity or importance of the log entry. The log level can be used to filter log messages based on their importance, allowing users to focus on critical issues or relevant information while ignoring less important messages.
+   */
+  type: LogLevel;
+  /**
+   * The category of the log message, which can be used to classify and filter log entries based on their purpose or origin.
+   */
+  category: LogCategory;
+  /**
+   * The timestamp when the RPC message was created, represented as the number of milliseconds since the Unix epoch.
+   */
+  timestamp: number;
+  /**
+   * The name of the project or package associated with the log message, which can be used to identify the source of the log entry and provide context for the message.
+   */
+  name?: string;
+  /**
+   * A unique identifier for the current execution instance, which can be used for logging and other purposes to distinguish between different executions in the same process.
+   */
+  executionId?: string;
+  /**
+   * The zero-based index of the current execution within the sequence of executions in the same process.
+   */
+  configIndex?: number;
+  /**
+   * Optional command identifier to specify the command or task associated with the log message, which can be used to provide additional context about the operation being performed when the log entry was generated.
+   */
+  command?: string;
+  /**
+   * Optional hook name to specify the plugin hook associated with the log message, which can be used to provide additional context about the specific plugin hook being executed when the log entry was generated.
+   */
+  hook?: string;
+  /**
+   * Optional environment identifier to specify the context or environment in which the message is being processed.
+   */
+  environment?: string;
+  /**
+   * Optional plugin name to specify the source plugin of the log message.
+   */
+  plugin?: string;
+  /**
+   * The name of the logger or source of the log message, which can be used to identify the origin of the log entry.
+   */
+  source?: string;
+  /**
+   * Indicates whether the log message is related to inter-process communication (IPC).
+   *
+   * @internal
+   */
+  $$ipc?: boolean;
+}
+type LogFnOptions = Omit<Partial<LogMeta>, "logId" | "timestamp" | "name" | "type"> & {
+  mode?: Mode;
+  logLevel?: LogLevelUserConfig;
+};
+type LogFnMeta = LogLevel | PartialKeys<LogMeta, "logId" | "timestamp" | "name" | "category">;
+type LogFn = (meta: LogFnMeta, message: string) => void;
+type LoggerMeta = PartialKeys<Omit<LogMeta, "type">, "logId" | "timestamp" | "name" | "category">;
+type LoggerOptions = Omit<LoggerMeta, "logId" | "timestamp" | "type"> & {
+  mode?: Mode;
+  logLevel?: LogLevelUserConfig;
+};
+interface PowerlinesMessage<TMeta> extends UnpluginMessage {
+  meta: TMeta;
+  error?: Error;
+}
+type LogMessage = PowerlinesMessage<Partial<LogMeta>>;
+/**
+ * A type representing a log message that can be passed to the logging methods defined in the {@link Logger} interface, which includes the log metadata and message content. This type is used as the parameter for the logging methods defined in the {@link Logger} interface, allowing users to log messages with rich metadata that can be used for filtering, formatting, or other purposes in the logging implementation.
+ */
+type LoggerMessage = PowerlinesMessage<LoggerMeta>;
+/**
+ * An internal interface representing a logger instance used within Powerlines for logging messages at various log levels, including "error", "warn", "info", "debug", and "trace". This interface defines methods for logging messages at each log level, which accept a message parameter that can be either a string or an object containing the log metadata and message content. The logger instance also includes an options property that contains the configuration options used for the logger, such as the source, command, environment, plugin, log level, and other relevant metadata. This interface is intended for internal use within Powerlines and is not meant to be implemented by users directly; instead, users can provide a custom logger that implements the {@link CustomLogger} interface to integrate with Powerlines' logging system.
+ */
+interface Logger {
+  options: LoggerOptions;
+  error: (message: string | LoggerMessage | Error) => void;
+  warn: (message: string | LoggerMessage) => void;
+  info: (message: string | LoggerMessage) => void;
+  debug: (message: string | LoggerMessage) => void;
+  trace: (message: string | LoggerMessage) => void;
+  log: (type: LogLevel, message: string | LoggerMessage) => void;
+}
+/**
+ * A type representing a log message that can be passed to a custom logger, which includes the log metadata and message content. This type is used as the parameter for the logging methods defined in the {@link CustomLogger} interface, allowing users to log messages with rich metadata that can be used for filtering, formatting, or other purposes in their custom logging implementation.
+ */
+type CustomLoggerMessage = PowerlinesMessage<Omit<LogMeta, "type">>;
+/**
+ * An interface representing a custom logger that can be provided by the user to override the default logging behavior of Powerlines. This interface defines methods for logging messages at different log levels, including "error", "warn", "info", "debug", and "trace". Each method accepts a message parameter, which can be either a string or an object containing the log metadata and message content. By implementing this interface, users can integrate their own logging system with Powerlines or customize the logging behavior to suit their specific needs.
+ */
+interface CustomLogger {
+  /**
+   * A function to log messages at the "error" level, which indicates a serious issue that has caused a failure in the build process or a critical problem that needs immediate attention.
+   *
+   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the error being reported.
+   * @returns void
+   */
+  error?: (message: CustomLoggerMessage) => void;
+  /**
+   * A function to log messages at the "warn" level, which indicates a potential issue or a situation that may require attention but does not necessarily cause a failure in the build process.
+   *
+   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the warning being reported.
+   * @returns void
+   */
+  warn?: (message: CustomLoggerMessage) => void;
+  /**
+   * A function to log messages at the "info" level, which indicates general informational messages about the build process, such as the start and completion of tasks, configuration details, or other relevant information that may be useful for monitoring the build process.
+   *
+   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the informational message being reported.
+   * @returns void
+   */
+  info?: (message: CustomLoggerMessage) => void;
+  /**
+   * A function to log messages at the "debug" level, which indicates detailed debugging information that may be useful for diagnosing issues during development or troubleshooting problems in the build process.
+   *
+   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the debug information being reported.
+   * @returns void
+   */
+  debug?: (message: CustomLoggerMessage) => void;
+  /**
+   * A function to log messages at the "trace" level, which indicates very detailed tracing information that may be useful for in-depth analysis of the build process or for tracking the flow of execution through various stages of the build.
+   *
+   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the trace information being reported.
+   * @returns void
+   */
+  trace?: (message: CustomLoggerMessage) => void;
+}
+type LogLevelUserConfig = LogLevel | RequiredKeys<Partial<Record<LogCategory, LogLevel | boolean | undefined>>, "general">;
+type LogLevelResolvedConfig = Record<LogCategory, LogLevel>;
+declare type __ΩLogLevel = any[];
+declare type __ΩLogCategory = any[];
+declare type __ΩLogMeta = any[];
+declare type __ΩLogFnOptions = any[];
+declare type __ΩLogFnMeta = any[];
+declare type __ΩLogFn = any[];
+declare type __ΩLoggerMeta = any[];
+declare type __ΩLoggerOptions = any[];
+declare type __ΩPowerlinesMessage = any[];
+declare type __ΩLogMessage = any[];
+declare type __ΩLoggerMessage = any[];
+declare type __ΩLogger = any[];
+declare type __ΩCustomLoggerMessage = any[];
+declare type __ΩCustomLogger = any[];
+declare type __ΩLogLevelUserConfig = any[];
+declare type __ΩLogLevelResolvedConfig = any[];
+//#endregion
+export { CustomLogger, CustomLoggerMessage, LogCategory, LogFn, LogFnMeta, LogFnOptions, LogLevel, LogLevelResolvedConfig, LogLevelUserConfig, LogMessage, LogMeta, Logger, LoggerMessage, LoggerMeta, LoggerOptions, PowerlinesMessage, __ΩCustomLogger, __ΩCustomLoggerMessage, __ΩLogCategory, __ΩLogFn, __ΩLogFnMeta, __ΩLogFnOptions, __ΩLogLevel, __ΩLogLevelResolvedConfig, __ΩLogLevelUserConfig, __ΩLogMessage, __ΩLogMeta, __ΩLogger, __ΩLoggerMessage, __ΩLoggerMeta, __ΩLoggerOptions, __ΩPowerlinesMessage };
+//# sourceMappingURL=logging.d.mts.map

package/dist/types/logging.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.mts","names":[],"sources":["../../src/types/logging.ts"],"mappings":";;;;;;KAuBY,QAAA,WAAmB,UAAA;AAAA,KAEnB,WAAA,WAAsB,cAAA;AAAA,UAEjB,OAAA;EAJG;;;EAQlB,KAAA;EANU;;;EAUV,IAAA,EAAM,QAAA;EAVwC;AAEhD;;EAYE,QAAA,EAAU,WAAA;EAAW;;;EAIrB,SAAA;EAJA;;;EAQA,IAAA;EAIA;;;EAAA,WAAA;EAgBA;;;EAZA,WAAA;EA0BK;;AAGP;EAzBE,OAAA;;;;EAIA,IAAA;EAyBO;;;EArBP,WAAA;EAiByB;;;EAbzB,MAAA;EAiBO;;;EAbP,MAAA;EAc6B;AAG/B;;;;EAXE,KAAA;AAAA;AAAA,KAGU,YAAA,GAAe,IAAA,CACzB,OAAA,CAAQ,OAAA;EAGR,IAAA,GAAO,IAAA;EACP,QAAA,GAAW,kBAAA;AAAA;AAAA,KAGD,SAAA,GACR,QAAA,GACA,WAAA,CAAY,OAAA;AAAA,KAEJ,KAAA,IAAS,IAAA,EAAM,SAAA,EAAW,OAAA;AAAA,KAE1B,UAAA,GAAa,WAAA,CACvB,IAAA,CAAK,OAAA;AAAA,KAIK,aAAA,GAAgB,IAAA,CAAK,UAAA;EAC/B,IAAA,GAAO,IAAA;EACP,QAAA,GAAW,kBAAA;AAAA;AAAA,UAGI,iBAAA,gBAAiC,eAAA;EAChD,IAAA,EAAM,KAAA;EACN,KAAA,GAAQ,KAAA;AAAA;AAAA,KAGE,UAAA,GAAa,iBAAA,CAAkB,OAAA,CAAQ,OAAA;AAfnD;;;AAAA,KAoBY,aAAA,GAAgB,iBAAA,CAAkB,UAAA;;;;UAK7B,MAAA;EACf,OAAA,EAAS,aAAA;EACT,KAAA,GAAQ,OAAA,WAAkB,aAAA,GAAgB,KAAA;EAC1C,IAAA,GAAO,OAAA,WAAkB,aAAA;EACzB,IAAA,GAAO,OAAA,WAAkB,aAAA;EACzB,KAAA,GAAQ,OAAA,WAAkB,aAAA;EAC1B,KAAA,GAAQ,OAAA,WAAkB,aAAA;EAC1B,GAAA,GAAM,IAAA,EAAM,QAAA,EAAU,OAAA,WAAkB,aAAA;AAAA;;;;KAM9B,mBAAA,GAAsB,iBAAA,CAAkB,IAAA,CAAK,OAAA;;;;UAKxC,YAAA;EArCf;;;;;;EA4CA,KAAA,IAAS,OAAA,EAAS,mBAAA;EAxCc;;;;;;EA+ChC,IAAA,IAAQ,OAAA,EAAS,mBAAA;EA/CgB;;;;;;EAsDjC,IAAA,IAAQ,OAAA,EAAS,mBAAA;EApDJ;AAGf;;;;;EAwDE,KAAA,IAAS,OAAA,EAAS,mBAAA;EAxDsB;;;;;;EA+DxC,KAAA,IAAS,OAAA,EAAS,mBAAA;AAAA;AAAA,KAGR,kBAAA,GACR,QAAA,GACA,YAAA,CACE,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA,KAItB,sBAAA,GAAyB,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA"}

package/dist/types/plugin.d.cts

@@ -1,8 +1,8 @@
-import { KNOWN_PLUGIN_FIELDS, PLUGIN_NON_HOOK_FIELDS } from "../constants/plugin.cjs";
-import { CommandType } from "./commands.cjs";
-import { BuilderVariant, InferUnpluginOptions, UnpluginBuilderVariant } from "./unplugin.cjs";
+import { PLUGIN_NON_HOOK_FIELDS } from "../constants/plugin.cjs";
+import { BaseCommandType } from "./api.cjs";
+import { UnpluginBuilderVariant, UnpluginOptions as UnpluginOptions$1 } from "./unplugin.cjs";
 import { BuildPluginContext, PluginContext, ResolveResult, UnresolvedContext } from "./context.cjs";
-import { EnvironmentConfig, EnvironmentResolvedConfig, PluginConfig, ResolvedConfig } from "./config.cjs";
+import { EnvironmentConfig, PluginConfig, ResolvedEnvironmentConfig } from "./config.cjs";
 import { AnyFunction, MaybePromise } from "@stryke/types/base";
 import { HookFilter, TransformResult } from "unplugin";
 import { ArrayValues } from "@stryke/types/array";
@@ -60,7 +60,7 @@ interface Hooks<TContext extends PluginContext> {
    * @param environment - The Vite-like environment object containing information about the current build environment.
    * @returns A promise that resolves when the hook is complete.
    */
-  configEnvironment: (this: TContext, name: string, environment: EnvironmentConfig) => MaybePromise<Partial<EnvironmentResolvedConfig> | undefined | null>;
+  configEnvironment: (this: TContext, name: string, environment: EnvironmentConfig) => MaybePromise<Partial<ResolvedEnvironmentConfig> | undefined | null>;
   /**
    * A hook that is called when the plugin is resolved.
    *
@@ -129,14 +129,16 @@ interface Hooks<TContext extends PluginContext> {
    */
   writeBundle: (this: TContext) => MaybePromise<void>;
 }
-type PluginHookFunctions<TContext extends PluginContext> = { [TCommandType in CommandType]: (this: TContext) => MaybePromise<void> } & Hooks<TContext>;
-type PluginHooks<TContext extends PluginContext> = { [TPluginHook in keyof PluginHookFunctions<TContext>]?: PluginHook<PluginHookFunctions<TContext>[TPluginHook]> } & {
-  transform: PluginHook<PluginHookFunctions<TContext>["transform"], "code" | "id">;
-  load: PluginHook<PluginHookFunctions<TContext>["load"], "id">;
-  resolveId: PluginHook<PluginHookFunctions<TContext>["resolveId"], "id">;
-};
+type HookFunctions<TContext extends PluginContext> = { [TCommandType in BaseCommandType]: (this: TContext) => MaybePromise<void> } & Hooks<TContext>;
 type DeepPartial$1<T> = { [K in keyof T]?: DeepPartial$1<T[K]> };
-type Plugin<TContext extends PluginContext<ResolvedConfig> = PluginContext<ResolvedConfig>> = Partial<PluginHooks<TContext>> & {
+type InferPluginHookFunction<TContext extends PluginContext, TKey extends string> = TKey extends keyof HookFunctions<TContext> ? HookFunctions<TContext>[TKey] extends AnyFunction ? PluginHook<HookFunctions<TContext>[TKey], TKey & keyof HookFilter> : HookFunctions<TContext>[TKey] extends object ? { [K in keyof HookFunctions<TContext>[TKey]]?: InferPluginHookFunction<TContext, `${TKey}:${K & string}`> } : never : never;
+type PluginHooks<TContext extends PluginContext> = { [TKey in keyof HookFunctions<TContext>]?: InferPluginHookFunction<TContext, TKey> } & {
+  types?: PluginHook<HookFunctions<TContext>["types"], never>;
+  transform?: PluginHook<HookFunctions<TContext>["transform"], "code" | "id">;
+  load?: PluginHook<HookFunctions<TContext>["load"], "id">;
+  resolveId?: PluginHook<HookFunctions<TContext>["resolveId"], "id">;
+};
+interface BasePlugin<TContext extends PluginContext> {
   /**
    * The name of the plugin, for use in deduplication, error messages and logs.
    */
@@ -174,16 +176,13 @@ type Plugin<TContext extends PluginContext<ResolvedConfig> = PluginContext<Resol
    * @returns `true` if the two plugins are the same, `false` otherwise.
    */
   dedupe?: false | ((other: Plugin<any>) => boolean);
-  /**
-   * A list of pre-requisite plugins that must be loaded before this plugin can be used.
-   */
   /**
    * Define environments where this plugin should be active. By default, the plugin is active in all environments.
    *
    * @param environment - The environment to check.
    * @returns `true` if the plugin should be active in the specified environment, `false` otherwise.
    */
-  applyToEnvironment?: (environment: EnvironmentResolvedConfig) => boolean | PluginConfig<TContext>;
+  applyToEnvironment?: (environment: ResolvedEnvironmentConfig) => boolean | PluginConfig<any>;
   /**
    * A function that returns configuration options to be merged with the build context's options.
    *
@@ -198,21 +197,21 @@ type Plugin<TContext extends PluginContext<ResolvedConfig> = PluginContext<Resol
    * @param config - The partial configuration object to be modified.
    * @returns A promise that resolves to a partial configuration object.
    */
-  config?: PluginHook<(this: UnresolvedContext<TContext["config"]>) => MaybePromise<DeepPartial$1<TContext["config"]> & Record<string, any>>> | (DeepPartial$1<TContext["config"]> & Record<string, any>);
-} & { [TBuilderVariant in BuilderVariant]?: InferUnpluginOptions<TContext, TBuilderVariant> };
-type PluginNonHookFields = ArrayValues<typeof PLUGIN_NON_HOOK_FIELDS> | UnpluginBuilderVariant;
-type PluginHookFields<TContext extends PluginContext = PluginContext> = keyof PluginHookFunctions<TContext>;
-type PluginFields = ArrayValues<typeof KNOWN_PLUGIN_FIELDS>;
+  config?: PluginHook<(this: UnresolvedContext<TContext["config"], TContext["system"]>) => MaybePromise<DeepPartial$1<TContext["config"]> & Record<string, any>>> | (DeepPartial$1<TContext["config"]> & Record<string, any>);
+}
+type Plugin<TContext extends PluginContext> = Partial<PluginHooks<TContext>> & BasePlugin<TContext> & Pick<UnpluginOptions$1<TContext>, UnpluginBuilderVariant>;
+type PluginNonHookFields = ArrayValues<typeof PLUGIN_NON_HOOK_FIELDS>;
+type PluginHookFields<TContext extends PluginContext = PluginContext, TKey extends string = string> = TKey extends ArrayValues<typeof PLUGIN_NON_HOOK_FIELDS> ? never : TKey extends keyof HookFunctions<TContext> ? HookFunctions<TContext>[TKey] extends AnyFunction ? TKey : HookFunctions<TContext>[TKey] extends object ? { [K in keyof HookFunctions<TContext>[TKey]]?: `${TKey}:${K & string}` }[keyof HookFunctions<TContext>[TKey]] : never : never;
 declare type __ΩPluginHookObject = any[];
 declare type __ΩPluginHook = any[];
 declare type __ΩTypesResult = any[];
 declare type __ΩHooks = any[];
-declare type __ΩPluginHookFunctions = any[];
+declare type __ΩHookFunctions = any[];
 declare type __ΩPluginHooks = any[];
+declare type __ΩBasePlugin = any[];
 declare type __ΩPlugin = any[];
 declare type __ΩPluginNonHookFields = any[];
 declare type __ΩPluginHookFields = any[];
-declare type __ΩPluginFields = any[];
 //#endregion
-export { Hooks, Plugin, PluginFields, PluginHook, PluginHookFields, PluginHookFunctions, PluginHookObject, PluginHooks, PluginNonHookFields, TypesResult, __ΩHooks, __ΩPlugin, __ΩPluginFields, __ΩPluginHook, __ΩPluginHookFields, __ΩPluginHookFunctions, __ΩPluginHookObject, __ΩPluginHooks, __ΩPluginNonHookFields, __ΩTypesResult };
+export { BasePlugin, HookFunctions, Hooks, Plugin, PluginHook, PluginHookFields, PluginHookObject, PluginHooks, PluginNonHookFields, TypesResult, __ΩBasePlugin, __ΩHookFunctions, __ΩHooks, __ΩPlugin, __ΩPluginHook, __ΩPluginHookFields, __ΩPluginHookObject, __ΩPluginHooks, __ΩPluginNonHookFields, __ΩTypesResult };
 //# sourceMappingURL=plugin.d.cts.map

package/dist/types/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":"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"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":"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"}

package/dist/types/plugin.d.mts

@@ -1,8 +1,8 @@
-import { KNOWN_PLUGIN_FIELDS, PLUGIN_NON_HOOK_FIELDS } from "../constants/plugin.mjs";
-import { CommandType } from "./commands.mjs";
-import { BuilderVariant, InferUnpluginOptions, UnpluginBuilderVariant } from "./unplugin.mjs";
+import { PLUGIN_NON_HOOK_FIELDS } from "../constants/plugin.mjs";
+import { BaseCommandType } from "./api.mjs";
+import { UnpluginBuilderVariant, UnpluginOptions as UnpluginOptions$1 } from "./unplugin.mjs";
 import { BuildPluginContext, PluginContext, ResolveResult, UnresolvedContext } from "./context.mjs";
-import { EnvironmentConfig, EnvironmentResolvedConfig, PluginConfig, ResolvedConfig } from "./config.mjs";
+import { EnvironmentConfig, PluginConfig, ResolvedEnvironmentConfig } from "./config.mjs";
 import { HookFilter, TransformResult } from "unplugin";
 import { AnyFunction, MaybePromise } from "@stryke/types/base";
 import { ArrayValues } from "@stryke/types/array";
@@ -60,7 +60,7 @@ interface Hooks<TContext extends PluginContext> {
    * @param environment - The Vite-like environment object containing information about the current build environment.
    * @returns A promise that resolves when the hook is complete.
    */
-  configEnvironment: (this: TContext, name: string, environment: EnvironmentConfig) => MaybePromise<Partial<EnvironmentResolvedConfig> | undefined | null>;
+  configEnvironment: (this: TContext, name: string, environment: EnvironmentConfig) => MaybePromise<Partial<ResolvedEnvironmentConfig> | undefined | null>;
   /**
    * A hook that is called when the plugin is resolved.
    *
@@ -129,14 +129,16 @@ interface Hooks<TContext extends PluginContext> {
    */
   writeBundle: (this: TContext) => MaybePromise<void>;
 }
-type PluginHookFunctions<TContext extends PluginContext> = { [TCommandType in CommandType]: (this: TContext) => MaybePromise<void> } & Hooks<TContext>;
-type PluginHooks<TContext extends PluginContext> = { [TPluginHook in keyof PluginHookFunctions<TContext>]?: PluginHook<PluginHookFunctions<TContext>[TPluginHook]> } & {
-  transform: PluginHook<PluginHookFunctions<TContext>["transform"], "code" | "id">;
-  load: PluginHook<PluginHookFunctions<TContext>["load"], "id">;
-  resolveId: PluginHook<PluginHookFunctions<TContext>["resolveId"], "id">;
-};
+type HookFunctions<TContext extends PluginContext> = { [TCommandType in BaseCommandType]: (this: TContext) => MaybePromise<void> } & Hooks<TContext>;
 type DeepPartial$1<T> = { [K in keyof T]?: DeepPartial$1<T[K]> };
-type Plugin<TContext extends PluginContext<ResolvedConfig> = PluginContext<ResolvedConfig>> = Partial<PluginHooks<TContext>> & {
+type InferPluginHookFunction<TContext extends PluginContext, TKey extends string> = TKey extends keyof HookFunctions<TContext> ? HookFunctions<TContext>[TKey] extends AnyFunction ? PluginHook<HookFunctions<TContext>[TKey], TKey & keyof HookFilter> : HookFunctions<TContext>[TKey] extends object ? { [K in keyof HookFunctions<TContext>[TKey]]?: InferPluginHookFunction<TContext, `${TKey}:${K & string}`> } : never : never;
+type PluginHooks<TContext extends PluginContext> = { [TKey in keyof HookFunctions<TContext>]?: InferPluginHookFunction<TContext, TKey> } & {
+  types?: PluginHook<HookFunctions<TContext>["types"], never>;
+  transform?: PluginHook<HookFunctions<TContext>["transform"], "code" | "id">;
+  load?: PluginHook<HookFunctions<TContext>["load"], "id">;
+  resolveId?: PluginHook<HookFunctions<TContext>["resolveId"], "id">;
+};
+interface BasePlugin<TContext extends PluginContext> {
   /**
    * The name of the plugin, for use in deduplication, error messages and logs.
    */
@@ -174,16 +176,13 @@ type Plugin<TContext extends PluginContext<ResolvedConfig> = PluginContext<Resol
    * @returns `true` if the two plugins are the same, `false` otherwise.
    */
   dedupe?: false | ((other: Plugin<any>) => boolean);
-  /**
-   * A list of pre-requisite plugins that must be loaded before this plugin can be used.
-   */
   /**
    * Define environments where this plugin should be active. By default, the plugin is active in all environments.
    *
    * @param environment - The environment to check.
    * @returns `true` if the plugin should be active in the specified environment, `false` otherwise.
    */
-  applyToEnvironment?: (environment: EnvironmentResolvedConfig) => boolean | PluginConfig<TContext>;
+  applyToEnvironment?: (environment: ResolvedEnvironmentConfig) => boolean | PluginConfig<any>;
   /**
    * A function that returns configuration options to be merged with the build context's options.
    *
@@ -198,21 +197,21 @@ type Plugin<TContext extends PluginContext<ResolvedConfig> = PluginContext<Resol
    * @param config - The partial configuration object to be modified.
    * @returns A promise that resolves to a partial configuration object.
    */
-  config?: PluginHook<(this: UnresolvedContext<TContext["config"]>) => MaybePromise<DeepPartial$1<TContext["config"]> & Record<string, any>>> | (DeepPartial$1<TContext["config"]> & Record<string, any>);
-} & { [TBuilderVariant in BuilderVariant]?: InferUnpluginOptions<TContext, TBuilderVariant> };
-type PluginNonHookFields = ArrayValues<typeof PLUGIN_NON_HOOK_FIELDS> | UnpluginBuilderVariant;
-type PluginHookFields<TContext extends PluginContext = PluginContext> = keyof PluginHookFunctions<TContext>;
-type PluginFields = ArrayValues<typeof KNOWN_PLUGIN_FIELDS>;
+  config?: PluginHook<(this: UnresolvedContext<TContext["config"], TContext["system"]>) => MaybePromise<DeepPartial$1<TContext["config"]> & Record<string, any>>> | (DeepPartial$1<TContext["config"]> & Record<string, any>);
+}
+type Plugin<TContext extends PluginContext> = Partial<PluginHooks<TContext>> & BasePlugin<TContext> & Pick<UnpluginOptions$1<TContext>, UnpluginBuilderVariant>;
+type PluginNonHookFields = ArrayValues<typeof PLUGIN_NON_HOOK_FIELDS>;
+type PluginHookFields<TContext extends PluginContext = PluginContext, TKey extends string = string> = TKey extends ArrayValues<typeof PLUGIN_NON_HOOK_FIELDS> ? never : TKey extends keyof HookFunctions<TContext> ? HookFunctions<TContext>[TKey] extends AnyFunction ? TKey : HookFunctions<TContext>[TKey] extends object ? { [K in keyof HookFunctions<TContext>[TKey]]?: `${TKey}:${K & string}` }[keyof HookFunctions<TContext>[TKey]] : never : never;
 declare type __ΩPluginHookObject = any[];
 declare type __ΩPluginHook = any[];
 declare type __ΩTypesResult = any[];
 declare type __ΩHooks = any[];
-declare type __ΩPluginHookFunctions = any[];
+declare type __ΩHookFunctions = any[];
 declare type __ΩPluginHooks = any[];
+declare type __ΩBasePlugin = any[];
 declare type __ΩPlugin = any[];
 declare type __ΩPluginNonHookFields = any[];
 declare type __ΩPluginHookFields = any[];
-declare type __ΩPluginFields = any[];
 //#endregion
-export { Hooks, Plugin, PluginFields, PluginHook, PluginHookFields, PluginHookFunctions, PluginHookObject, PluginHooks, PluginNonHookFields, TypesResult, __ΩHooks, __ΩPlugin, __ΩPluginFields, __ΩPluginHook, __ΩPluginHookFields, __ΩPluginHookFunctions, __ΩPluginHookObject, __ΩPluginHooks, __ΩPluginNonHookFields, __ΩTypesResult };
+export { BasePlugin, HookFunctions, Hooks, Plugin, PluginHook, PluginHookFields, PluginHookObject, PluginHooks, PluginNonHookFields, TypesResult, __ΩBasePlugin, __ΩHookFunctions, __ΩHooks, __ΩPlugin, __ΩPluginHook, __ΩPluginHookFields, __ΩPluginHookObject, __ΩPluginHooks, __ΩPluginNonHookFields, __ΩTypesResult };
 //# sourceMappingURL=plugin.d.mts.map

package/dist/types/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":"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"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":"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"}