@pikacss/core 0.0.32 → 0.0.34

package/dist/index.cjs

@@ -5,15 +5,48 @@ const ATOMIC_STYLE_ID_PLACEHOLDER_RE_GLOBAL = /%/g;
 
 //#endregion
 //#region src/internal/utils.ts
-let _warn = (...args) => {
-	console.warn("[@pikacss/core]", ...args);
-};
-function setWarnFn(fn) {
-	_warn = fn;
-}
-function warn(...args) {
-	_warn(...args);
+function createLogger(prefix) {
+	let currentPrefix = prefix;
+	let enabledDebug = false;
+	let _debug = console.log;
+	let _info = console.log;
+	let _warn = console.warn;
+	let _error = console.error;
+	return {
+		debug: (...args) => {
+			if (!enabledDebug) return;
+			_debug(`${currentPrefix}[DEBUG]`, ...args);
+		},
+		info: (...args) => {
+			_info(`${currentPrefix}[INFO]`, ...args);
+		},
+		warn: (...args) => {
+			_warn(`${currentPrefix}[WARN]`, ...args);
+		},
+		error: (...args) => {
+			_error(`${currentPrefix}[ERROR]`, ...args);
+		},
+		toggleDebug() {
+			enabledDebug = !enabledDebug;
+		},
+		setPrefix(newPrefix) {
+			currentPrefix = newPrefix;
+		},
+		setDebugFn(fn) {
+			_debug = fn;
+		},
+		setInfoFn(fn) {
+			_info = fn;
+		},
+		setWarnFn(fn) {
+			_warn = fn;
+		},
+		setErrorFn(fn) {
+			_error = fn;
+		}
+	};
 }
+const log = createLogger("[PikaCSS]");
 const chars = [..."abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"];
 const numOfChars = chars.length;
 function numberToChars(num) {
@@ -150,27 +183,35 @@ function createExtractFn(options) {
 //#endregion
 //#region src/internal/plugin.ts
 async function execAsyncHook(plugins, hook, payload) {
+	log.debug(`Executing async hook: ${hook}`);
 	for (const plugin of plugins) {
 		if (plugin[hook] == null) continue;
 		try {
+			log.debug(`  - Plugin "${plugin.name}" executing ${hook}`);
 			const newPayload = await plugin[hook](payload);
 			if (newPayload != null) payload = newPayload;
+			log.debug(`  - Plugin "${plugin.name}" completed ${hook}`);
 		} catch (error) {
-			warn(`Plugin "${plugin.name}" failed to execute hook "${hook}": ${error.message}`, error);
+			log.error(`Plugin "${plugin.name}" failed to execute hook "${hook}": ${error.message}`, error);
 		}
 	}
+	log.debug(`Async hook "${hook}" completed`);
 	return payload;
 }
 function execSyncHook(plugins, hook, payload) {
+	log.debug(`Executing sync hook: ${hook}`);
 	for (const plugin of plugins) {
 		if (plugin[hook] == null) continue;
 		try {
+			log.debug(`  - Plugin "${plugin.name}" executing ${hook}`);
 			const newPayload = plugin[hook](payload);
 			if (newPayload != null) payload = newPayload;
+			log.debug(`  - Plugin "${plugin.name}" completed ${hook}`);
 		} catch (error) {
-			warn(`Plugin "${plugin.name}" failed to execute hook "${hook}": ${error.message}`, error);
+			log.error(`Plugin "${plugin.name}" failed to execute hook "${hook}": ${error.message}`, error);
 		}
 	}
+	log.debug(`Sync hook "${hook}" completed`);
 	return payload;
 }
 const hooks = {
@@ -324,33 +365,48 @@ var AbstractResolver = class {
 		return [...this.dynamicRulesMap.values()];
 	}
 	addStaticRule(rule) {
+		log.debug(`Adding static rule: ${rule.key}`);
 		this.staticRulesMap.set(rule.key, rule);
 		return this;
 	}
 	removeStaticRule(key) {
 		const rule = this.staticRulesMap.get(key);
-		if (rule == null) return this;
+		if (rule == null) {
+			log.warn(`Static rule not found for removal: ${key}`);
+			return this;
+		}
+		log.debug(`Removing static rule: ${key}`);
 		this.staticRulesMap.delete(key);
 		this._resolvedResultsMap.delete(rule.string);
 		return this;
 	}
 	addDynamicRule(rule) {
+		log.debug(`Adding dynamic rule: ${rule.key}`);
 		this.dynamicRulesMap.set(rule.key, rule);
 		return this;
 	}
 	removeDynamicRule(key) {
 		const rule = this.dynamicRulesMap.get(key);
-		if (rule == null) return this;
+		if (rule == null) {
+			log.warn(`Dynamic rule not found for removal: ${key}`);
+			return this;
+		}
+		log.debug(`Removing dynamic rule: ${key}`);
 		const matchedResolvedStringList = Array.from(this._resolvedResultsMap.keys()).filter((string) => rule.stringPattern.test(string));
 		this.dynamicRulesMap.delete(key);
 		matchedResolvedStringList.forEach((string) => this._resolvedResultsMap.delete(string));
+		log.debug(`  - Cleared ${matchedResolvedStringList.length} cached results`);
 		return this;
 	}
 	async _resolve(string) {
 		const existedResult = this._resolvedResultsMap.get(string);
-		if (existedResult != null) return existedResult;
+		if (existedResult != null) {
+			log.debug(`Resolved from cache: ${string}`);
+			return existedResult;
+		}
 		const staticRule = Array.from(this.staticRulesMap.values()).find((rule) => rule.string === string);
 		if (staticRule != null) {
+			log.debug(`Resolved by static rule: ${staticRule.key}`);
 			const resolvedResult = { value: staticRule.resolved };
 			this._resolvedResultsMap.set(string, resolvedResult);
 			this.onResolved(string, "static", resolvedResult);
@@ -366,11 +422,13 @@ var AbstractResolver = class {
 			}
 		}
 		if (dynamicRule != null && matched != null) {
+			log.debug(`Resolved by dynamic rule: ${dynamicRule.key}`);
 			const resolvedResult = { value: await dynamicRule.createResolved(matched) };
 			this._resolvedResultsMap.set(string, resolvedResult);
 			this.onResolved(string, "dynamic", resolvedResult);
 			return resolvedResult;
 		}
+		log.debug(`Resolution failed for: ${string}`);
 	}
 	_setResolvedResult(string, resolved) {
 		const resolvedResult = this._resolvedResultsMap.get(string);
@@ -425,7 +483,7 @@ function selectors() {
 var SelectorResolver = class extends AbstractResolver {
 	async resolve(selector) {
 		const resolved = await this._resolve(selector).catch((error) => {
-			warn(`Failed to resolve selector "${selector}": ${error.message}`, error);
+			log.warn(`Failed to resolve selector "${selector}": ${error.message}`, error);
 		});
 		if (resolved == null) return [selector];
 		const result = [];
@@ -548,7 +606,7 @@ function shortcuts() {
 var ShortcutResolver = class extends AbstractResolver {
 	async resolve(shortcut) {
 		const resolved = await this._resolve(shortcut).catch((error) => {
-			warn(`Failed to resolve shortcut "${shortcut}": ${error.message}`, error);
+			log.warn(`Failed to resolve shortcut "${shortcut}": ${error.message}`, error);
 		});
 		if (resolved == null) return [shortcut];
 		const result = [];
@@ -702,19 +760,27 @@ function defineEngineConfig(config) {
 }
 /* c8 ignore end */
 async function createEngine(config = {}) {
-	config.plugins = resolvePlugins([...[
+	log.debug("Creating engine with config:", config);
+	const corePlugins = [
 		important(),
 		variables(),
 		keyframes(),
 		selectors(),
 		shortcuts()
-	], ...config.plugins || []]);
+	];
+	log.debug("Core plugins loaded:", corePlugins.length);
+	const plugins = resolvePlugins([...corePlugins, ...config.plugins || []]);
+	config.plugins = plugins;
+	log.debug(`Total plugins resolved: ${plugins.length}`);
 	config = await hooks.configureRawConfig(config.plugins, config);
 	hooks.rawConfigConfigured(resolvePlugins(config.plugins || []), config);
 	let resolvedConfig = await resolveEngineConfig(config);
+	log.debug("Engine config resolved with prefix:", resolvedConfig.prefix);
 	resolvedConfig = await hooks.configureResolvedConfig(resolvedConfig.plugins, resolvedConfig);
 	let engine = new Engine(resolvedConfig);
+	log.debug("Engine instance created");
 	engine = await hooks.configureEngine(engine.config.plugins, engine);
+	log.debug("Engine initialized successfully");
 	return engine;
 }
 var Engine = class {
@@ -766,10 +832,13 @@ var Engine = class {
 		this.notifyAutocompleteConfigUpdated();
 	}
 	addPreflight(preflight) {
+		log.debug("Adding preflight");
 		this.config.preflights.push(resolvePreflight(preflight));
+		log.debug(`Total preflights: ${this.config.preflights.length}`);
 		this.notifyPreflightUpdated();
 	}
 	async use(...itemList) {
+		log.debug(`Processing ${itemList.length} style items`);
 		const { unknown, contents } = await resolveStyleItemList({
 			itemList,
 			transformStyleItems: (styleItems) => hooks.transformStyleItems(this.config.plugins, styleItems),
@@ -789,14 +858,17 @@ var Engine = class {
 					content
 				};
 				this.store.atomicStyles.set(id, atomicStyle);
+				log.debug(`Atomic style added: ${id}`);
 				this.notifyAtomicStyleAdded(atomicStyle);
 			}
 		});
+		log.debug(`Resolved ${resolvedIds.length} atomic styles, ${unknown.size} unknown items`);
 		return [...unknown, ...resolvedIds];
 	}
 	async renderPreflights(isFormatted) {
+		log.debug("Rendering preflights...");
 		const lineEnd = isFormatted ? "\n" : "";
-		return (await Promise.all(this.config.preflights.map(async (p) => {
+		const results = await Promise.all(this.config.preflights.map(async (p) => {
 			const result = await p(this, isFormatted);
 			if (typeof result === "string") return result;
 			return renderPreflightDefinition({
@@ -804,12 +876,17 @@ var Engine = class {
 				preflightDefinition: result,
 				isFormatted
 			});
-		}))).join(lineEnd);
+		}));
+		log.debug(`Rendered ${results.length} preflights`);
+		return results.join(lineEnd);
 	}
 	async renderAtomicStyles(isFormatted, options = {}) {
+		log.debug("Rendering atomic styles...");
 		const { atomicStyleIds = null, isPreview = false } = options;
+		const atomicStyles = atomicStyleIds == null ? [...this.store.atomicStyles.values()] : atomicStyleIds.map((id) => this.store.atomicStyles.get(id)).filter(isNotNullish);
+		log.debug(`Rendering ${atomicStyles.length} atomic styles (preview: ${isPreview})`);
 		return renderAtomicStyles({
-			atomicStyles: atomicStyleIds == null ? [...this.store.atomicStyles.values()] : atomicStyleIds.map((id) => this.store.atomicStyles.get(id)).filter(isNotNullish),
+			atomicStyles,
 			isPreview,
 			isFormatted,
 			defaultSelector: this.config.defaultSelector
@@ -825,6 +902,7 @@ function resolvePreflight(preflight) {
 }
 async function resolveEngineConfig(config) {
 	const { prefix = "", defaultSelector = `.${ATOMIC_STYLE_ID_PLACEHOLDER}`, plugins = [], preflights = [] } = config;
+	log.debug(`Resolving engine config with prefix: "${prefix}", plugins: ${plugins.length}, preflights: ${preflights.length}`);
 	const resolvedConfig = {
 		rawConfig: config,
 		plugins: resolvePlugins(plugins),
@@ -842,6 +920,7 @@ async function resolveEngineConfig(config) {
 	};
 	const resolvedPreflights = preflights.map(resolvePreflight);
 	resolvedConfig.preflights.push(...resolvedPreflights);
+	log.debug(`Engine config resolved: ${resolvedPreflights.length} preflights processed`);
 	return resolvedConfig;
 }
 function getAtomicStyleId({ content, prefix, stored }) {
@@ -851,10 +930,14 @@ function getAtomicStyleId({ content, prefix, stored }) {
 		content.value
 	]);
 	const cached = stored.get(key);
-	if (cached != null) return cached;
+	if (cached != null) {
+		log.debug(`Atomic style cached: ${cached}`);
+		return cached;
+	}
 	const num = stored.size;
 	const id = `${prefix}${numberToChars(num)}`;
 	stored.set(key, id);
+	log.debug(`Generated new atomic style ID: ${id}`);
 	return id;
 }
 function optimizeAtomicStyleContents(list) {
@@ -961,8 +1044,8 @@ exports.appendAutocompletePropertyValues = appendAutocompletePropertyValues;
 exports.appendAutocompleteSelectors = appendAutocompleteSelectors;
 exports.appendAutocompleteStyleItemStrings = appendAutocompleteStyleItemStrings;
 exports.createEngine = createEngine;
+exports.createLogger = createLogger;
 exports.defineEngineConfig = defineEngineConfig;
 exports.defineEnginePlugin = defineEnginePlugin;
-exports.renderCSSStyleBlocks = renderCSSStyleBlocks;
-exports.setWarnFn = setWarnFn;
-exports.warn = warn;
+exports.log = log;
+exports.renderCSSStyleBlocks = renderCSSStyleBlocks;

package/dist/index.d.cts

@@ -512,8 +512,30 @@ declare class Engine {
 }
 //#endregion
 //#region src/internal/utils.d.ts
-declare function setWarnFn(fn: (...args: any[]) => void): void;
-declare function warn(...args: any[]): void;
+declare function createLogger(prefix: string): {
+  debug: (...args: any[]) => void;
+  info: (...args: any[]) => void;
+  warn: (...args: any[]) => void;
+  error: (...args: any[]) => void;
+  toggleDebug: () => void;
+  setPrefix: (newPrefix: string) => void;
+  setDebugFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+  setInfoFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+  setWarnFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+  setErrorFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+};
+declare const log: {
+  debug: (...args: any[]) => void;
+  info: (...args: any[]) => void;
+  warn: (...args: any[]) => void;
+  error: (...args: any[]) => void;
+  toggleDebug: () => void;
+  setPrefix: (newPrefix: string) => void;
+  setDebugFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+  setInfoFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+  setWarnFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+  setErrorFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+};
 declare function appendAutocompleteSelectors(config: Pick<ResolvedEngineConfig, 'autocomplete'>, ...selectors: string[]): void;
 declare function appendAutocompleteStyleItemStrings(config: Pick<ResolvedEngineConfig, 'autocomplete'>, ...styleItemStrings: string[]): void;
 declare function appendAutocompleteExtraProperties(config: Pick<ResolvedEngineConfig, 'autocomplete'>, ...properties: string[]): void;
@@ -538,4 +560,4 @@ type MakeStyleDefinition<MaxDepth extends number, Tuple extends any[] = []> = Tu
 type StyleDefinition = MakeStyleDefinition<5>;
 type StyleItem = UnionString | ResolvedAutocomplete['StyleItemString'] | StyleDefinition;
 //#endregion
-export { Arrayable, Awaitable, type CSSProperty, type CSSSelectors, type CSSStyleBlockBody, type CSSStyleBlocks, type DefineAutocomplete, type Engine, type EngineConfig, type EnginePlugin, FromKebab, GetValue, IsEqual, IsNever, Nullish, type PikaAugment, type Properties, ResolveFrom, Simplify, type StyleDefinition, type StyleItem, ToKebab, UnionNumber, UnionString, UnionToIntersection, appendAutocompleteCssPropertyValues, appendAutocompleteExtraCssProperties, appendAutocompleteExtraProperties, appendAutocompletePropertyValues, appendAutocompleteSelectors, appendAutocompleteStyleItemStrings, createEngine, defineEngineConfig, defineEnginePlugin, renderCSSStyleBlocks, setWarnFn, warn };
+export { Arrayable, Awaitable, type CSSProperty, type CSSSelectors, type CSSStyleBlockBody, type CSSStyleBlocks, type DefineAutocomplete, type Engine, type EngineConfig, type EnginePlugin, FromKebab, GetValue, IsEqual, IsNever, Nullish, type PikaAugment, type Properties, ResolveFrom, Simplify, type StyleDefinition, type StyleItem, ToKebab, UnionNumber, UnionString, UnionToIntersection, appendAutocompleteCssPropertyValues, appendAutocompleteExtraCssProperties, appendAutocompleteExtraProperties, appendAutocompletePropertyValues, appendAutocompleteSelectors, appendAutocompleteStyleItemStrings, createEngine, createLogger, defineEngineConfig, defineEnginePlugin, log, renderCSSStyleBlocks };

package/dist/index.d.mts

@@ -512,8 +512,30 @@ declare class Engine {
 }
 //#endregion
 //#region src/internal/utils.d.ts
-declare function setWarnFn(fn: (...args: any[]) => void): void;
-declare function warn(...args: any[]): void;
+declare function createLogger(prefix: string): {
+  debug: (...args: any[]) => void;
+  info: (...args: any[]) => void;
+  warn: (...args: any[]) => void;
+  error: (...args: any[]) => void;
+  toggleDebug: () => void;
+  setPrefix: (newPrefix: string) => void;
+  setDebugFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+  setInfoFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+  setWarnFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+  setErrorFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+};
+declare const log: {
+  debug: (...args: any[]) => void;
+  info: (...args: any[]) => void;
+  warn: (...args: any[]) => void;
+  error: (...args: any[]) => void;
+  toggleDebug: () => void;
+  setPrefix: (newPrefix: string) => void;
+  setDebugFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+  setInfoFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+  setWarnFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+  setErrorFn: (fn: (prefix: string, ...args: any[]) => void) => void;
+};
 declare function appendAutocompleteSelectors(config: Pick<ResolvedEngineConfig, 'autocomplete'>, ...selectors: string[]): void;
 declare function appendAutocompleteStyleItemStrings(config: Pick<ResolvedEngineConfig, 'autocomplete'>, ...styleItemStrings: string[]): void;
 declare function appendAutocompleteExtraProperties(config: Pick<ResolvedEngineConfig, 'autocomplete'>, ...properties: string[]): void;
@@ -538,4 +560,4 @@ type MakeStyleDefinition<MaxDepth extends number, Tuple extends any[] = []> = Tu
 type StyleDefinition = MakeStyleDefinition<5>;
 type StyleItem = UnionString | ResolvedAutocomplete['StyleItemString'] | StyleDefinition;
 //#endregion
-export { Arrayable, Awaitable, type CSSProperty, type CSSSelectors, type CSSStyleBlockBody, type CSSStyleBlocks, type DefineAutocomplete, type Engine, type EngineConfig, type EnginePlugin, FromKebab, GetValue, IsEqual, IsNever, Nullish, type PikaAugment, type Properties, ResolveFrom, Simplify, type StyleDefinition, type StyleItem, ToKebab, UnionNumber, UnionString, UnionToIntersection, appendAutocompleteCssPropertyValues, appendAutocompleteExtraCssProperties, appendAutocompleteExtraProperties, appendAutocompletePropertyValues, appendAutocompleteSelectors, appendAutocompleteStyleItemStrings, createEngine, defineEngineConfig, defineEnginePlugin, renderCSSStyleBlocks, setWarnFn, warn };
+export { Arrayable, Awaitable, type CSSProperty, type CSSSelectors, type CSSStyleBlockBody, type CSSStyleBlocks, type DefineAutocomplete, type Engine, type EngineConfig, type EnginePlugin, FromKebab, GetValue, IsEqual, IsNever, Nullish, type PikaAugment, type Properties, ResolveFrom, Simplify, type StyleDefinition, type StyleItem, ToKebab, UnionNumber, UnionString, UnionToIntersection, appendAutocompleteCssPropertyValues, appendAutocompleteExtraCssProperties, appendAutocompleteExtraProperties, appendAutocompletePropertyValues, appendAutocompleteSelectors, appendAutocompleteStyleItemStrings, createEngine, createLogger, defineEngineConfig, defineEnginePlugin, log, renderCSSStyleBlocks };

package/dist/index.mjs

@@ -4,15 +4,48 @@ const ATOMIC_STYLE_ID_PLACEHOLDER_RE_GLOBAL = /%/g;
 
 //#endregion
 //#region src/internal/utils.ts
-let _warn = (...args) => {
-	console.warn("[@pikacss/core]", ...args);
-};
-function setWarnFn(fn) {
-	_warn = fn;
-}
-function warn(...args) {
-	_warn(...args);
+function createLogger(prefix) {
+	let currentPrefix = prefix;
+	let enabledDebug = false;
+	let _debug = console.log;
+	let _info = console.log;
+	let _warn = console.warn;
+	let _error = console.error;
+	return {
+		debug: (...args) => {
+			if (!enabledDebug) return;
+			_debug(`${currentPrefix}[DEBUG]`, ...args);
+		},
+		info: (...args) => {
+			_info(`${currentPrefix}[INFO]`, ...args);
+		},
+		warn: (...args) => {
+			_warn(`${currentPrefix}[WARN]`, ...args);
+		},
+		error: (...args) => {
+			_error(`${currentPrefix}[ERROR]`, ...args);
+		},
+		toggleDebug() {
+			enabledDebug = !enabledDebug;
+		},
+		setPrefix(newPrefix) {
+			currentPrefix = newPrefix;
+		},
+		setDebugFn(fn) {
+			_debug = fn;
+		},
+		setInfoFn(fn) {
+			_info = fn;
+		},
+		setWarnFn(fn) {
+			_warn = fn;
+		},
+		setErrorFn(fn) {
+			_error = fn;
+		}
+	};
 }
+const log = createLogger("[PikaCSS]");
 const chars = [..."abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"];
 const numOfChars = chars.length;
 function numberToChars(num) {
@@ -149,27 +182,35 @@ function createExtractFn(options) {
 //#endregion
 //#region src/internal/plugin.ts
 async function execAsyncHook(plugins, hook, payload) {
+	log.debug(`Executing async hook: ${hook}`);
 	for (const plugin of plugins) {
 		if (plugin[hook] == null) continue;
 		try {
+			log.debug(`  - Plugin "${plugin.name}" executing ${hook}`);
 			const newPayload = await plugin[hook](payload);
 			if (newPayload != null) payload = newPayload;
+			log.debug(`  - Plugin "${plugin.name}" completed ${hook}`);
 		} catch (error) {
-			warn(`Plugin "${plugin.name}" failed to execute hook "${hook}": ${error.message}`, error);
+			log.error(`Plugin "${plugin.name}" failed to execute hook "${hook}": ${error.message}`, error);
 		}
 	}
+	log.debug(`Async hook "${hook}" completed`);
 	return payload;
 }
 function execSyncHook(plugins, hook, payload) {
+	log.debug(`Executing sync hook: ${hook}`);
 	for (const plugin of plugins) {
 		if (plugin[hook] == null) continue;
 		try {
+			log.debug(`  - Plugin "${plugin.name}" executing ${hook}`);
 			const newPayload = plugin[hook](payload);
 			if (newPayload != null) payload = newPayload;
+			log.debug(`  - Plugin "${plugin.name}" completed ${hook}`);
 		} catch (error) {
-			warn(`Plugin "${plugin.name}" failed to execute hook "${hook}": ${error.message}`, error);
+			log.error(`Plugin "${plugin.name}" failed to execute hook "${hook}": ${error.message}`, error);
 		}
 	}
+	log.debug(`Sync hook "${hook}" completed`);
 	return payload;
 }
 const hooks = {
@@ -323,33 +364,48 @@ var AbstractResolver = class {
 		return [...this.dynamicRulesMap.values()];
 	}
 	addStaticRule(rule) {
+		log.debug(`Adding static rule: ${rule.key}`);
 		this.staticRulesMap.set(rule.key, rule);
 		return this;
 	}
 	removeStaticRule(key) {
 		const rule = this.staticRulesMap.get(key);
-		if (rule == null) return this;
+		if (rule == null) {
+			log.warn(`Static rule not found for removal: ${key}`);
+			return this;
+		}
+		log.debug(`Removing static rule: ${key}`);
 		this.staticRulesMap.delete(key);
 		this._resolvedResultsMap.delete(rule.string);
 		return this;
 	}
 	addDynamicRule(rule) {
+		log.debug(`Adding dynamic rule: ${rule.key}`);
 		this.dynamicRulesMap.set(rule.key, rule);
 		return this;
 	}
 	removeDynamicRule(key) {
 		const rule = this.dynamicRulesMap.get(key);
-		if (rule == null) return this;
+		if (rule == null) {
+			log.warn(`Dynamic rule not found for removal: ${key}`);
+			return this;
+		}
+		log.debug(`Removing dynamic rule: ${key}`);
 		const matchedResolvedStringList = Array.from(this._resolvedResultsMap.keys()).filter((string) => rule.stringPattern.test(string));
 		this.dynamicRulesMap.delete(key);
 		matchedResolvedStringList.forEach((string) => this._resolvedResultsMap.delete(string));
+		log.debug(`  - Cleared ${matchedResolvedStringList.length} cached results`);
 		return this;
 	}
 	async _resolve(string) {
 		const existedResult = this._resolvedResultsMap.get(string);
-		if (existedResult != null) return existedResult;
+		if (existedResult != null) {
+			log.debug(`Resolved from cache: ${string}`);
+			return existedResult;
+		}
 		const staticRule = Array.from(this.staticRulesMap.values()).find((rule) => rule.string === string);
 		if (staticRule != null) {
+			log.debug(`Resolved by static rule: ${staticRule.key}`);
 			const resolvedResult = { value: staticRule.resolved };
 			this._resolvedResultsMap.set(string, resolvedResult);
 			this.onResolved(string, "static", resolvedResult);
@@ -365,11 +421,13 @@ var AbstractResolver = class {
 			}
 		}
 		if (dynamicRule != null && matched != null) {
+			log.debug(`Resolved by dynamic rule: ${dynamicRule.key}`);
 			const resolvedResult = { value: await dynamicRule.createResolved(matched) };
 			this._resolvedResultsMap.set(string, resolvedResult);
 			this.onResolved(string, "dynamic", resolvedResult);
 			return resolvedResult;
 		}
+		log.debug(`Resolution failed for: ${string}`);
 	}
 	_setResolvedResult(string, resolved) {
 		const resolvedResult = this._resolvedResultsMap.get(string);
@@ -424,7 +482,7 @@ function selectors() {
 var SelectorResolver = class extends AbstractResolver {
 	async resolve(selector) {
 		const resolved = await this._resolve(selector).catch((error) => {
-			warn(`Failed to resolve selector "${selector}": ${error.message}`, error);
+			log.warn(`Failed to resolve selector "${selector}": ${error.message}`, error);
 		});
 		if (resolved == null) return [selector];
 		const result = [];
@@ -547,7 +605,7 @@ function shortcuts() {
 var ShortcutResolver = class extends AbstractResolver {
 	async resolve(shortcut) {
 		const resolved = await this._resolve(shortcut).catch((error) => {
-			warn(`Failed to resolve shortcut "${shortcut}": ${error.message}`, error);
+			log.warn(`Failed to resolve shortcut "${shortcut}": ${error.message}`, error);
 		});
 		if (resolved == null) return [shortcut];
 		const result = [];
@@ -701,19 +759,27 @@ function defineEngineConfig(config) {
 }
 /* c8 ignore end */
 async function createEngine(config = {}) {
-	config.plugins = resolvePlugins([...[
+	log.debug("Creating engine with config:", config);
+	const corePlugins = [
 		important(),
 		variables(),
 		keyframes(),
 		selectors(),
 		shortcuts()
-	], ...config.plugins || []]);
+	];
+	log.debug("Core plugins loaded:", corePlugins.length);
+	const plugins = resolvePlugins([...corePlugins, ...config.plugins || []]);
+	config.plugins = plugins;
+	log.debug(`Total plugins resolved: ${plugins.length}`);
 	config = await hooks.configureRawConfig(config.plugins, config);
 	hooks.rawConfigConfigured(resolvePlugins(config.plugins || []), config);
 	let resolvedConfig = await resolveEngineConfig(config);
+	log.debug("Engine config resolved with prefix:", resolvedConfig.prefix);
 	resolvedConfig = await hooks.configureResolvedConfig(resolvedConfig.plugins, resolvedConfig);
 	let engine = new Engine(resolvedConfig);
+	log.debug("Engine instance created");
 	engine = await hooks.configureEngine(engine.config.plugins, engine);
+	log.debug("Engine initialized successfully");
 	return engine;
 }
 var Engine = class {
@@ -765,10 +831,13 @@ var Engine = class {
 		this.notifyAutocompleteConfigUpdated();
 	}
 	addPreflight(preflight) {
+		log.debug("Adding preflight");
 		this.config.preflights.push(resolvePreflight(preflight));
+		log.debug(`Total preflights: ${this.config.preflights.length}`);
 		this.notifyPreflightUpdated();
 	}
 	async use(...itemList) {
+		log.debug(`Processing ${itemList.length} style items`);
 		const { unknown, contents } = await resolveStyleItemList({
 			itemList,
 			transformStyleItems: (styleItems) => hooks.transformStyleItems(this.config.plugins, styleItems),
@@ -788,14 +857,17 @@ var Engine = class {
 					content
 				};
 				this.store.atomicStyles.set(id, atomicStyle);
+				log.debug(`Atomic style added: ${id}`);
 				this.notifyAtomicStyleAdded(atomicStyle);
 			}
 		});
+		log.debug(`Resolved ${resolvedIds.length} atomic styles, ${unknown.size} unknown items`);
 		return [...unknown, ...resolvedIds];
 	}
 	async renderPreflights(isFormatted) {
+		log.debug("Rendering preflights...");
 		const lineEnd = isFormatted ? "\n" : "";
-		return (await Promise.all(this.config.preflights.map(async (p) => {
+		const results = await Promise.all(this.config.preflights.map(async (p) => {
 			const result = await p(this, isFormatted);
 			if (typeof result === "string") return result;
 			return renderPreflightDefinition({
@@ -803,12 +875,17 @@ var Engine = class {
 				preflightDefinition: result,
 				isFormatted
 			});
-		}))).join(lineEnd);
+		}));
+		log.debug(`Rendered ${results.length} preflights`);
+		return results.join(lineEnd);
 	}
 	async renderAtomicStyles(isFormatted, options = {}) {
+		log.debug("Rendering atomic styles...");
 		const { atomicStyleIds = null, isPreview = false } = options;
+		const atomicStyles = atomicStyleIds == null ? [...this.store.atomicStyles.values()] : atomicStyleIds.map((id) => this.store.atomicStyles.get(id)).filter(isNotNullish);
+		log.debug(`Rendering ${atomicStyles.length} atomic styles (preview: ${isPreview})`);
 		return renderAtomicStyles({
-			atomicStyles: atomicStyleIds == null ? [...this.store.atomicStyles.values()] : atomicStyleIds.map((id) => this.store.atomicStyles.get(id)).filter(isNotNullish),
+			atomicStyles,
 			isPreview,
 			isFormatted,
 			defaultSelector: this.config.defaultSelector
@@ -824,6 +901,7 @@ function resolvePreflight(preflight) {
 }
 async function resolveEngineConfig(config) {
 	const { prefix = "", defaultSelector = `.${ATOMIC_STYLE_ID_PLACEHOLDER}`, plugins = [], preflights = [] } = config;
+	log.debug(`Resolving engine config with prefix: "${prefix}", plugins: ${plugins.length}, preflights: ${preflights.length}`);
 	const resolvedConfig = {
 		rawConfig: config,
 		plugins: resolvePlugins(plugins),
@@ -841,6 +919,7 @@ async function resolveEngineConfig(config) {
 	};
 	const resolvedPreflights = preflights.map(resolvePreflight);
 	resolvedConfig.preflights.push(...resolvedPreflights);
+	log.debug(`Engine config resolved: ${resolvedPreflights.length} preflights processed`);
 	return resolvedConfig;
 }
 function getAtomicStyleId({ content, prefix, stored }) {
@@ -850,10 +929,14 @@ function getAtomicStyleId({ content, prefix, stored }) {
 		content.value
 	]);
 	const cached = stored.get(key);
-	if (cached != null) return cached;
+	if (cached != null) {
+		log.debug(`Atomic style cached: ${cached}`);
+		return cached;
+	}
 	const num = stored.size;
 	const id = `${prefix}${numberToChars(num)}`;
 	stored.set(key, id);
+	log.debug(`Generated new atomic style ID: ${id}`);
 	return id;
 }
 function optimizeAtomicStyleContents(list) {
@@ -953,4 +1036,4 @@ async function renderPreflightDefinition(payload) {
 /* c8 ignore end */
 
 //#endregion
-export { appendAutocompleteCssPropertyValues, appendAutocompleteExtraCssProperties, appendAutocompleteExtraProperties, appendAutocompletePropertyValues, appendAutocompleteSelectors, appendAutocompleteStyleItemStrings, createEngine, defineEngineConfig, defineEnginePlugin, renderCSSStyleBlocks, setWarnFn, warn };
+export { appendAutocompleteCssPropertyValues, appendAutocompleteExtraCssProperties, appendAutocompleteExtraProperties, appendAutocompletePropertyValues, appendAutocompleteSelectors, appendAutocompleteStyleItemStrings, createEngine, createLogger, defineEngineConfig, defineEnginePlugin, log, renderCSSStyleBlocks };

package/package.json

@@ -1,15 +1,12 @@
 {
   "name": "@pikacss/core",
   "type": "module",
-  "publishConfig": {
-    "access": "public"
-  },
-  "version": "0.0.32",
+  "version": "0.0.34",
   "author": "DevilTea <ch19980814@gmail.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/DevilTea/pikacss.git",
+    "url": "https://github.com/pikacss/pikacss.git",
     "directory": "packages/core"
   },
   "bugs": {
@@ -36,6 +33,9 @@
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
   "types": "dist/index.d.mts",
+  "publishConfig": {
+    "access": "public"
+  },
   "files": [
     "dist"
   ],
@@ -43,7 +43,7 @@
     "csstype": "^3.2.3"
   },
   "scripts": {
-    "build": "tsdown",
+    "build": "tsdown && pnpm exec publint",
     "typecheck": "pnpm typecheck:package && pnpm typecheck:test",
     "typecheck:package": "tsc --project ./tsconfig.package.json --noEmit",
     "typecheck:test": "tsc --project ./tsconfig.tests.json --noEmit",