@pikacss/plugin-typography 0.0.38 → 0.0.40

package/README.md

@@ -16,7 +16,9 @@ import { defineEngineConfig } from '@pikacss/core'
 import { typography } from '@pikacss/plugin-typography'
 
 export default defineEngineConfig({
-  plugins: [typography()]
+	plugins: [
+		typography() // Note: must call function
+	]
 })
 ```
 
@@ -185,26 +187,47 @@ Size modifiers apply the complete `prose` styles with different font sizes:
 
 ### Customization
 
-Override color variables when creating the plugin:
+The plugin provides module augmentation for type-safe configuration. After importing the plugin, the `typography` property becomes available in `EngineConfig` with full TypeScript autocomplete.
 
 **pika.config.ts**:
 ```typescript
 import { defineEngineConfig } from '@pikacss/core'
 import { typography } from '@pikacss/plugin-typography'
 
+// Module augmentation is automatic - just import the plugin
 export default defineEngineConfig({
-  plugins: [
-    typography({
-      variables: {
-        '--pk-prose-color-body': '#374151',
-        '--pk-prose-color-headings': '#111827',
-        '--pk-prose-color-links': '#2563eb',
-      }
-    })
-  ]
+	plugins: [
+		typography() // Note: must call function
+	],
+	typography: { // ✅ TypeScript autocomplete works here
+		variables: {
+			'--pk-prose-color-body': '#374151',
+			'--pk-prose-color-headings': '#111827',
+			'--pk-prose-color-links': '#2563eb',
+		}
+	}
 })
 ```
 
+**How Module Augmentation Works**:
+
+The plugin declares module augmentation internally:
+
+```typescript
+declare module '@pikacss/core' {
+	interface EngineConfig {
+		typography?: {
+			variables?: Partial<Record<string, string>>
+		}
+	}
+}
+```
+
+This enables:
+- **IntelliSense**: TypeScript shows the `typography` property when you type in `defineEngineConfig`
+- **Type Safety**: Invalid configuration shapes are caught at compile time
+- **Documentation**: Hover over the property to see available options
+
 #### Available CSS Variables
 
 ```css
@@ -284,7 +307,7 @@ Using modular shortcuts can significantly reduce CSS bundle size:
 
 ## Documentation
 
-For complete documentation, visit: [PikaCSS Documentation](https://pikacss.dev)
+For complete documentation, visit: [PikaCSS Documentation](https://pikacss.github.io/pikacss/)
 
 ## License
 

package/dist/index.cjs

@@ -307,13 +307,17 @@ const proseTablesStyle = (0, _pikacss_core.defineStyleDefinition)({
 
 //#endregion
 //#region src/index.ts
-function typography(options = {}) {
+function typography() {
+	let typographyConfig = {};
 	return (0, _pikacss_core.defineEnginePlugin)({
 		name: "typography",
+		configureRawConfig: (config) => {
+			if (config.typography) typographyConfig = config.typography;
+		},
 		configureEngine: async (engine) => {
 			engine.variables.add({
 				...typographyVariables,
-				...options.variables
+				...typographyConfig.variables
 			});
 			engine.shortcuts.add(["prose-base", proseBaseStyle]);
 			engine.shortcuts.add(["prose-paragraphs", ["prose-base", proseParagraphsStyle]]);

package/dist/index.d.cts

@@ -34,6 +34,6 @@ declare module '@pikacss/core' {
     typography?: TypographyPluginOptions;
   }
 }
-declare function typography(options?: TypographyPluginOptions): EnginePlugin;
+declare function typography(): EnginePlugin;
 //#endregion
 export { TypographyPluginOptions, typography };

package/dist/index.d.mts

@@ -34,6 +34,6 @@ declare module '@pikacss/core' {
     typography?: TypographyPluginOptions;
   }
 }
-declare function typography(options?: TypographyPluginOptions): EnginePlugin;
+declare function typography(): EnginePlugin;
 //#endregion
 export { TypographyPluginOptions, typography };

package/dist/index.mjs

@@ -307,13 +307,17 @@ const proseTablesStyle = defineStyleDefinition({
 
 //#endregion
 //#region src/index.ts
-function typography(options = {}) {
+function typography() {
+	let typographyConfig = {};
 	return defineEnginePlugin({
 		name: "typography",
+		configureRawConfig: (config) => {
+			if (config.typography) typographyConfig = config.typography;
+		},
 		configureEngine: async (engine) => {
 			engine.variables.add({
 				...typographyVariables,
-				...options.variables
+				...typographyConfig.variables
 			});
 			engine.shortcuts.add(["prose-base", proseBaseStyle]);
 			engine.shortcuts.add(["prose-paragraphs", ["prose-base", proseParagraphsStyle]]);

package/package.json

@@ -4,16 +4,16 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.0.38",
+  "version": "0.0.40",
   "author": "DevilTea <ch19980814@gmail.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/pikacss/pikacss.git",
+    "url": "https://github.com/pikacss/pikacss.github.io.git",
     "directory": "packages/plugin-typography"
   },
   "bugs": {
-    "url": "https://github.com/pikacss/pikacss/issues"
+    "url": "https://github.com/pikacss/pikacss.github.io/issues"
   },
   "keywords": [
     "pikacss",
@@ -39,10 +39,10 @@
     "dist"
   ],
   "peerDependencies": {
-    "@pikacss/core": "0.0.38"
+    "@pikacss/core": "0.0.40"
   },
   "devDependencies": {
-    "@pikacss/core": "0.0.38"
+    "@pikacss/core": "0.0.40"
   },
   "scripts": {
     "build": "tsdown",