postcss-kazaksha 1.2.0 → 2.0.0

package/package.json

@@ -1,8 +1,51 @@
 {
   "name": "postcss-kazaksha",
-  "version": "1.2.0",
+  "version": "2.0.0",
   "description": "PostCSS плагині - қазақша CSS жазып, стандартты CSS-ке аударыңыз",
-  "main": "index.js",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./dictionary": {
+      "import": {
+        "types": "./dist/dictionary/index.d.ts",
+        "default": "./dist/dictionary/index.js"
+      },
+      "require": {
+        "types": "./dist/dictionary/index.d.cts",
+        "default": "./dist/dictionary/index.cjs"
+      }
+    },
+    "./package.json": "./package.json",
+    "./vscode-data": "./dist/vscode/kazaksha.css-data.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup && node scripts/generate-vscode-data.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc && tsc -p playground",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build",
+    "playground": "vite --config playground/vite.config.ts",
+    "playground:build": "tsc -p playground && vite build --config playground/vite.config.ts"
+  },
   "keywords": [
     "postcss",
     "postcss-plugin",
@@ -21,10 +64,31 @@
   "bugs": {
     "url": "https://github.com/Baukaalm/postcss-kazaksha/issues"
   },
+  "homepage": "https://github.com/Baukaalm/postcss-kazaksha#readme",
   "peerDependencies": {
     "postcss": "^8.0.0"
   },
+  "dependencies": {
+    "postcss-selector-parser": "^7.1.0",
+    "postcss-value-parser": "^4.2.0"
+  },
   "devDependencies": {
-    "postcss": "^8.4.0"
+    "@gravity-ui/icons": "^2.23.1",
+    "@heroui/react": "3.2",
+    "@heroui/styles": "3.2",
+    "@tailwindcss/vite": "^4.3.5",
+    "@types/node": "^22.20.5",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitejs/plugin-react": "^5.2.0",
+    "@vscode/web-custom-data": "^0.6.4",
+    "postcss": "^8.5.0",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "tailwindcss": "^4.3.5",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.0",
+    "vite": "^7.3.8",
+    "vitest": "^3.2.0"
   }
-}
+}

package/readme.md

@@ -1,60 +1,173 @@
 # postcss-kazaksha 🇰🇿
 
-PostCSS плагині - қазақша CSS жазып, стандартты CSS-ке аударыңыз!
+PostCSS плагині: қазақша CSS жазып, стандартты CSS-ке аударыңыз!
+
+**[Онлайн ойын алаңы](https://baukaalm.github.io/postcss-kazaksha/)**: орнатпай-ақ браузерде байқап көріңіз.
 
 ## Орнату
+
 ```bash
-npm install postcss-kazaksha
+npm install -D postcss-kazaksha
 ```
 
+Node.js 20+ және PostCSS 8 қажет.
+
 ## Қолдану
 
 **postcss.config.js:**
-```javascript
+
+```js
 module.exports = {
-  plugins: [
-    require('postcss-kazaksha')
-  ]
-}
+  plugins: [require('postcss-kazaksha')],
+};
+```
+
+**ESM / TypeScript:**
+
+```ts
+import kazaksha from 'postcss-kazaksha';
+
+export default {
+  plugins: [kazaksha({ strict: true })],
+};
 ```
 
 ## Мысал
 
 **Қазақша CSS:**
+
 ```css
 :root {
   --негізгі-түс: көк;
-  --екінші-түс: жасыл;
 }
 
-.block {
-  артқы-түс: var(--негізгі-түс);
+.батырма {
+  фон-түсі: var(--негізгі-түс);
   түс: ақ;
-  өту: барлық 0.3s;
+  шекара: 1px тұтас мөлдір;
+  меңзер: нұсқағыш;
+  өту: барлық 0.3s жұмсақ;
+}
+
+.батырма:үстінде {
   түрлендіру: масштаб(1.1);
 }
 
-.container {
+.тор {
   көрсету: тор;
-  тор-үлгі-бағандар: қайталау(3, 1fr);
-  орын: 20px;
+  тор-үлгі-бағандар: қайталау(авто-толтыру, мин-макс(200px, 1fr));
+  аралық: 20px;
 }
 
-@media (ең-аз-ені: 768px) {
-  .контейнер {
-    ені: 100%;
+@медиа экран және (ең-кіші-ені: 768px) {
+  .тор {
+    ені: есептеу(100% - 40px) !маңызды;
   }
 }
+
+@кадрлар пайда-болу {
+  бастап { мөлдірлік: 0 }
+  дейін { мөлдірлік: 1 }
+}
 ```
 
-## Қолдау көрсетілетін қасиеттер
+**Нәтиже:**
+
+```css
+:root {
+  --негізгі-түс: blue;
+}
+
+.батырма {
+  background-color: var(--негізгі-түс);
+  color: white;
+  border: 1px solid transparent;
+  cursor: pointer;
+  transition: all 0.3s ease;
+}
+
+.батырма:hover {
+  transform: scale(1.1);
+}
 
-- Түстер: түс, артқы-түс, шекара-түс
-- Өлшемдер: ені, биіктігі
-- Орналасу: көрсету, орналасу
-- Flexbox: икемді, негіздеу-мазмұн, туралау-элементтер
-- Typography: қаріп-өлшемі, қаріп-салмағы, мәтін-туралау
-- және т.б.
+.тор {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
+  gap: 20px;
+}
+
+@media screen and (min-width: 768px) {
+  .тор {
+    width: calc(100% - 40px) !important;
+  }
+}
+
+@keyframes пайда-болу {
+  from { opacity: 0 }
+  to { opacity: 1 }
+}
+```
+
+Класс атаулары, `"тырнақшадағы мәтін"` және `url(...)` ішіндегі жолдар өзгертілмейді.
+Мәндерде тек кіші әріппен жазылған кілт сөздер аударылады, сондықтан `Қара Sans` сияқты қаріп атаулары өзгермейді.
+
+## Не аударылады
+
+| Бөлім | Мысалдар |
+|---|---|
+| Қасиеттер | `түс`, `фон-түсі`, `ені`, `сыртқы-шегініс`, `ішкі-шегініс`, `көрсету`, `меңзер` |
+| Мәндер | `қызыл`, `тұтас`, `орта`, `жол-ішілік`, `жоқ`, `авто`, `барлық` |
+| Функциялар | `масштаб()`, `бұру()`, `есептеу()`, `қайталау()`, `сызықтық-градиент()` |
+| Псевдокластар | `:үстінде`, `:фокус`, `:белсенді`, `:n-ші-бала()`, `::алдында`, `::кейін` |
+| At-ережелер | `@медиа`, `@кадрлар`, `@қолдау`, `@контейнер`, `@қабат`, `@импорт` |
+| Медиа | `экран`, `басып-шығару`, `және`, `түс-схемасы: қараңғы` |
+| Басқа | `!маңызды`, `бастап` / `дейін` |
+
+Толық тізім: [`src/dictionary`](./src/dictionary). Сөздікті кодтан да алуға болады:
+
+```js
+import { properties, values } from 'postcss-kazaksha/dictionary';
+```
+
+## VS Code: автотолықтыру
+
+Пакетпен бірге VS Code үшін деректер файлы келеді: редактор қазақша қасиеттерді, әр қасиетке сәйкес мәндерді,
+псевдокластар мен at-ережелерді ұсынады, ал сипаттамада CSS атауы мен MDN сілтемесі көрсетіледі.
+Сондай-ақ «Unknown property» ескертулері жоғалады.
+
+Жобаның `.vscode/settings.json` файлына қосыңыз:
+
+```json
+{
+  "css.customData": ["./node_modules/postcss-kazaksha/dist/vscode/kazaksha.css-data.json"]
+}
+```
+
+Содан кейін VS Code терезесін қайта жүктеңіз (`Developer: Reload Window`).
+
+## Опциялар
+
+```ts
+kazaksha({
+  // Өз сөздеріңізді қосу немесе бар сөзді қайта анықтау
+  extend: {
+    values: { 'теңіз': '#1e90ff' },
+    properties: { 'қалқыма': 'float' },
+  },
+  // Сөздікте жоқ қазақша сөздерге ескерту шығару (әдепкі: false)
+  strict: true,
+});
+```
+
+## Әзірлеу
+
+```bash
+npm install
+npm test          # vitest
+npm run typecheck # tsc
+npm run build     # tsup → dist/
+npm run playground # ойын алаңы, localhost
+```
 
 ## Лицензия
 

package/dictionary/index.js

@@ -1,325 +0,0 @@
-module.exports = {
-    // === ТҮСТЕР ===
-    'түс': 'color',
-    'артқы-түс': 'background-color',
-    'артқы': 'background',
-    'артқы-сурет': 'background-image',
-    'артқы-орналасу': 'background-position',
-    'артқы-өлшем': 'background-size',
-    'артқы-қайталау': 'background-repeat',
-    'артқы-бекіту': 'background-attachment',
-    'шекара-түс': 'border-color',
-    'контур-түс': 'outline-color',
-    
-    // Түстер атаулары
-    'қызыл': 'red',
-    'көк': 'blue',
-    'жасыл': 'green',
-    'сары': 'yellow',
-    'қара': 'black',
-    'ақ': 'white',
-    'сұр': 'gray',
-    'қызғылт': 'pink',
-    'күлгін': 'purple',
-    'қоңыр': 'brown',
-    'апельсин': 'orange',
-    'көгілдір': 'cyan',
-    'мөлдір': 'transparent',
-    
-    // === ӨЛШЕМДЕР ===
-    'ені': 'width',
-    'биіктігі': 'height',
-    'ең-көп-ені': 'max-width',
-    'ең-көп-биіктігі': 'max-height',
-    'ең-аз-ені': 'min-width',
-    'ең-аз-биіктігі': 'min-height',
-    
-    // === ШЕКАРАЛАР ===
-    'шекара': 'border',
-    'шекара-ені': 'border-width',
-    'шекара-стилі': 'border-style',
-    'шекара-радиусы': 'border-radius',
-    'шекара-жоғары': 'border-top',
-    'шекара-төмен': 'border-bottom',
-    'шекара-сол': 'border-left',
-    'шекара-оң': 'border-right',
-    'шекара-жоғары-ені': 'border-top-width',
-    'шекара-төмен-ені': 'border-bottom-width',
-    'шекара-сол-ені': 'border-left-width',
-    'шекара-оң-ені': 'border-right-width',
-    'шекара-жоғары-түс': 'border-top-color',
-    'шекара-төмен-түс': 'border-bottom-color',
-    'шекара-сол-түс': 'border-left-color',
-    'шекара-оң-түс': 'border-right-color',
-    'шекара-жоғары-сол-радиус': 'border-top-left-radius',
-    'шекара-жоғары-оң-радиус': 'border-top-right-radius',
-    'шекара-төмен-сол-радиус': 'border-bottom-left-radius',
-    'шекара-төмен-оң-радиус': 'border-bottom-right-radius',
-    
-    // === КОНТУР ===
-    'контур': 'outline',
-    'контур-ені': 'outline-width',
-    'контур-стилі': 'outline-style',
-    'контур-ығысу': 'outline-offset',
-    
-    // === ОРНАЛАСУ ===
-    'орналасу': 'position',
-    'көрсету': 'display',
-    'көрінуі': 'visibility',
-    'жасырын': 'none',
-    'блок': 'block',
-    'қатар': 'inline',
-    'қатар-блок': 'inline-block',
-    'икемді': 'flex',
-    'қатар-икемді': 'inline-flex',
-    'тор': 'grid',
-    'қатар-тор': 'inline-grid',
-    
-    // Position мәндері
-    'салыстырмалы': 'relative',
-    'абсолютті': 'absolute',
-    'бекітілген': 'fixed',
-    'жабысқақ': 'sticky',
-    'статикалық': 'static',
-    
-    // Координаттар
-    'жоғары': 'top',
-    'төмен': 'bottom',
-    'сол': 'left',
-    'оң': 'right',
-    
-    // === MARGIN & PADDING ===
-    'сыртқы-бос': 'margin',
-    'ішкі-бос': 'padding',
-    'сыртқы-бос-жоғары': 'margin-top',
-    'сыртқы-бос-төмен': 'margin-bottom',
-    'сыртқы-бос-сол': 'margin-left',
-    'сыртқы-бос-оң': 'margin-right',
-    'ішкі-бос-жоғары': 'padding-top',
-    'ішкі-бос-төмен': 'padding-bottom',
-    'ішкі-бос-сол': 'padding-left',
-    'ішкі-бос-оң': 'padding-right',
-    
-    // === МӘТІН ===
-    'қаріп': 'font',
-    'қаріп-өлшемі': 'font-size',
-    'қаріп-салмағы': 'font-weight',
-    'қаріп-жанұясы': 'font-family',
-    'қаріп-стилі': 'font-style',
-    'мәтін-туралау': 'text-align',
-    'мәтін-безендіру': 'text-decoration',
-    'мәтін-түрлендіру': 'text-transform',
-    'мәтін-шегіну': 'text-indent',
-    'жол-биіктігі': 'line-height',
-    'әріп-аралығы': 'letter-spacing',
-    'сөз-аралығы': 'word-spacing',
-    'сөз-орау': 'word-wrap',
-    'сөз-үзу': 'word-break',
-    'ақ-кеңістік': 'white-space',
-    'мәтін-толық': 'text-overflow',
-    'мәтін-көлеңке': 'text-shadow',
-    'жазу-режимі': 'writing-mode',
-    'қаріп-тегістеу': 'font-smooth',
-    
-    // Мәтін туралау
-    'орта': 'center',
-    'екі-жаққа': 'justify',
-    
-    // Қаріп салмағы
-    'жуан': 'bold',
-    'жіңішке': 'lighter',
-    'қалыпты': 'normal',
-    'қалың': 'bolder',
-    
-    // Мәтін түрлендіру
-    'бас-әріп': 'uppercase',
-    'кіші-әріп': 'lowercase',
-    'бірінші-бас': 'capitalize',
-    
-    // === FLEXBOX ===
-    'икемді-бағыт': 'flex-direction',
-    'икемді-орама': 'flex-wrap',
-    'икемді-ағын': 'flex-flow',
-    'негіздеу-мазмұн': 'justify-content',
-    'туралау-элементтер': 'align-items',
-    'туралау-мазмұн': 'align-content',
-    'туралау-өзі': 'align-self',
-    'икемді-өсу': 'flex-grow',
-    'икемді-кішірейту': 'flex-shrink',
-    'икемді-негіз': 'flex-basis',
-    'реттілік': 'order',
-    'орын': 'gap',
-    'қатар-орын': 'row-gap',
-    'баған-орын': 'column-gap',
-    
-    // Flexbox мәндері
-    'қатар': 'row',
-    'қатар-кері': 'row-reverse',
-    'баған': 'column',
-    'баған-кері': 'column-reverse',
-    'орау': 'wrap',
-    'орау-кері': 'wrap-reverse',
-    'аралық': 'space-between',
-    'айналасында': 'space-around',
-    'тең-аралық': 'space-evenly',
-    'созу': 'stretch',
-    'бастау': 'flex-start',
-    'аяқтау': 'flex-end',
-    
-    // === GRID ===
-    'тор-үлгі': 'grid-template',
-    'тор-үлгі-бағандар': 'grid-template-columns',
-    'тор-үлгі-қатарлар': 'grid-template-rows',
-    'тор-үлгі-аймақтар': 'grid-template-areas',
-    'тор-баған': 'grid-column',
-    'тор-қатар': 'grid-row',
-    'тор-баған-бастау': 'grid-column-start',
-    'тор-баған-аяқ': 'grid-column-end',
-    'тор-қатар-бастау': 'grid-row-start',
-    'тор-қатар-аяқ': 'grid-row-end',
-    'тор-аймақ': 'grid-area',
-    'тор-авто-бағандар': 'grid-auto-columns',
-    'тор-авто-қатарлар': 'grid-auto-rows',
-    'тор-авто-ағын': 'grid-auto-flow',
-    
-    // === АНИМАЦИЯ & ӨТУЛЕР ===
-    'өту': 'transition',
-    'өту-қасиет': 'transition-property',
-    'өту-ұзақтық': 'transition-duration',
-    'өту-уақыт': 'transition-timing-function',
-    'өту-кідіріс': 'transition-delay',
-    'түрлендіру': 'transform',
-    'түрлендіру-бастау': 'transform-origin',
-    'түрлендіру-стиль': 'transform-style',
-    'анимация': 'animation',
-    'анимация-аты': 'animation-name',
-    'анимация-ұзақтық': 'animation-duration',
-    'анимация-уақыт': 'animation-timing-function',
-    'анимация-кідіріс': 'animation-delay',
-    'анимация-қайталау': 'animation-iteration-count',
-    'анимация-бағыт': 'animation-direction',
-    'анимация-толтыру': 'animation-fill-mode',
-    'анимация-күй': 'animation-play-state',
-    
-    // === КӨЛЕҢКЕ & ЭФФЕКТТЕР ===
-    'көлеңке': 'box-shadow',
-    'мөлдірлік': 'opacity',
-    'сүзгі': 'filter',
-    'артқы-сүзгі': 'backdrop-filter',
-    'қиылысу-режимі': 'mix-blend-mode',
-    'фон-қиылысу': 'background-blend-mode',
-    
-    // === АСПАП & ИНТЕРФЕЙС ===
-    'аспап': 'cursor',
-    'меңзер': 'pointer',
-    'қол': 'grab',
-    'ұстау': 'grabbing',
-    'өлшемді': 'resize',
-    'пайдаланушы-таңдау': 'user-select',
-    'нұсқау-оқиғалары': 'pointer-events',
-    
-    // === ТАСУ & АЙНАЛДЫРУ ===
-    'тасу': 'overflow',
-    'тасу-х': 'overflow-x',
-    'тасу-у': 'overflow-y',
-    'айналдыру': 'scroll-behavior',
-    'көрінбейді': 'hidden',
-    'көрінеді': 'visible',
-    'авто': 'auto',
-    'айналдыру-жолақ': 'scroll-snap-type',
-    'айналдыру-туралау': 'scroll-snap-align',
-    
-    // === Z-INDEX & ҚАБАТТАР ===
-    'қабат': 'z-index',
-    'оқшаулау': 'isolation',
-    
-    // === КЕСТЕ ===
-    'кесте-орналасу': 'table-layout',
-    'шекара-ығысу': 'border-collapse',
-    'шекара-аралық': 'border-spacing',
-    'босату-орындар': 'empty-cells',
-    'тақырып-жағы': 'caption-side',
-    
-    // === ТІЗІМ ===
-    'тізім-стиль': 'list-style',
-    'тізім-стиль-түрі': 'list-style-type',
-    'тізім-стиль-орны': 'list-style-position',
-    'тізім-стиль-сурет': 'list-style-image',
-    
-    // === МАЗМҰН ===
-    'мазмұн': 'content',
-    'есептегіш-қайта-орнату': 'counter-reset',
-    'есептегіш-өсу': 'counter-increment',
-    
-    // === БАСҚА ҚАСИЕТТЕР ===
-    'қорап-өлшемі': 'box-sizing',
-    'қорап-безендіру': 'box-decoration-break',
-    'нысан-сәйкес': 'object-fit',
-    'нысан-орны': 'object-position',
-    'аспект-қатынас': 'aspect-ratio',
-    'бағыт': 'direction',
-    'юникод-биди': 'unicode-bidi',
-    'баған-саны': 'column-count',
-    'баған-ені': 'column-width',
-    'баған-орын': 'column-gap',
-    'баған-ереже': 'column-rule',
-    'баған-аралық': 'column-span',
-    'баған-толтыру': 'column-fill',
-    'үзу-ішінде': 'break-inside',
-    'үзу-алдында': 'break-before',
-    'үзу-кейін': 'break-after',
-    'орфа': 'orphans',
-    'жесірлер': 'widows',
-    'бетке-үзу': 'page-break-inside',
-    'қамту': 'clip',
-    'қамту-жол': 'clip-path',
-    'маска': 'mask',
-    'маска-сурет': 'mask-image',
-    'маска-өлшем': 'mask-size',
-    'маска-орны': 'mask-position',
-    'пішін-сыртында': 'shape-outside',
-    'пішін-шегі': 'shape-margin',
-    'пішін-сурет': 'shape-image-threshold',
-    'өзгерту': 'will-change',
-    'сенімділік': 'contain',
-    'болжам': 'appearance',
-    
-    // === МӘНДЕР ===
-    'автоматты': 'auto',
-    'жоқ': 'none',
-    'қатты': 'solid',
-    'үзікті': 'dashed',
-    'нүктелі': 'dotted',
-    'қосарлы': 'double',
-    'ойық': 'groove',
-    'қабық': 'ridge',
-    'ену': 'inset',
-    'шығу': 'outset',
-    'көп-нүкте': 'ellipsis',
-    'шексіз': 'infinite',
-    'алға': 'forwards',
-    'артқа': 'backwards',
-    'екеуі-де': 'both',
-    'кері': 'reverse',
-    'кезекпе-кезек': 'alternate',
-    'кезекпе-кезек-кері': 'alternate-reverse',
-    'жүгіру': 'running',
-    'кідіріс': 'paused',
-    'қамту': 'cover',
-    'сақтау': 'contain',
-    'толтыру': 'fill',
-    'масштаб-төмен': 'scale-down',
-    'қайталау': 'repeat',
-    'қайталамау': 'no-repeat',
-    'қайталау-х': 'repeat-x',
-    'қайталау-у': 'repeat-y',
-    'айналма': 'round',
-    'кеңістік': 'space',
-    'шекара-қорап': 'border-box',
-    'мазмұн-қорап': 'content-box',
-    'мұраға-қалдыру': 'inherit',
-    'бастапқы': 'initial',
-    'орнатылмаған': 'unset',
-    'тастау': 'revert',
-  };
-