@gct-paas/scss 0.1.6-dev.41 → 0.1.6-dev.42

package/README.md

@@ -1,3 +1,85 @@
+# @gct-paas/scss
+
+PaaS 平台样式框架包。提供 BEM 命名、主题 CSS 变量、全局 SCSS 入口及 TS 侧 `useNamespace` 辅助。被 `core-components`、`core-web`、`v-ben` 及上层 design/render 包依赖。
+
+> 本文档面向后续开发与 AI 模型阅读。下文「样式工具文档」章节为 SCSS functions/mixins API 参考。
+
+## 包信息
+
+| 项 | 值 |
+| --- | --- |
+| 包名 | `@gct-paas/scss` |
+| 入口 | `es/index.mjs`（类型：`es/index.d.ts`） |
+| 样式入口 | `@gct-paas/scss/style/global.scss`、`@gct-paas/scss/style/index.scss` |
+| peer | 无（宿主仅需 Vue 3 用于 TS 导出） |
+
+```ts
+import { useNamespace } from '@gct-paas/scss';
+// 或从 @gct-paas/core 再导出（推荐与 core 一致）
+import '@gct-paas/scss/style/index.scss';
+```
+
+---
+
+## 在 monorepo 中的位置
+
+```
+scss（样式基础层，无 _gct 依赖）
+ ├── core-components / v-ben / core-web
+ └── design / render 及其 *-web 层
+```
+
+规划中端侧包（`core-mobile` / `core-pad` 等）同样依赖本包。
+
+---
+
+## 依赖说明
+
+| 依赖 | 用途 |
+| --- | --- |
+| `normalize.css` | 浏览器样式重置 |
+| `vue` | TS 侧 `Namespace` / `useNamespace` 构建依赖 |
+
+---
+
+## 源码结构
+
+```
+packages/scss/
+├── src/utils/namespace/   # Namespace、useNamespace（与 core 逻辑对齐）
+├── style/                 # global.scss、index.scss、mixins、functions、tokens
+└── README.md              # 本文件（含下方 SCSS API 表）
+```
+
+---
+
+## 与 `_gct` 的关系
+
+**不挂载、不依赖 `_gct`。** 纯样式与 BEM 工具层。
+
+- **TS BEM**：组件内优先 `useNamespace('block')`（也可从 `@gct-paas/core` 导入，底层同源）
+- **SCSS BEM**：`@include b/e/m/when`，详见 `.agents/skills/gct-bem-best/SKILL.md`
+- **CSS 变量三步法**：define map → `set-component-css-var` → `getCssVar`
+
+---
+
+## 给后续模型的约束
+
+1. 组件样式类名走 BEM，禁止手写 `gct-xxx` 拼接。
+2. 全局样式通过 `@gct-paas/scss/style/global.scss` 或 `index.scss` 引入，不要复制 mixin 源码。
+3. 本包无运行时初始化，引入 SCSS/TS 即可。
+
+---
+
+## 本地命令
+
+```bash
+cd packages/scss
+npm run dev
+npm run build
+```
+
+---
 
 # 样式工具文档
 

package/dist/index.esm.min.js

@@ -1,2 +1,2 @@
-/*! @gct-paas/scss v0.1.6-dev.41 */
+/*! @gct-paas/scss v0.1.6-dev.42 */
 function t(e){return t="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t},t(e)}function e(e,r,n){return(r=function(e){var r=function(e){if("object"!=t(e)||!e)return e;var r=e[Symbol.toPrimitive];if(void 0!==r){var n=r.call(e,"string");if("object"!=t(n))return n;throw new TypeError("@@toPrimitive must return a primitive value.")}return String(e)}(e);return"symbol"==t(r)?r:r+""}(r))in e?Object.defineProperty(e,r,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[r]=n,e}function r(t,e,r,n,o){let s=`${t}-${e}`;return r&&(s+=`-${r}`),n&&(s+=`__${n}`),o&&(s+=`--${o}`),s}var n=class{constructor(t,r){e(this,"block",void 0),e(this,"namespace",void 0),this.block=t,this.namespace=r||"gct"}b(t=""){return r(this.namespace,this.block,t,"","")}e(t){return t?r(this.namespace,this.block,"",t,""):""}m(t){return t?r(this.namespace,this.block,"","",t):""}be(t,e){return t&&e?r(this.namespace,this.block,t,e,""):""}em(t,e){return t&&e?r(this.namespace,this.block,"",t,e):""}bm(t,e){return t&&e?r(this.namespace,this.block,t,"",e):""}bem(t,e,n){return t&&e&&n?r(this.namespace,this.block,t,e,n):""}is(t,e){return t&&e?`is-${t}`:""}cssVar(t){const e={};for(const r in t)t[r]&&(e[this.cssVarName(r)]=t[r]);return e}cssVarBlock(t){const e={};for(const r in t)t[r]&&(e[this.cssVarBlockName(r)]=t[r]);return e}cssVarName(t){return`--${this.namespace}-${t}`}cssVarBlockName(t){return`--${this.namespace}-${this.block}-${t}`}};function o(t){return new n(t)}export{n as Namespace,o as useNamespace};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gct-paas/scss",
-  "version": "0.1.6-dev.41",
+  "version": "0.1.6-dev.42",
   "type": "module",
   "loader": "dist/index.esm.min.js",
   "description": "paas 平台样式框架包",