smbls 3.4.9 → 3.5.0

package/README.md

@@ -1,7 +1,154 @@
-# Symbols
+# smbls
 
-Check out the [documentation page](https://symbols.app/developers).
+[![npm version](https://img.shields.io/npm/v/smbls.svg)](https://www.npmjs.com/package/smbls)
+[![npm downloads](https://img.shields.io/npm/dm/smbls.svg)](https://www.npmjs.com/package/smbls)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/smbls)](https://bundlephobia.com/package/smbls)
+[![license](https://img.shields.io/npm/l/smbls.svg)](https://github.com/symbo-ls/smbls/blob/main/LICENSE)
+[![node](https://img.shields.io/node/v/smbls.svg)](https://nodejs.org)
+[![ESM](https://img.shields.io/badge/module-ESM%20%7C%20CJS%20%7C%20IIFE-blue)](https://www.npmjs.com/package/smbls)
 
----
+> The main Symbols package — bundles the entire design system ecosystem into a single import.
 
-[![npm version](https://badge.fury.io/js/smbls.svg)](https://badge.fury.io/js/smbls)
+## Installation
+
+```bash
+npm install smbls
+```
+
+## What's Included
+
+This package re-exports everything from:
+
+| Package | Description |
+|---------|-------------|
+| `@domql/utils` | Utility functions |
+| `@symbo.ls/scratch` | CSS framework and methodology |
+| `@symbo.ls/emotion` | Emotion CSS-in-JS integration |
+| `@symbo.ls/default-config` | Default design system configuration |
+| `@symbo.ls/uikit` | Complete UI component library |
+| `@symbo.ls/smbls-utils` | Symbols-specific utilities |
+| `css-in-props` | CSS properties as props |
+| `attrs-in-props` | HTML attributes as props |
+
+It also includes the `@symbo.ls/cli` binary, `@symbo.ls/fetch`, `@symbo.ls/sync`, and `@domql/router`.
+
+## Quick Start
+
+### Initialize Design System
+
+```javascript
+import { init } from 'smbls'
+
+init({
+  color: {
+    primary: '#3B82F6',
+    gray: ['#1F2937', '#9CA3AF']  // [light, dark]
+  },
+  theme: {
+    primary: {
+      color: 'white',
+      background: 'primary',
+      ':hover': { opacity: '0.85' }
+    }
+  }
+})
+```
+
+### Create an Application
+
+```javascript
+import { create } from 'smbls'
+
+const App = {
+  extends: 'Flex',
+  flow: 'column',
+
+  Header: {
+    extends: 'Flex',
+    H1: { text: 'Hello Symbols!' }
+  },
+
+  Main: {
+    extends: 'Flex',
+    Button: {
+      text: 'Get Started',
+      theme: 'primary'
+    }
+  }
+}
+
+create(App, {
+  key: 'your-project-key'
+})
+```
+
+### Create Variants
+
+```javascript
+import { create, createAsync, createSync, createSkeleton } from 'smbls'
+
+// Standard — renders immediately
+create(App, options)
+
+// Async — renders first, then fetches remote config
+createAsync(App, options)
+
+// Sync — fetches remote config first, then renders
+await createSync(App, options)
+
+// Skeleton — resolves extends only, no full rendering
+createSkeleton(App, options)
+```
+
+## Init Options
+
+```javascript
+init(config, {
+  emotion: customEmotion,       // custom Emotion instance
+  useVariable: true,            // inject CSS custom properties
+  useReset: true,               // inject CSS reset
+  useFontImport: true,          // inject @font-face declarations
+  useIconSprite: true,          // create SVG icon sprite
+  useDocumentTheme: true,       // apply document-level theme
+  useSvgSprite: true,           // create SVG sprite sheet
+  useDefaultConfig: false,      // use built-in default config
+  globalTheme: 'dark',          // set global theme
+  verbose: false                // enable verbose logging
+})
+```
+
+## Additional Exports
+
+```javascript
+import {
+  // Re-initialization
+  reinit,        // re-apply config changes
+  applyCSS,      // inject global CSS
+  updateVars,    // update CSS custom properties
+
+  // Constants
+  DEFAULT_CONTEXT,
+  DESIGN_SYSTEM_OPTIONS,
+  ROUTER_OPTIONS
+} from 'smbls'
+```
+
+## CLI
+
+This package also provides the `smbls` CLI binary:
+
+```bash
+smbls init          # Initialize a project
+smbls start         # Start dev server
+smbls build         # Build for production
+smbls deploy        # Deploy to hosting
+smbls fetch         # Fetch remote config
+smbls push          # Push changes to platform
+smbls ask           # AI assistant
+```
+
+See the [@symbo.ls/cli](../cli/) package for the full command reference.
+
+## Documentation
+
+For full documentation visit [symbols.app/developers](https://symbols.app/developers).

package/dist/cjs/src/prepare.js

@@ -50,13 +50,11 @@ var utils = __toESM(require("./utilImports.js"), 1);
 var routerUtils = __toESM(require("@domql/router"), 1);
 // @preserve-env
 const prepareWindow = (context) => {
-  if (typeof window === "undefined") window = globalThis || {};
-  if (typeof document === "undefined") {
-    if (!window.document) window.document = globalThis.document || { body: {} };
-    document = window.document;
-  }
-  context.document = context.document || document;
-  context.window = context.window || window;
+  const win = typeof window !== "undefined" ? window : globalThis || {};
+  if (!win.document) win.document = { body: {} };
+  const doc = typeof document !== "undefined" ? document : win.document;
+  context.document = context.document || doc;
+  context.window = context.window || win;
   return context.window;
 };
 function onlyDotsAndNumbers(str) {

package/dist/esm/package.json

@@ -1 +1 @@
-{"name":"smbls","version":"3.4.8"}
+{"name":"smbls","version":"3.4.12"}

package/dist/esm/src/prepare.js

@@ -12,13 +12,11 @@ import * as utils from "./utilImports.js";
 import * as routerUtils from "@domql/router";
 // @preserve-env
 const prepareWindow = (context) => {
-  if (typeof window === "undefined") window = globalThis || {};
-  if (typeof document === "undefined") {
-    if (!window.document) window.document = globalThis.document || { body: {} };
-    document = window.document;
-  }
-  context.document = context.document || document;
-  context.window = context.window || window;
+  const win = typeof window !== "undefined" ? window : globalThis || {};
+  if (!win.document) win.document = { body: {} };
+  const doc = typeof document !== "undefined" ? document : win.document;
+  context.document = context.document || doc;
+  context.window = context.window || win;
   return context.window;
 };
 function onlyDotsAndNumbers(str) {

package/dist/iife/index.js

@@ -502,13 +502,11 @@ var Smbls = (() => {
   var uikit = __toESM(__require("@symbo.ls/uikit"));
   var routerUtils = __toESM(__require("@domql/router"));
   var prepareWindow = (context) => {
-    if (typeof window === "undefined") window = globalThis || {};
-    if (typeof document === "undefined") {
-      if (!window.document) window.document = globalThis.document || { body: {} };
-      document = window.document;
-    }
-    context.document = context.document || document;
-    context.window = context.window || window;
+    const win = typeof window !== "undefined" ? window : globalThis || {};
+    if (!win.document) win.document = { body: {} };
+    const doc = typeof document !== "undefined" ? document : win.document;
+    context.document = context.document || doc;
+    context.window = context.window || win;
     return context.window;
   };
   function onlyDotsAndNumbers(str) {
@@ -1063,13 +1061,11 @@ var Smbls = (() => {
   var uikit3 = __toESM(__require("@symbo.ls/uikit"), 1);
   var routerUtils2 = __toESM(__require("@domql/router"), 1);
   var prepareWindow2 = (context) => {
-    if (typeof window === "undefined") window = globalThis || {};
-    if (typeof document === "undefined") {
-      if (!window.document) window.document = globalThis.document || { body: {} };
-      document = window.document;
-    }
-    context.document = context.document || document;
-    context.window = context.window || window;
+    const win = typeof window !== "undefined" ? window : globalThis || {};
+    if (!win.document) win.document = { body: {} };
+    const doc = typeof document !== "undefined" ? document : win.document;
+    context.document = context.document || doc;
+    context.window = context.window || win;
     return context.window;
   };
   function onlyDotsAndNumbers2(str) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smbls",
-  "version": "3.4.9",
+  "version": "3.5.0",
   "license": "MIT",
   "repository": "https://github.com/symbo-ls/smbls",
   "gitHead": "9fc1b79b41cdc725ca6b24aec64920a599634681",
@@ -28,20 +28,20 @@
     "src"
   ],
   "dependencies": {
-    "@symbo.ls/emotion": "^3.4.9",
-    "@domql/report": "^3.4.9",
-    "@domql/router": "^3.4.9",
-    "@domql/utils": "^3.4.9",
-    "@symbo.ls/cli": "^3.4.9",
-    "@symbo.ls/default-config": "^3.4.9",
-    "@symbo.ls/fetch": "^3.4.9",
-    "@symbo.ls/scratch": "^3.4.9",
-    "@symbo.ls/sync": "^3.4.9",
-    "@symbo.ls/uikit": "^3.4.9",
-    "@symbo.ls/smbls-utils": "^3.4.9",
-    "attrs-in-props": "^3.4.9",
-    "css-in-props": "^3.4.9",
-    "domql": "^3.4.9"
+    "@symbo.ls/emotion": "^3.5.0",
+    "@domql/report": "^3.5.0",
+    "@domql/router": "^3.5.0",
+    "@domql/utils": "^3.5.0",
+    "@symbo.ls/cli": "^3.5.0",
+    "@symbo.ls/default-config": "^3.5.0",
+    "@symbo.ls/fetch": "^3.5.0",
+    "@symbo.ls/scratch": "^3.5.0",
+    "@symbo.ls/sync": "^3.5.0",
+    "@symbo.ls/uikit": "^3.5.0",
+    "@symbo.ls/smbls-utils": "^3.5.0",
+    "attrs-in-props": "^3.5.0",
+    "css-in-props": "^3.5.0",
+    "domql": "^3.5.0"
   },
   "publishConfig": {},
   "scripts": {

package/src/prepare.js

@@ -17,13 +17,11 @@ import * as routerUtils from '@domql/router'
 // @preserve-env
 
 export const prepareWindow = (context) => {
-  if (typeof window === 'undefined') window = globalThis || {} // eslint-disable-line
-  if (typeof document === 'undefined') {
-    if (!window.document) window.document = globalThis.document || { body: {} }
-    document = window.document // eslint-disable-line
-  }
-  context.document = context.document || document
-  context.window = context.window || window
+  const win = typeof window !== 'undefined' ? window : globalThis || {}
+  if (!win.document) win.document = { body: {} }
+  const doc = typeof document !== 'undefined' ? document : win.document
+  context.document = context.document || doc
+  context.window = context.window || win
   return context.window
 }