@iyulab/modern-app 0.11.0 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,62 @@
 # Changelog
 
+## [0.12.0] - 2026-08-07
+
+### Added
+
+- **`u-info-field` now accepts `value` as a plain HTML attribute**, not just a property binding.
+  `value` was declared `attribute: false`, so `<u-info-field value="42">` was silently ignored —
+  no error, no warning, the field just stayed blank. Property binding (`.value=${x}`) is
+  unaffected and still accepts any type (numbers, dates); the attribute converter only applies
+  when the value arrives as a string attribute.
+
+- **Sidebar links can point outside the app.** `SidebarLinkConfig` accepted only `href` and could
+  not say whether that link was a SPA route. `SidebarLink` rendered a `<u-link>` without passing
+  `target` either, so even the one escape the lower layer offered was unreachable from config.
+  A same-origin help site placed in the menu had its click intercepted by the router and fell
+  through to not-found.
+
+  Real menus are not all SPA screens: a documentation site, a report endpoint, an admin console
+  and a legacy page sit in the same list. `navigate: 'document'` hands the click to the browser;
+  `target` is passed through for new-tab links.
+
+  ```ts
+  { type: 'link', icon: 'help', label: 'Help', href: '/help/', navigate: 'document' }
+  ```
+
+  The entry stays an anchor, which is the point — the alternative was a `type: 'button'` with an
+  imperative navigation, which loses middle-click and Ctrl+click, address copying, the link role
+  for screen readers, and `pattern`-based highlighting, and cannot sit inside a section or group.
+
+### Changed
+
+- **`@iyulab/router` requirement raised to `^0.11.0`.** The sidebar `navigate: 'document'` support
+  above needs `<u-link navigate="document">`, added in that release; `^0.10.2` does not resolve to
+  it (a 0.x range's minor segment behaves like a major boundary under semver).
+
+### Fixed
+
+- **`sideEffects` omitted the source-resolved entry barrel.** The allowlist covered the component
+  and layout modules but not the barrel that `exports["."]` resolves to. The published artifacts
+  were unaffected — the shipped allowlist already covered them — but a consumer resolving this
+  package from source (a workspace sibling) could have the barrel elided, dropping the element
+  registrations it pulls in. The failure is silent: no error, and unregistered custom elements
+  render nothing. The source-form entry points are now declared alongside the artifact ones.
+
+## [0.11.1] - 2026-08-04
+
+### Fixed
+
+- 🔴**`@iyulab/components` 의존 범위가 실제로 필요한 것보다 느슨했다** — `^1.21.0` 이었으나
+  `0.11.0` 의 **내비 아이콘 폴백은 `u-icon[fallback]`(1.24.0)** 을 쓴다. 범위가 그것을
+  «요구»하지 않으므로, components 를 `1.22.x` 에 고정한 소비자에게는 폴백이 **조용히
+  동작하지 않는다** — 아이콘 없는 그룹 항목이 접힌 사이드바에서 다시 빈 버튼이 된다.
+  ⇒ `^1.24.0` 으로 좁혔다.
+
+  ★**이것을 드러낸 것은 CI 였다** — `0.11.0` 태그 직전의 main 빌드가 아직 게시되지 않은
+  `1.24.0` 대신 `1.23.0` 을 설치했고, 그 조합에서 폴백 회귀 7건이 실패했다.
+  ***«범위가 담는다»와 «범위가 요구한다»는 다르다.***
+
 ## [0.11.0] - 2026-08-04
 
 ### Fixed

package/dist/_virtual/{_@oxc-project_runtime@0.142.0 → _@oxc-project_runtime@0.143.0}/helpers/esm/decorate.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.142.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.143.0/helpers/esm/decorate.js
 function e(e, t, n, r) {
 	var i = arguments.length, a = i < 3 ? t : r === null ? r = Object.getOwnPropertyDescriptor(t, n) : r, o;
 	if (typeof Reflect == "object" && typeof Reflect.decorate == "function") a = Reflect.decorate(e, t, n, r);

package/dist/_virtual/{_@oxc-project_runtime@0.142.0 → _@oxc-project_runtime@0.143.0}/helpers/esm/decorateMetadata.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.142.0/helpers/esm/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.143.0/helpers/esm/decorateMetadata.js
 function e(e, t) {
 	if (typeof Reflect == "object" && typeof Reflect.metadata == "function") return Reflect.metadata(e, t);
 }

package/dist/components/ActionBar.js

@@ -1,5 +1,5 @@
-import e from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorateMetadata.js";
-import t from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorate.js";
+import e from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.js";
+import t from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.js";
 import { StyledElement as n } from "../internals/StyledElement.js";
 import { slotHasContent as r } from "../internals/slotted.js";
 import { styles as i } from "./ActionBar.styles.js";

package/dist/components/EmptyState.js

@@ -1,5 +1,5 @@
-import e from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorateMetadata.js";
-import t from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorate.js";
+import e from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.js";
+import t from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.js";
 import { StyledElement as n } from "../internals/StyledElement.js";
 import { getLocaleStrings as r } from "../internals/locale.js";
 import { slotHasContent as i } from "../internals/slotted.js";

package/dist/components/GroupBox.js

@@ -1,5 +1,5 @@
-import e from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorateMetadata.js";
-import t from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorate.js";
+import e from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.js";
+import t from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.js";
 import { StyledElement as n } from "../internals/StyledElement.js";
 import { slotHasContent as r } from "../internals/slotted.js";
 import { styles as i } from "./GroupBox.styles.js";

package/dist/components/InfoField.d.ts

@@ -25,6 +25,9 @@ export declare class InfoField extends StyledElement<ElementParts> {
     /**
      * 값. `null`/`undefined`/빈 문자열이면 `blank` 문구로 대체된다.
      * ⚠`0`·`false` 는 **대체되지 않는다** — 값이기 때문이다.
+     * 속성(`value="…"`)과 프로퍼티(`.value=`) 둘 다 받는다 — HTML 속성은 항상 문자열이라
+     * `type: String` 변환기가 붙어도 `.value=${order.quantity}` 같은 비-문자열 프로퍼티
+     * 바인딩은 그대로 통과한다(변환기는 속성 파싱에만 관여한다). 렌더는 항상 `String(value)`.
      */
     value?: unknown;
     /** "아직 없음"을 나타낼 문구. */

package/dist/components/InfoField.js

@@ -1,5 +1,5 @@
-import e from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorateMetadata.js";
-import t from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorate.js";
+import e from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.js";
+import t from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.js";
 import { StyledElement as n } from "../internals/StyledElement.js";
 import { styles as r } from "./InfoField.styles.js";
 import { html as i } from "lit";
@@ -28,6 +28,6 @@ var c = class extends n {
     `;
 	}
 };
-t([o({ type: String }), e("design:type", Object)], c.prototype, "label", void 0), t([o({ attribute: !1 }), e("design:type", Object)], c.prototype, "value", void 0), t([o({ type: String }), e("design:type", Object)], c.prototype, "blank", void 0), t([o({ type: Boolean }), e("design:type", Object)], c.prototype, "numeric", void 0), c = t([a("u-info-field")], c);
+t([o({ type: String }), e("design:type", Object)], c.prototype, "label", void 0), t([o({ type: String }), e("design:type", Object)], c.prototype, "value", void 0), t([o({ type: String }), e("design:type", Object)], c.prototype, "blank", void 0), t([o({ type: Boolean }), e("design:type", Object)], c.prototype, "numeric", void 0), c = t([a("u-info-field")], c);
 //#endregion
 export { c as InfoField, s as isBlank };

package/dist/components/InfoSection.d.ts

@@ -10,7 +10,7 @@ type ElementParts = 'host' | 'grid';
  *
  * ```html
  * <u-info-section>
- *   <u-info-field label="파트" value="일반"></u-info-field>
+ *   <u-info-field label="파트" .value=${'일반'}></u-info-field>
  *   <u-info-field label="부수" .value=${0} numeric></u-info-field>
  * </u-info-section>
  * ```

package/dist/components/InfoSection.js

@@ -1,5 +1,5 @@
-import e from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorateMetadata.js";
-import t from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorate.js";
+import e from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.js";
+import t from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.js";
 import { StyledElement as n } from "../internals/StyledElement.js";
 import { styles as r } from "./InfoSection.styles.js";
 import { html as i } from "lit";

package/dist/components/PageHeader.js

@@ -1,5 +1,5 @@
-import e from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorateMetadata.js";
-import t from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorate.js";
+import e from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.js";
+import t from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.js";
 import { StyledElement as n } from "../internals/StyledElement.js";
 import { getLocaleStrings as r } from "../internals/locale.js";
 import { slotHasContent as i } from "../internals/slotted.js";

package/dist/components/SidebarButton.js

@@ -1,5 +1,5 @@
-import e from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorateMetadata.js";
-import t from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorate.js";
+import e from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.js";
+import t from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.js";
 import { StyledElement as n } from "../internals/StyledElement.js";
 import { DEFAULT_NAV_ICON as r } from "../internals/nav-icon.js";
 import { styles as i } from "./SidebarButton.styles.js";

package/dist/components/SidebarGroup.js

@@ -1,5 +1,5 @@
-import e from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorateMetadata.js";
-import t from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorate.js";
+import e from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.js";
+import t from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.js";
 import { StyledElement as n } from "../internals/StyledElement.js";
 import { DEFAULT_NAV_ICON as r } from "../internals/nav-icon.js";
 import { SidebarLink as i } from "./SidebarLink.js";

package/dist/components/SidebarLink.d.ts

@@ -10,6 +10,25 @@ export interface SidebarLinkConfig extends SidebarPermissionGuard {
     href: string;
     pattern?: string | URLPattern;
     styles?: StyleMap<ElementParts>;
+    /**
+     * 라우터가 가로채지 않고 브라우저의 문서 이동에 맡긴다 — 같은 오리진의 비-SPA 경로용.
+     *
+     * 실무 앱의 메뉴에는 SPA 화면만 서지 않는다: 도움말/문서 사이트, 리포트 출력 엔드포인트,
+     * 관리 콘솔, 레거시 페이지가 같은 목록에 선다. 종전에는 그것을 **표현할 수 없어서**
+     * 메뉴에 걸면 라우터가 클릭을 가로채 not-found 로 떨어졌다.
+     *
+     * ```ts
+     * { type: 'link', label: '도움말', href: '/help/', navigate: 'document' }
+     * ```
+     */
+    navigate?: 'router' | 'document';
+    /**
+     * 앵커 `target`. 새 탭으로 열 때 쓴다.
+     *
+     * ⚠**`navigate` 를 대신하지 못한다** — `_blank` 는 **새 탭을 강제**하므로 「같은 탭에서
+     * 다른 문서로」를 표현할 수 없다. 그것이 종전에 유일한 탈출구였고, 그래서 부족했다.
+     */
+    target?: '_self' | '_blank';
 }
 /**
  * SidebarLink 컴포넌트는 계층형 네비게이션 아이템을 표시합니다.
@@ -29,6 +48,10 @@ export declare class SidebarLink extends StyledElement<ElementParts> {
     href?: string;
     /** 네비게이션 패턴 매칭 */
     pattern?: string | URLPattern;
+    /** 라우터가 가로채지 않고 브라우저 문서 이동에 맡긴다 (같은 오리진의 비-SPA 경로) */
+    navigate?: 'router' | 'document';
+    /** 앵커 target — 새 탭으로 열 때 */
+    target?: '_self' | '_blank';
     render(): import('lit-html').TemplateResult<1>;
 }
 export {};

package/dist/components/SidebarLink.js

@@ -1,5 +1,5 @@
-import e from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorateMetadata.js";
-import t from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorate.js";
+import e from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.js";
+import t from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.js";
 import { StyledElement as n } from "../internals/StyledElement.js";
 import { DEFAULT_NAV_ICON as r } from "../internals/nav-icon.js";
 import { styles as i } from "./SidebarLink.styles.js";
@@ -16,7 +16,11 @@ var c = class extends n {
 	}
 	render() {
 		return a`
-      <u-link .href=${this.href || "#"}>
+      <u-link
+        .href=${this.href || "#"}
+        .navigate=${this.navigate}
+        .target=${this.target}
+      >
         <div class="container" part="base" ?compact=${this.compact}>
           <u-icon part="icon"
             .name=${this.icon}
@@ -33,6 +37,6 @@ var c = class extends n {
 t([s({
 	type: Boolean,
 	reflect: !0
-}), e("design:type", Object)], c.prototype, "selected", void 0), t([s({ type: Boolean }), e("design:type", Object)], c.prototype, "compact", void 0), t([s({ type: String }), e("design:type", String)], c.prototype, "icon", void 0), t([s({ type: String }), e("design:type", Object)], c.prototype, "label", void 0), t([s({ type: String }), e("design:type", String)], c.prototype, "href", void 0), t([s({ type: String }), e("design:type", Object)], c.prototype, "pattern", void 0), c = t([o("u-sidebar-link")], c);
+}), e("design:type", Object)], c.prototype, "selected", void 0), t([s({ type: Boolean }), e("design:type", Object)], c.prototype, "compact", void 0), t([s({ type: String }), e("design:type", String)], c.prototype, "icon", void 0), t([s({ type: String }), e("design:type", Object)], c.prototype, "label", void 0), t([s({ type: String }), e("design:type", String)], c.prototype, "href", void 0), t([s({ type: String }), e("design:type", Object)], c.prototype, "pattern", void 0), t([s({ type: String }), e("design:type", String)], c.prototype, "navigate", void 0), t([s({ type: String }), e("design:type", String)], c.prototype, "target", void 0), c = t([o("u-sidebar-link")], c);
 //#endregion
 export { c as SidebarLink };

package/dist/components/SidebarSection.js

@@ -1,5 +1,5 @@
-import e from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorateMetadata.js";
-import t from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorate.js";
+import e from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.js";
+import t from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.js";
 import { StyledElement as n } from "../internals/StyledElement.js";
 import { styles as r } from "./SidebarSection.styles.js";
 import { html as i } from "lit";

package/dist/internals/StyledElement.js

@@ -1,5 +1,5 @@
-import e from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorateMetadata.js";
-import t from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorate.js";
+import e from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.js";
+import t from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.js";
 import { property as n } from "lit/decorators.js";
 import { UElement as r } from "@iyulab/components/dist/components/UElement.js";
 //#region src/internals/StyledElement.ts
@@ -12,11 +12,13 @@ var i = class extends r {
 	}
 	applyToParts(e) {
 		let t = Object.entries(e);
-		for (let [e, n] of t) if (n) if (e === "host") this.assignToObject(this, n);
-		else {
-			let t = this.renderRoot?.querySelector(`[part="${String(e)}"]`);
-			if (!t) continue;
-			this.assignToObject(t, n);
+		for (let [e, n] of t) if (n) {
+			if (e === "host") this.assignToObject(this, n);
+			else {
+				let t = this.renderRoot?.querySelector(`[part="${String(e)}"]`);
+				if (!t) continue;
+				this.assignToObject(t, n);
+			}
 		}
 	}
 	assignToObject(e, t) {

package/dist/layouts/SidebarLayout.js

@@ -1,7 +1,7 @@
 import { app as e } from "../App.js";
 import { filterSidebarItems as t } from "./filterSidebarItems.js";
-import n from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorateMetadata.js";
-import r from "../_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorate.js";
+import n from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.js";
+import r from "../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.js";
 import { StyledElement as i } from "../internals/StyledElement.js";
 import "../components/SidebarSection.js";
 import "../components/SidebarLink.js";
@@ -172,6 +172,8 @@ var g = class extends i {
           .label="${e.label}"
           .href="${e.href}"
           .pattern="${e.pattern}"
+          .navigate="${e.navigate}"
+          .target="${e.target}"
           .styles="${e.styles}"
         ></u-sidebar-link>
       `;

package/dist/layouts/filterSidebarItems.js

@@ -5,14 +5,16 @@ function e(e, t) {
 function t(n, r) {
 	if (!r) return n;
 	let i = r, a = [];
-	for (let r of n) if (r && e(r, i)) if (r.type === "section" || r.type === "group") {
-		let e = t(r.items, i);
-		if (e.length === 0) continue;
-		a.push({
-			...r,
-			items: e
-		});
-	} else a.push(r);
+	for (let r of n) if (r && e(r, i)) {
+		if (r.type === "section" || r.type === "group") {
+			let e = t(r.items, i);
+			if (e.length === 0) continue;
+			a.push({
+				...r,
+				items: e
+			});
+		} else a.push(r);
+	}
 	return a;
 }
 //#endregion

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/modern-app",
   "description": "web-framework by iyulab based on lit-element",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "keywords": [
     "iyulab",
     "web-framework",
@@ -23,6 +23,17 @@
   ],
   "type": "module",
   "types": "dist/index.d.ts",
+  "engines": {
+    "node": ">=20"
+  },
+  "sideEffects": [
+    "./dist/components/*.js",
+    "./src/components/*.ts",
+    "./dist/index.js",
+    "./src/index.ts",
+    "./dist/layouts/*.js",
+    "./src/layouts/*.ts"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -42,8 +53,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@iyulab/components": "^1.21.0",
-    "@iyulab/router": "^0.10.2",
+    "@iyulab/components": "^1.24.0",
+    "@iyulab/router": "^0.11.0",
     "i18next": "^26.3.6",
     "lit": "^3.3.3"
   },

package/skills/modern-app/references/layout.md

@@ -41,6 +41,10 @@ interface SidebarLinkConfig {
   icon?: string;
   /** Override the URL matching pattern. Accepts a string or URLPattern. */
   pattern?: string | URLPattern;
+  /** Let the browser navigate instead of the router. For same-origin, non-SPA paths. */
+  navigate?: 'router' | 'document';
+  /** Anchor target. Use for opening in a new tab. */
+  target?: '_self' | '_blank';
   styles?: StyleMap<'host' | 'base' | 'icon' | 'label'>;
 }
 ```
@@ -51,6 +55,22 @@ Example:
 { type: 'link', icon: 'dashboard', label: 'Dashboard', href: '/' }
 ```
 
+#### Linking outside the app
+
+Not every entry in a real menu is a SPA screen. A help site, a report endpoint, an
+admin console, a legacy page — these sit in the same list. Mark them so the router
+leaves the click alone:
+
+```typescript
+{ type: 'link', icon: 'help', label: 'Help', href: '/help/', navigate: 'document' }
+```
+
+The entry stays an anchor, which is the point: middle-click and Ctrl+click still open
+a tab, the address is copyable, screen readers announce a link, `pattern`-based
+highlighting still works, and it can live inside a section or group. `target: '_blank'`
+is available too, but it is not a substitute — it forces a new tab, so same-tab
+navigation to another document needs `navigate`.
+
 ---
 
 ### `SidebarGroupConfig` — `type: 'group'`