@iyulab/enterprise 0.4.0 → 0.6.0

package/README.md

@@ -50,8 +50,16 @@ import { FormSection, FormRow } from '@iyulab/enterprise'
 </FormSection>
 ```
 
-- `FormRow`는 기본 2컬럼 그리드입니다. 한 칸을 차지하려면 `full`을 씁니다.
-- (3컬럼 이상 등 커스텀 레이아웃이 필요하면 현재는 직접 CSS grid를 쓰세요. `columns` prop 확장은 로드맵에 있습니다.)
+- `FormRow`는 기본 2컬럼 그리드입니다. 한 칸을 차지하려면 `full`을, 다른 열 수가 필요하면 `columns`를 씁니다.
+- 두 컴포넌트 모두 `className`·`style`을 받아 기본값 **뒤에** 병합합니다 — 블록을 복제하지 않고 조정하는 정규 경로입니다. `FormSection`은 제목 줄만 바꾸는 `titleStyle`도 받습니다.
+
+```tsx
+<FormRow columns={3}>…</FormRow>
+<FormSection title="기본 정보" style={{ marginBottom: 32 }}>…</FormSection>
+```
+
+> 이 계층이 무엇을 소유하고 무엇을 소유하지 않는지, 새 패턴이 언제 추가되는지는
+> **[LOB 계층 헌장](./docs/lob-layers.md)** 이 정합니다. 패턴을 제안하기 전에 읽어 주세요.
 
 ### API 설정
 

package/dist/FormRow.d.ts

@@ -1,5 +1,17 @@
-import { ReactNode } from 'react';
-export declare function FormRow({ children, full, }: {
+import { CSSProperties, ReactNode } from 'react';
+/**
+ * L2 폼 행 — 기본 2열, `full` 이면 1열.
+ *
+ * 오버라이드 계약(docs/lob-layers.md §2)에 따라 `className`·`style` 을 받아 병합한다.
+ * `columns` 는 2열 고정이 맞지 않는 소비자가 **컴포넌트를 복제하지 않고** 조정하는 경로다
+ * — 복제가 시작되면 이 계층은 쓰기 전보다 나쁜 상태를 만든다.
+ */
+export declare function FormRow({ children, full, columns, className, style, }: {
     children: ReactNode;
+    /** 한 행 전체를 한 칸으로 쓴다. `columns` 보다 우선한다. */
     full?: boolean;
-}): import("react/jsx-runtime").JSX.Element;
+    /** 열 수. 기본 2. */
+    columns?: number;
+    className?: string;
+    style?: CSSProperties;
+}): any;

package/dist/FormSection.d.ts

@@ -1,5 +1,17 @@
-import { ReactNode } from 'react';
-export declare function FormSection({ title, children, }: {
-    title: string;
+import { CSSProperties, ReactNode } from 'react';
+/**
+ * L2 폼 블록 — 제목이 붙은 필드 묶음.
+ *
+ * 오버라이드 계약(docs/lob-layers.md §2): 구조는 두고 **children 치환 + prop** 으로 바꾼다.
+ * ⚠기본 스타일은 병합 가능한 형태로만 둔다 — 호출자의 `style` 이 뒤에 오므로 필요한
+ * 항목만 골라 덮을 수 있다. 인라인으로 굳혀 두면 소비자 CSS 가 이길 수 없어(`!important`
+ * 외) 계약이 원천적으로 무효가 된다.
+ */
+export declare function FormSection({ title, children, className, style, titleStyle, }: {
+    title: ReactNode;
     children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+    className?: string;
+    style?: CSSProperties;
+    /** 제목 줄만 따로 조정할 때. 블록을 통째로 갈아엎지 않기 위한 훅이다. */
+    titleStyle?: CSSProperties;
+}): any;

package/dist/index.js

@@ -1,19 +1,33 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { HttpClient } from "@iyulab/http-client";
+import buildQuery from "odata-query";
 //#region src/FormSection.tsx
-function FormSection({ title, children }) {
+/**
+* L2 폼 블록 — 제목이 붙은 필드 묶음.
+*
+* 오버라이드 계약(docs/lob-layers.md §2): 구조는 두고 **children 치환 + prop** 으로 바꾼다.
+* ⚠기본 스타일은 병합 가능한 형태로만 둔다 — 호출자의 `style` 이 뒤에 오므로 필요한
+* 항목만 골라 덮을 수 있다. 인라인으로 굳혀 두면 소비자 CSS 가 이길 수 없어(`!important`
+* 외) 계약이 원천적으로 무효가 된다.
+*/
+function FormSection({ title, children, className, style, titleStyle }) {
 	return /* @__PURE__ */ jsxs("div", {
-		style: { marginBottom: "20px" },
+		className,
+		style: {
+			marginBottom: "20px",
+			...style
+		},
 		children: [/* @__PURE__ */ jsx("div", {
 			style: {
 				fontSize: "11px",
 				fontWeight: 700,
 				textTransform: "uppercase",
 				letterSpacing: "0.5px",
-				color: "var(--u-blue-600, #1E88E5)",
+				color: "color-mix(in srgb, var(--u-primary-color, #1E88E5) 85%, black)",
 				paddingBottom: "6px",
 				borderBottom: "1px solid var(--u-border-color-weak, #EEEEEE)",
-				marginBottom: "10px"
+				marginBottom: "10px",
+				...titleStyle
 			},
 			children: title
 		}), /* @__PURE__ */ jsx("div", {
@@ -28,16 +42,29 @@ function FormSection({ title, children }) {
 }
 //#endregion
 //#region src/FormRow.tsx
-function FormRow({ children, full }) {
+/**
+* L2 폼 행 — 기본 2열, `full` 이면 1열.
+*
+* 오버라이드 계약(docs/lob-layers.md §2)에 따라 `className`·`style` 을 받아 병합한다.
+* `columns` 는 2열 고정이 맞지 않는 소비자가 **컴포넌트를 복제하지 않고** 조정하는 경로다
+* — 복제가 시작되면 이 계층은 쓰기 전보다 나쁜 상태를 만든다.
+*/
+function FormRow({ children, full, columns = 2, className, style }) {
 	if (full) return /* @__PURE__ */ jsx("div", {
-		style: { width: "100%" },
+		className,
+		style: {
+			width: "100%",
+			...style
+		},
 		children
 	});
 	return /* @__PURE__ */ jsx("div", {
+		className,
 		style: {
 			display: "grid",
-			gridTemplateColumns: "1fr 1fr",
-			gap: "8px"
+			gridTemplateColumns: `repeat(${columns}, 1fr)`,
+			gap: "8px",
+			...style
 		},
 		children
 	});
@@ -154,7 +181,7 @@ var DateHelper = class {
 	static getDaysDifference(startDate, endDate) {
 		const start = typeof startDate === "string" ? new Date(startDate) : startDate;
 		const timeDiff = (typeof endDate === "string" ? new Date(endDate) : endDate).getTime() - start.getTime();
-		return Math.ceil(timeDiff / (1e3 * 3600 * 24));
+		return Math.ceil(timeDiff / 864e5);
 	}
 	/**
 	* Calculate days from now to target date
@@ -512,262 +539,7 @@ var ApiConfig = class {
 		this._apiPrefix = "api";
 		this._isDevelopment = void 0;
 	}
-}, e = [
-	"eq",
-	"ne",
-	"gt",
-	"ge",
-	"lt",
-	"le"
-], t = [
-	"and",
-	"or",
-	"not"
-], n = ["any", "all"], r = [
-	"startswith",
-	"endswith",
-	"contains",
-	"matchespattern"
-], i = [
-	"expand",
-	"levels",
-	"select",
-	"skip",
-	"top",
-	"count",
-	"orderby",
-	"filter"
-], a = /\((.*)\)/, o = /(?!indexof)\((\w+)\)/;
-function g(e, t) {
-	if (t) {
-		let n = e === "", r = o.test(e), i = a.test(e);
-		return n ? t : r ? y(e, t, o) : i ? y(e, t, a) : `${t}/${e}`;
-	}
-	return e;
-}
-function _(e) {
-	return t.indexOf(e) !== -1;
-}
-function v(e) {
-	return `not (${e.join(" and ")})`;
-}
-function y(e, t, n) {
-	return e.replace(n, (e, n) => n.trim() === "" ? `(${t})` : `(${t}/${n.trim()})`);
-}
-function b(e, t, n = []) {
-	return `${e} eq ${w(t, n)}`;
-}
-function x({ key: e, value: t, aliases: n, propPrefix: r }) {
-	let i = [], a = e, o = _(a), s = t.map((e) => O(e, n, r)).filter((e) => e).map((e) => o ? `(${e})` : e);
-	return s.length && (o ? a === "not" ? i.push(v(s)) : i.push(`(${s.join(` ${a} `)})`) : i.push(s.join(` ${a} `))), i;
-}
-function S({ propName: e, value: t }) {
-	let n = [], r = e, i = Object.keys(t).map((e) => k({ [e]: t[e] }));
-	return i.length && (r === "not" ? n.push(v(i)) : n.push(`(${i.join(` ${r} `)})`)), n;
-}
-function C({ key: i, propName: a, value: o, aliases: s }) {
-	let c = [];
-	return "type" in o ? c.push(b(a, o, s)) : Object.keys(o).forEach((l) => {
-		if (o[l] !== void 0) if (e.indexOf(l) !== -1) c.push(`${a} ${l} ${w(o[l], s)}`);
-		else if (t.indexOf(l) !== -1) Array.isArray(o[l]) ? c.push(o[l].map((e) => "(" + O(e, s, a) + ")").join(` ${l} `)) : c.push("(" + O(o[l], s, a) + ")");
-		else if (n.indexOf(l) !== -1) {
-			let e = A({
-				lambdaParameter: i.toLowerCase(),
-				value: o[l],
-				op: l,
-				propName: a,
-				aliases: s
-			});
-			e && c.push(e);
-		} else if (l === "has") c.push(`${a} ${l} ${w(o[l], s)}`);
-		else if (l === "in") {
-			let e = Array.isArray(o[l]) ? o[l] : o[l].value.map((e) => ({
-				type: o[l].type,
-				value: e
-			}));
-			c.push(a + " in (" + e.map((e) => w(e, s)).join(",") + ")");
-		} else if (r.indexOf(l) !== -1) c.push(`${l}(${a},${w(o[l], s)})`);
-		else {
-			let e = /\/not/g.test(a), t = e ? a.replace(/\/not/g, "") : a, n = e ? v([O({ [l]: o[l] }, s, t)]) : O({ [l]: o[l] }, s, t);
-			n && c.push(n);
-		}
-	}), c;
-}
-function w(e, t) {
-	if (typeof e == "string") return `'${D(e)}'`;
-	if (e instanceof Date) return e.toISOString();
-	if (typeof e == "number") return e;
-	if (Array.isArray(e)) return `[${e.map((e) => w(e)).join(",")}]`;
-	if (e === null) return e;
-	if (typeof e == "object") switch (e.type) {
-		case "raw":
-		case "guid": return e.value;
-		case "duration": return `duration'${e.value}'`;
-		case "binary": return `binary'${e.value}'`;
-		case "alias": return Array.isArray(t) && t.push(e), `@${e.name}`;
-		case "json": return escape(JSON.stringify(e.value));
-		case "decimal": return `${e.value}M`;
-		default: return Object.entries(e).filter(([, e]) => e !== void 0).map(([e, n]) => `${e}=${w(n, t)}`).join(",");
-	}
-	return e;
-}
-function T(e, t, n, r) {
-	return `${r}/${n}(${e}: ${e} ${n == "all" ? "ne" : "eq"} '${t}')`;
-}
-function E(e) {
-	return e.replace(/'/g, "''");
-}
-function D(e) {
-	return encodeURIComponent(E(e));
-}
-function O(e = {}, t = [], n = "") {
-	return (Array.isArray(e) ? e : [e]).reduce((e, r) => {
-		if (r) {
-			let i = k(r, t, n);
-			i && e.push(i);
-		}
-		return e;
-	}, []).join(" and ");
-}
-function k(e = {}, t = [], n = "") {
-	let r = "";
-	return typeof e == "string" ? r = e : e && typeof e == "object" && (r = Object.keys(e).reduce((r, i) => {
-		let a = e[i];
-		if (a === void 0) return r;
-		let o = i === "", s = g(i, n);
-		if (o && Array.isArray(a)) return r.concat(a.map((e) => b(s, e)));
-		let c = [
-			"number",
-			"string",
-			"boolean"
-		].indexOf(typeof a) !== -1 || a instanceof Date || a === null, l = Array.isArray(a), u = typeof a == "object";
-		if (c) r.push(b(s, a, t));
-		else if (l) r.push(...x({
-			key: i,
-			value: a,
-			aliases: t,
-			propPrefix: n
-		}));
-		else if (_(s)) r.push(...S({
-			propName: s,
-			value: a
-		}));
-		else if (u) r.push(...C({
-			key: i,
-			propName: s,
-			value: a,
-			aliases: t
-		}));
-		else throw Error(`Unexpected value type: ${a}`);
-		return r;
-	}, []).join(" and ")), r;
-}
-function A({ lambdaParameter: e, value: t, op: n, propName: r, aliases: i }) {
-	let a = "";
-	if (typeof t == "string" || t instanceof String) a = T(e, t, n, r);
-	else if (t) {
-		let o = O(Array.isArray(t) ? t.reduce((e, t) => t.hasOwnProperty("") ? (e.hasOwnProperty("") || (e[""] = []), e[""].push(t[""]), e) : {
-			...e,
-			...t
-		}, {}) : t, i, e);
-		a = `${r}/${n}(${o ? `${e}:${o}` : ""})`;
-	}
-	return a;
-}
-function j(e) {
-	if (typeof e == "number") return e;
-	if (typeof e == "string") return e.indexOf("/") === -1 ? e : e.split("/").reverse().reduce((e, t, n, r) => n === 0 ? `$expand=${t}` : n === r.length - 1 ? `${t}(${e})` : `$expand=${t}(${e})`, "");
-	if (Array.isArray(e)) return `${e.map((e) => j(e)).join(",")}`;
-	if (typeof e == "object") {
-		let t = Object.keys(e);
-		return t.some((e) => i.indexOf(e.toLowerCase()) !== -1) ? t.map((t) => {
-			let n;
-			switch (t) {
-				case "filter":
-					n = O(e[t]);
-					break;
-				case "orderBy":
-					n = F(e[t]);
-					break;
-				case "levels":
-				case "count":
-				case "skip":
-				case "top":
-					n = `${e[t]}`;
-					break;
-				default: n = j(e[t]);
-			}
-			return `$${t.toLowerCase()}=${n}`;
-		}).join(";") : t.map((t) => {
-			let n = j(e[t]);
-			return n ? `${t}(${n})` : t;
-		}).join(",");
-	}
-	return "";
-}
-function M(e) {
-	return (Array.isArray(e) ? e : [e]).reduce((e, t) => {
-		for (let n of Object.keys(t)) switch (n) {
-			case "aggregate": {
-				let r = t[n];
-				r && e.push(`aggregate(${N(r)})`);
-				break;
-			}
-			case "filter": {
-				let r = t[n];
-				if (r) {
-					let t = O(r);
-					t && e.push(`filter(${t})`);
-				}
-				break;
-			}
-			case "groupBy": {
-				let r = t[n];
-				r && e.push(`groupby(${P(r)})`);
-				break;
-			}
-			default: throw Error(`Unsupported transform: ${n}`);
-		}
-		return e;
-	}, []).join("/") || void 0;
-}
-function N(e) {
-	return (Array.isArray(e) ? e : [e]).map((e) => typeof e == "string" ? e : Object.keys(e).map((t) => {
-		let n = e[t];
-		if (!n.with && n.as) return `${t} as ${n.as}`;
-		if (!n.with) throw Error(`'with' property required for '${t}'`);
-		if (!n.as) throw Error(`'as' property required for '${t}'`);
-		return `${t} with ${n.with} as ${n.as}`;
-	})).join(",");
-}
-function P(e) {
-	if (!e.properties) throw Error("'properties' property required for groupBy");
-	let t = `(${e.properties.join(",")})`;
-	return e.transform && (t += `,${M(e.transform)}`), t;
-}
-function F(e, t = "") {
-	return Array.isArray(e) ? e.map((e) => Array.isArray(e) && e.length === 2 && ["asc", "desc"].indexOf(e[1]) !== -1 ? e.join(" ") : e).map((e) => `${t}${String(e)}`).join(",") : typeof e == "object" ? Object.entries(e).map(([e, t]) => F(t, `${e}/`)).map((e) => `${t}${e}`).join(",") : `${t}${String(e)}`;
-}
-function I(e, t) {
-	let n = Object.getOwnPropertyNames(t).filter((e) => t[e] !== void 0 && t[e] !== "").map((e) => `${e}=${t[e]}`);
-	return n.length ? `${e}?${n.join("&")}` : e;
-}
-function L({ select: e, search: t, skiptoken: n, format: r, top: i, skip: a, filter: o, transform: s, orderBy: c, key: l, count: u, expand: d, action: f, func: p } = {}) {
-	let m = "", h = [], g = {};
-	if (l != null && (m += `(${w(l, h)})`), (o || typeof u == "object") && (g.$filter = O(typeof u == "object" ? u : o, h)), s && (g.$apply = M(s)), d && (g.$expand = j(d)), c && (g.$orderby = F(c)), u && (typeof u == "boolean" ? g.$count = !0 : m += "/$count"), typeof i == "number" && (g.$top = i), typeof a == "number" && (g.$skip = a), f && (m += `/${f}`), p) {
-		if (typeof p == "string") m += `/${p}`;
-		else if (typeof p == "object") {
-			let [e] = Object.keys(p), t = w(p[e], h);
-			m += `/${e}`, t !== "" && (m += `(${t})`);
-		}
-	}
-	return h.length > 0 && Object.assign(g, h.reduce((e, t) => Object.assign(e, { [`@${t.name}`]: w(t.value) }), {})), t && (g.$search = encodeURIComponent(t)), I(m, {
-		$select: e,
-		$skiptoken: n,
-		$format: r,
-		...g
-	});
-}
+};
 //#endregion
 //#region src/data/ODataService.ts
 /**
@@ -894,7 +666,7 @@ function createODataService(config) {
 		return res.json();
 	}
 	async function odataCount(entity, filter) {
-		const qs = L({
+		const qs = buildQuery({
 			filter,
 			top: 0,
 			count: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/enterprise",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Enterprise utilities and components for iyulab framework",
   "keywords": [
     "enterprise",
@@ -32,17 +32,17 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@iyulab/components": "^1.1.1",
-    "@iyulab/data-components": "^0.6.1",
-    "@iyulab/http-client": "^0.9.0",
-    "@iyulab/modern-app": "^0.3.7",
-    "odata-query": "^8.0.7"
+    "@iyulab/http-client": "^0.10.0",
+    "odata-query": "^8.1.0"
   },
   "devDependencies": {
-    "@types/node": "^25.8.0",
+    "@types/node": "^26.1.1",
     "typescript": "^5.9.3",
-    "vite": "^8.0.13",
-    "vite-plugin-dts": "^5.0.0",
-    "vitest": "^3.0.0"
+    "vite": "^8.1.4",
+    "vite-plugin-dts": "^5.0.3",
+    "vitest": "^4.1.10"
+  },
+  "peerDependencies": {
+    "react": ">=18"
   }
 }