npm - @bookklik/senangstart-css - Versions diffs - 0.1.2 → 0.1.4 - Mend

@bookklik/senangstart-css 0.1.2 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (200) hide show

package/.github/workflows/deploy-docs.yml CHANGED Viewed

@@ -36,7 +36,7 @@ jobs:
         run: npm ci
       - name: Build with VitePress
-        run: npm run docs:build
+        run: npm run build:dist
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3

package/LICENSE.md ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 Bookklik Technologies
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md CHANGED Viewed

@@ -1,209 +1,37 @@
 # SenangStart CSS
-**The Intent-First CSS Engine**
+A utility-first CSS framework that replaces abstract naming conventions with Natural Adjectives.
-> "Speak Human. Compile to Logic."
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE.md)
-Stop memorizing arbitrary scales like `px-4`, `px-8`, `px-16`. Start using natural adjectives: `tiny`, `small`, `medium`, `big`, `giant`, `vast`.
+## Quick Start
-## Quick Start (CDN - Zero Build)
+### CDN (Zero Build)
 ```html
-<!DOCTYPE html>
-<html>
-<head>
-  <script src="https://cdn.senangstart.dev/jit.js"></script>
-</head>
-<body>
-  <div
-    layout="flex col center"
-    space="p:big"
-    visual="bg:primary text:white rounded:big"
-  >
-    Hello SenangStart!
-  </div>
-</body>
-</html>
+<script src="https://unpkg.com/@bookklik/senangstart-css/dist/senangstart-css.min.js"></script>
+<div
+  layout="flex col center"
+  space="p:big"
+  visual="bg:primary text:white rounded:big"
+>
+  Hello SenangStart!
+</div>
 ```
-## Quick Start (CLI)
+### CLI
 ```bash
-# Install
 npm i @bookklik/senangstart-css
-# Initialize config
 senangstart init
-# Start development
 senangstart dev
 ```
-## The Tri-Attribute Syntax
-SenangStart uses **three attributes** to separate concerns:
-| Attribute | Purpose | Example |
-|-----------|---------|---------|
-| `layout` | Structure & position | `layout="flex col center"` |
-| `space` | Sizing & spacing | `space="p:medium g:small"` |
-| `visual` | Colors & appearance | `visual="bg:white rounded:big"` |
-## The Natural Spacing Scale
-| Keyword | Size | Mental Model |
-|---------|------|--------------|
-| `none` | 0px | No space |
-| `tiny` | 4px | 🪨 Pebble — Borders, offsets |
-| `small` | 8px | 📦 Matchbox — Group related items |
-| `medium` | 16px | 📱 Smartphone — Standard default |
-| `big` | 32px | 💻 Laptop — Separate sections |
-| `giant` | 64px | 🚪 Door — Layout divisions |
-| `vast` | 128px | 🏠 House — Hero sections |
-## Layout Attribute
-```html
-<!-- Flexbox -->
-<div layout="flex row center">...</div>
-<div layout="flex col between">...</div>
-<!-- Grid -->
-<div layout="grid">...</div>
-<!-- Position -->
-<nav layout="fixed z:top">...</nav>
-```
-### Keywords
-- **Display:** `flex`, `grid`, `block`, `hidden`
-- **Direction:** `row`, `col`, `row-reverse`, `col-reverse`
-- **Alignment:** `center`, `between`, `start`, `end`
-- **Position:** `absolute`, `relative`, `fixed`, `sticky`
-- **Z-Index:** `z:base`, `z:low`, `z:mid`, `z:high`, `z:top`
-## Space Attribute
-Syntax: `[breakpoint]:[property]:[scale]`
-```html
-<!-- Padding -->
-<div space="p:medium">All sides</div>
-<div space="p-x:big p-y:small">Horizontal & vertical</div>
-<!-- Margin -->
-<div space="m-b:big">Bottom margin</div>
-<div space="m-x:auto">Center horizontally</div>
-<!-- Gap (flex/grid) -->
-<div layout="flex" space="g:small">...</div>
-<!-- Sizing -->
-<div space="w:[100%] max-w:[1200px]">...</div>
-```
-### Properties
-- `p`, `p-t`, `p-r`, `p-b`, `p-l`, `p-x`, `p-y` — Padding
-- `m`, `m-t`, `m-r`, `m-b`, `m-l`, `m-x`, `m-y` — Margin
-- `g`, `g-x`, `g-y` — Gap
-- `w`, `h`, `min-w`, `max-w`, `min-h`, `max-h` — Sizing
-### Arbitrary Values (Escape Hatch)
-```html
-<div space="w:[350px] h:[100vh]">...</div>
-```
-## Visual Attribute
+## Documentation
-```html
-<!-- Colors -->
-<div visual="bg:primary text:white">...</div>
-<!-- Borders & Shadows -->
-<div visual="rounded:big shadow:medium">...</div>
-<!-- Typography -->
-<span visual="font:bold text-size:big">...</span>
-```
-### Properties
-- `bg` — Background color
-- `text` — Text color or alignment
-- `text-size` — Font size (`tiny`, `small`, `medium`, `big`, `giant`, `vast`)
-- `font` — Font weight (`normal`, `medium`, `bold`)
-- `rounded` — Border radius (`none`, `small`, `medium`, `big`, `round`)
-- `shadow` — Box shadow (`none`, `small`, `medium`, `big`, `giant`)
-## Responsive Design
-```html
-<div space="p:small tab:p:medium lap:p:big">
-  Grows with screen size
-</div>
-<div layout="flex col tab:row">
-  Column on mobile, row on tablet+
-</div>
-```
-### Breakpoints
-| Prefix | Screen |
-|--------|--------|
-| `mob:` | 480px+ |
-| `tab:` | 768px+ |
-| `lap:` | 1024px+ |
-| `desk:` | 1280px+ |
-## Hover & States
-```html
-<button visual="bg:primary hover:bg:[#2563EB]">
-  Hover me
-</button>
-<a visual="text:grey hover:text:primary">Link</a>
-```
-## CLI Commands
-```bash
-senangstart init     # Create config file
-senangstart build    # One-time build
-senangstart dev      # Watch mode
-```
-## Configuration
-```javascript
-// senangstart.config.js
-export default {
-  content: ['./src/**/*.html'],
-  output: {
-    css: './public/senangstart.css',
-    minify: true
-  },
-  theme: {
-    spacing: {
-      'huge': '256px'  // Add custom scale
-    },
-    colors: {
-      'brand': '#8B5CF6'  // Add custom color
-    }
-  }
-}
-```
+Full docs at [bookklik-technologies.github.io/senangstart-css](https://bookklik-technologies.github.io/senangstart-css/)
 ## License
-MIT
----
-*Happy styling!* 🎨
+Read [MIT License](LICENSE.md)

package/dist/senangstart-css.js CHANGED Viewed

@@ -3,11 +3,11 @@
  * Zero-config, browser-based CSS compilation
  *
  * Usage:
- * <script src="https://cdn.senangstart.dev/jit.js"></script>
+ * <script src="https://unpkg.com/@bookklik/senangstart-css/dist/senangstart-css.min.js"></script>
  *
  * Or with custom config:
  * <script type="senangstart/config">{ "theme": { "colors": { "brand": "#8B5CF6" } } }</script>
- * <script src="https://cdn.senangstart.dev/jit.js"></script>
+ * <script src="https://unpkg.com/@bookklik/senangstart-css/dist/senangstart-css.min.js"></script>
  */
 (function() {
@@ -80,7 +80,11 @@
         'high':   '100',
         'top':    '9999'
       }
-    }
+    },
+    // Dark mode configuration
+    // 'media' - Uses @media (prefers-color-scheme: dark)
+    // 'selector' - Uses .dark class on html/body
+    darkMode: 'media'
   };
   // ============================================
@@ -195,7 +199,7 @@
   // ============================================
   const breakpoints = ['mob', 'tab', 'lap', 'desk'];
-  const states = ['hover', 'focus', 'active', 'disabled'];
+  const states = ['hover', 'focus', 'active', 'disabled', 'dark'];
   function parseToken(raw) {
     const token = {
@@ -367,7 +371,8 @@
     if (!cssDeclaration) return '';
     let selector = `[${attrType}~="${raw}"]`;
-    if (token.state) {
+    // Add pseudo-class for states (but not for 'dark' - handled separately)
+    if (token.state && token.state !== 'dark') {
       selector += `:${token.state}`;
     }
@@ -409,6 +414,7 @@
     let css = generateCSSVariables(config);
     const baseRules = [];
+    const darkRules = [];
     const mediaRules = {
       mob: [],
       tab: [],
@@ -420,12 +426,18 @@
       for (const raw of values) {
         const rule = generateRule(raw, attrType);
         if (rule) {
+          // Check for dark: prefix
+          if (raw.match(/^(mob:|tab:|lap:|desk:)?dark:/)) {
+            darkRules.push(rule);
+          }
           // Check for breakpoint prefix
-          const bpMatch = raw.match(/^(mob|tab|lap|desk):/);
-          if (bpMatch) {
-            mediaRules[bpMatch[1]].push(rule);
-          } else {
-            baseRules.push(rule);
+          else {
+            const bpMatch = raw.match(/^(mob|tab|lap|desk):/);
+            if (bpMatch) {
+              mediaRules[bpMatch[1]].push(rule);
+            } else {
+              baseRules.push(rule);
+            }
           }
         }
       }
@@ -444,6 +456,24 @@
       }
     }
+    // Add dark mode rules
+    if (darkRules.length > 0) {
+      const darkMode = config.darkMode || 'media';
+      if (darkMode === 'media') {
+        css += `\n@media (prefers-color-scheme: dark) {\n`;
+        css += darkRules.map(r => '  ' + r).join('');
+        css += '}\n';
+      } else {
+        // Selector strategy
+        const darkSelector = Array.isArray(darkMode) ? darkMode[1] : '.dark';
+        css += `\n/* Dark Mode */\n`;
+        for (const rule of darkRules) {
+          css += rule.replace(/^(\[[^\]]+\])/, `${darkSelector} $1`);
+        }
+      }
+    }
     return css;
   }

package/dist/senangstart-css.min.js CHANGED Viewed

@@ -63,7 +63,8 @@ zIndex: {
 'high':   '100',
 'top':    '9999'
 }
-}
+},
+darkMode: 'media'
 };
 function loadInlineConfig() {
 const configEl = document.querySelector('script[type="senangstart/config"]');
@@ -138,7 +139,7 @@ const layoutKeywords = {
 'sticky': 'position: sticky;'
 };
 const breakpoints = ['mob', 'tab', 'lap', 'desk'];
-const states = ['hover', 'focus', 'active', 'disabled'];
+const states = ['hover', 'focus', 'active', 'disabled', 'dark'];
 function parseToken(raw) {
 const token = {
 raw,
@@ -279,7 +280,7 @@ break;
 }
 if (!cssDeclaration) return '';
 let selector = `[${attrType}~="${raw}"]`;
-if (token.state) {
+if (token.state && token.state !== 'dark') {
 selector += `:${token.state}`;
 }
 return `${selector} { ${cssDeclaration} }\n`;
@@ -306,6 +307,7 @@ return tokens;
 function compileCSS(tokens, config) {
 let css = generateCSSVariables(config);
 const baseRules = [];
+const darkRules = [];
 const mediaRules = {
 mob: [],
 tab: [],
@@ -316,6 +318,10 @@ for (const [attrType, values] of Object.entries(tokens)) {
 for (const raw of values) {
 const rule = generateRule(raw, attrType);
 if (rule) {
+if (raw.match(/^(mob:|tab:|lap:|desk:)?dark:/)) {
+darkRules.push(rule);
+}
+else {
 const bpMatch = raw.match(/^(mob|tab|lap|desk):/);
 if (bpMatch) {
 mediaRules[bpMatch[1]].push(rule);
@@ -325,6 +331,7 @@ baseRules.push(rule);
 }
 }
 }
+}
 css += baseRules.join('');
 const { screens } = config.theme;
 for (const [bp, rules] of Object.entries(mediaRules)) {
@@ -334,6 +341,20 @@ css += rules.map(r => '  ' + r).join('');
 css += '}\n';
 }
 }
+if (darkRules.length > 0) {
+const darkMode = config.darkMode || 'media';
+if (darkMode === 'media') {
+css += `\n@media (prefers-color-scheme: dark) {\n`;
+css += darkRules.map(r => '  ' + r).join('');
+css += '}\n';
+} else {
+const darkSelector = Array.isArray(darkMode) ? darkMode[1] : '.dark';
+css += `\n\n`;
+for (const rule of darkRules) {
+css += rule.replace(/^(\[[^\]]+\])/, `${darkSelector} $1`);
+}
+}
+}
 return css;
 }
 function injectStyles(css) {

package/docs/.vitepress/cache/deps/_metadata.json CHANGED Viewed

@@ -1,50 +1,29 @@
 {
-  "hash": "503d8545",
-  "configHash": "7a659af5",
-  "lockfileHash": "148e5d09",
-  "browserHash": "31430ee1",
+  "hash": "d06eb655",
+  "configHash": "d3307f65",
+  "lockfileHash": "50ffd037",
+  "browserHash": "086d8429",
   "optimized": {
     "vue": {
       "src": "../../../../node_modules/vue/dist/vue.runtime.esm-bundler.js",
       "file": "vue.js",
-      "fileHash": "bb09d08e",
+      "fileHash": "a432d3f8",
       "needsInterop": false
     },
     "vitepress > @vue/devtools-api": {
       "src": "../../../../node_modules/@vue/devtools-api/dist/index.js",
       "file": "vitepress___@vue_devtools-api.js",
-      "fileHash": "1792716f",
+      "fileHash": "af5a81ac",
       "needsInterop": false
     },
     "vitepress > @vueuse/core": {
       "src": "../../../../node_modules/@vueuse/core/index.mjs",
       "file": "vitepress___@vueuse_core.js",
-      "fileHash": "97e57308",
-      "needsInterop": false
-    },
-    "vitepress > @vueuse/integrations/useFocusTrap": {
-      "src": "../../../../node_modules/@vueuse/integrations/useFocusTrap.mjs",
-      "file": "vitepress___@vueuse_integrations_useFocusTrap.js",
-      "fileHash": "4a67da49",
-      "needsInterop": false
-    },
-    "vitepress > mark.js/src/vanilla.js": {
-      "src": "../../../../node_modules/mark.js/src/vanilla.js",
-      "file": "vitepress___mark__js_src_vanilla__js.js",
-      "fileHash": "ffe975a7",
-      "needsInterop": false
-    },
-    "vitepress > minisearch": {
-      "src": "../../../../node_modules/minisearch/dist/es/index.js",
-      "file": "vitepress___minisearch.js",
-      "fileHash": "da3112be",
+      "fileHash": "cfba6d4a",
       "needsInterop": false
     }
   },
   "chunks": {
-    "chunk-2CLQ7TTZ": {
-      "file": "chunk-2CLQ7TTZ.js"
-    },
     "chunk-LE5NDSFD": {
       "file": "chunk-LE5NDSFD.js"
     }