@iyulab/components 1.3.4 → 1.4.0

package/dist/components/UDataElement.styles.js

@@ -1,95 +0,0 @@
-import { css } from "lit";
-//#region src/components/UDataElement.styles.ts
-var styles = css`
-  .error-container {
-    display: flex;
-    flex-direction: column;
-    border: 1px solid var(--u-red-200);
-    border-radius: 10px;
-    background: var(--u-red-0);
-    color: var(--u-red-700);
-    overflow: hidden;
-    font-size: 0.875em;
-    line-height: 1.5;
-  }
-
-  .error-header {
-    display: flex;
-    flex-direction: row;
-    align-items: center;
-    gap: 0.5em;
-    padding: 0.55em 0.9em;
-    background: var(--u-red-50);
-    border-bottom: 1px solid var(--u-red-200);
-  }
-
-  .error-icon {
-    font-size: 0.95em;
-    color: var(--u-red-500);
-    flex-shrink: 0;
-  }
-
-  .error-title {
-    font-weight: 700;
-    letter-spacing: 0.01em;
-    flex: 1;
-  }
-
-  .error-tag {
-    font-family: var(--u-font-mono);
-    font-size: 0.85em;
-    padding: 0.1em 0.45em;
-    color: var(--u-red-600);
-    border: 1px solid var(--u-red-200);
-    border-radius: 4px;
-    background: var(--u-red-100);
-  }
-
-  .error-body {
-    display: flex;
-    flex-direction: column;
-    padding: 0.6em 0.9em;
-    gap: 0.45em;
-  }
-
-  .error-row {
-    display: flex;
-    flex-direction: row;
-    align-items: baseline;
-    gap: 0.6em;
-    min-height: 1.6em;
-  }
-
-  .error-label {
-    flex-shrink: 0;
-    width: 5em;
-    font-size: 0.78em;
-    font-weight: 700;
-    text-transform: uppercase;
-    letter-spacing: 0.06em;
-    opacity: 0.55;
-    padding-top: 0.15em;
-  }
-
-  .error-type {
-    font-family: var(--u-font-mono);
-    font-size: 0.85em;
-    padding: 0.1em 0.4em;
-    color: var(--u-red-700);
-    background: var(--u-red-100);
-    border-radius: 4px;
-  }
-
-  .error-message {
-    margin: 0;
-    flex: 1;
-    white-space: pre-wrap;
-    word-break: break-all;
-    font-family: var(--u-font-mono);
-    font-size: 0.9em;
-    opacity: 0.85;
-    line-height: 1.55;
-  }
-`;
-//#endregion
-export { styles };

package/dist/core/locale.d.ts

@@ -1,69 +0,0 @@
-/**
- * @iyulab/components 의 경량 로케일 레지스트리.
- *
- * 범위: 라이브러리가 스스로 생성하는 chrome 문자열(검증 메시지 등)만 대상.
- * 일반 i18n 프레임워크가 아니다. 앱 콘텐츠 번역은 consumer 의 i18n 계층(예:
- * modern-app 의 i18next)이 담당한다.
- *
- * 영어가 내장 기본값이며, 한국어 등 도메인 로케일은 consumer 가 등록한다:
- *   registerLocale('ko', { required: '필수 항목입니다.', ... });
- *   setDefaultLocale('ko');
- *
- * 모노레포 로케일 표준(packages/u-widgets/src/core/locale.ts)과 동일한 계약을 따른다.
- */
-export interface UComponentsLocaleStrings {
-    required: string;
-    minValue: string;
-    maxValue: string;
-    stepMismatch: string;
-    minCount: string;
-    maxCount: string;
-}
-/**
- * 로케일을 등록한다. 부분 등록은 영어 기본값에 병합된다.
- */
-export declare function registerLocale(lang: string, strings: Partial<UComponentsLocaleStrings>): void;
-/**
- * 주어진 언어 태그에 대한 로케일 문자열을 해석한다.
- *
- * 해석 순서:
- *   1. 정확히 일치 (예: 'ko-KR')
- *   2. 기반 언어 (예: 'ko')
- *   3. 영어 폴백
- */
-export declare function getLocaleStrings(lang?: string): UComponentsLocaleStrings;
-/**
- * 템플릿 문자열의 {key} 플레이스홀더를 치환한다.
- */
-export declare function formatTemplate(template: string, params: Record<string, string | number>): string;
-/**
- * 영어 기본값을 반환한다 (테스트/참조용).
- */
-export declare function getDefaultLocale(): UComponentsLocaleStrings;
-/**
- * 모든 컴포넌트에 적용되는 전역 기본 로케일을 설정한다.
- *
- * 해석 순서(우선순위 높은 순):
- *   1. 컴포넌트별 `locale` 속성/프로퍼티
- *   2. setDefaultLocale() 값
- *   3. document.documentElement.lang (브라우저)
- *   4. 영어 폴백
- *
- * @example
- * ```ts
- * import { setDefaultLocale } from '@iyulab/components';
- * setDefaultLocale('ko-KR');
- * ```
- */
-export declare function setDefaultLocale(lang: string | undefined): void;
-/**
- * setDefaultLocale() 로 설정된 전역 기본 로케일을 반환한다.
- * 설정되지 않았으면 undefined 를 반환한다.
- */
-export declare function getEffectiveLocale(): string | undefined;
-/**
- * 컴포넌트가 사용할 로케일을 해석한다.
- *
- * 우선순위: widgetLocale > setDefaultLocale() > document.lang > undefined
- */
-export declare function resolveLocale(widgetLocale?: string | null): string | undefined;

package/dist/core/locale.js

@@ -1,85 +0,0 @@
-//#region src/core/locale.ts
-var EN = {
-	required: "This field is required",
-	minValue: "Value must be at least {min}",
-	maxValue: "Value must be at most {max}",
-	stepMismatch: "Value must be a multiple of {step}",
-	minCount: "Please select at least {min} items",
-	maxCount: "Please select no more than {max} items"
-};
-var registry = /* @__PURE__ */ new Map();
-/**
-* 로케일을 등록한다. 부분 등록은 영어 기본값에 병합된다.
-*/
-function registerLocale(lang, strings) {
-	registry.set(lang.toLowerCase(), {
-		...EN,
-		...strings
-	});
-}
-/**
-* 주어진 언어 태그에 대한 로케일 문자열을 해석한다.
-*
-* 해석 순서:
-*   1. 정확히 일치 (예: 'ko-KR')
-*   2. 기반 언어 (예: 'ko')
-*   3. 영어 폴백
-*/
-function getLocaleStrings(lang) {
-	if (!lang) return EN;
-	const key = lang.toLowerCase();
-	if (registry.has(key)) return registry.get(key);
-	const base = key.split("-")[0];
-	if (base !== key && registry.has(base)) return registry.get(base);
-	return EN;
-}
-/**
-* 템플릿 문자열의 {key} 플레이스홀더를 치환한다.
-*/
-function formatTemplate(template, params) {
-	return template.replace(/\{(\w+)\}/g, (_, key) => params[key] != null ? String(params[key]) : `{${key}}`);
-}
-/**
-* 영어 기본값을 반환한다 (테스트/참조용).
-*/
-function getDefaultLocale() {
-	return { ...EN };
-}
-var _defaultLocale;
-/**
-* 모든 컴포넌트에 적용되는 전역 기본 로케일을 설정한다.
-*
-* 해석 순서(우선순위 높은 순):
-*   1. 컴포넌트별 `locale` 속성/프로퍼티
-*   2. setDefaultLocale() 값
-*   3. document.documentElement.lang (브라우저)
-*   4. 영어 폴백
-*
-* @example
-* ```ts
-* import { setDefaultLocale } from '@iyulab/components';
-* setDefaultLocale('ko-KR');
-* ```
-*/
-function setDefaultLocale(lang) {
-	_defaultLocale = lang;
-}
-/**
-* setDefaultLocale() 로 설정된 전역 기본 로케일을 반환한다.
-* 설정되지 않았으면 undefined 를 반환한다.
-*/
-function getEffectiveLocale() {
-	return _defaultLocale;
-}
-/**
-* 컴포넌트가 사용할 로케일을 해석한다.
-*
-* 우선순위: widgetLocale > setDefaultLocale() > document.lang > undefined
-*/
-function resolveLocale(widgetLocale) {
-	if (widgetLocale) return widgetLocale;
-	if (_defaultLocale) return _defaultLocale;
-	if (typeof document !== "undefined" && document.documentElement?.lang) return document.documentElement.lang;
-}
-//#endregion
-export { formatTemplate, getDefaultLocale, getEffectiveLocale, getLocaleStrings, registerLocale, resolveLocale, setDefaultLocale };

package/dist/utilities/sanitizers.d.ts

@@ -1,35 +0,0 @@
-/**
- * HTML 출력 시 XSS 방지를 위한 escape 유틸
- *
- * 컨텍스트에 맞는 함수를 사용해야 합니다.
- *
- * - escapeHtmlText : HTML 텍스트 노드에 삽입할 때
- * - escapeHtmlAttr : HTML attribute 값에 삽입할 때
- * - escapeHtmlHref : href/src 같은 URL attribute에 삽입할 때
- */
-/**
- * Zero Width Space / LTR / RTL mark / BOM 등
- * 화면에 표시되지 않는 유니코드 문자를 제거합니다.
- */
-export declare function stripZeroWidth(value: string): string;
-/**
- * HTML 텍스트 노드(context)에 삽입할 문자열을 escape합니다.
- *
- * 예:
- *   <script> → &lt;script&gt;
- */
-export declare function escapeHtmlText(value: string): string;
-/**
- * HTML attribute 값(context)에 삽입할 문자열을 escape합니다.
- *
- * 예:
- *   <div title="{value}">
- */
-export declare function escapeHtmlAttr(value: string): string;
-/**
- * href / src attribute용 문자열 처리
- *
- * 예:
- *  <a href="{value}">
- */
-export declare function escapeHtmlHref(value: string): string;

package/dist/utilities/sanitizers.js

@@ -1,75 +0,0 @@
-//#region src/utilities/sanitizers.ts
-/**
-* HTML 출력 시 XSS 방지를 위한 escape 유틸
-*
-* 컨텍스트에 맞는 함수를 사용해야 합니다.
-*
-* - escapeHtmlText : HTML 텍스트 노드에 삽입할 때
-* - escapeHtmlAttr : HTML attribute 값에 삽입할 때
-* - escapeHtmlHref : href/src 같은 URL attribute에 삽입할 때
-*/
-/**
-* Zero Width Space / LTR / RTL mark / BOM 등
-* 화면에 표시되지 않는 유니코드 문자를 제거합니다.
-*/
-function stripZeroWidth(value) {
-	const ZERO_WIDTH_REGEX = /[\u200B\u200C\u200D\u200E\u200F\uFEFF]/g;
-	return ZERO_WIDTH_REGEX.test(value) ? value.replace(ZERO_WIDTH_REGEX, "") : value;
-}
-/** HTML text context escape 대상 문자 */
-var HTML_TEXT_ESCAPE_REGEX = /[&<>"']/g;
-/** HTML text context escape용 문자 매핑 */
-var HTML_TEXT_ESCAPE_MAP = {
-	"&": "&amp;",
-	"<": "&lt;",
-	">": "&gt;",
-	"\"": "&quot;",
-	"'": "&#39;"
-};
-/**
-* HTML 텍스트 노드(context)에 삽입할 문자열을 escape합니다.
-*
-* 예:
-*   <script> → &lt;script&gt;
-*/
-function escapeHtmlText(value) {
-	return HTML_TEXT_ESCAPE_REGEX.test(value) ? value.replace(HTML_TEXT_ESCAPE_REGEX, (ch) => HTML_TEXT_ESCAPE_MAP[ch]) : value;
-}
-/** HTML attribute escape 대상 문자 */
-var HTML_ATTR_ESCAPE_REGEX = /[&<>"]/g;
-/** HTML attribute escape용 문자 매핑 */
-var HTML_ATTR_ESCAPE_MAP = {
-	"&": "&amp;",
-	"<": "&lt;",
-	">": "&gt;",
-	"\"": "&quot;"
-};
-/**
-* HTML attribute 값(context)에 삽입할 문자열을 escape합니다.
-* 
-* 예:
-*   <div title="{value}">
-*/
-function escapeHtmlAttr(value) {
-	return HTML_ATTR_ESCAPE_REGEX.test(value) ? value.replace(HTML_ATTR_ESCAPE_REGEX, (ch) => HTML_ATTR_ESCAPE_MAP[ch]) : value;
-}
-/** protocol 우회 공격 방지를 위한 공백/제어문자 제거 */
-var HREF_STRIP_CHARS_REGEX = /[\u0000-\u001F\u007F\s]+/g;
-/** href/src에서 차단해야 하는 위험 protocol */
-var HREF_UNSAFE_PROTOCOL_REGEX = /^(?:javascript|data|vbscript):/i;
-/**
-* href / src attribute용 문자열 처리
-*
-* 예:
-*  <a href="{value}">
-*/
-function escapeHtmlHref(value) {
-	let normalized = stripZeroWidth(value).trim();
-	if (HREF_STRIP_CHARS_REGEX.test(normalized)) normalized = normalized.replace(HREF_STRIP_CHARS_REGEX, "");
-	normalized = normalized.replace(/\\/g, "/");
-	if (normalized.startsWith("//")) return "#";
-	if (HREF_UNSAFE_PROTOCOL_REGEX.test(normalized)) return "#";
-	return escapeHtmlAttr(normalized);
-}
-//#endregion
-export { escapeHtmlAttr, escapeHtmlHref, escapeHtmlText, stripZeroWidth };

package/skills/iyulab-components/references/extensions/data.md

@@ -1,60 +0,0 @@
-# UDataElement
-
-```ts
-import { UDataElement } from '@iyulab/components';
-```
-
-Base class for data-driven components that load their initial data from an inline `<script type="application/json">` tag in the light DOM.
-
-## When to extend
-
-Use when you want to declare component data directly in HTML without JavaScript, or when server-rendering initial state into the page.
-
-```ts
-import { UDataElement } from '@iyulab/components';
-import { customElement } from 'lit/decorators.js';
-import { html } from 'lit';
-
-@customElement('my-list')
-export class MyList extends UDataElement {
-  private items: string[] = [];
-
-  protected override async load(data?: unknown) {
-    if (Array.isArray(data)) {
-      this.items = data as string[];
-    }
-  }
-
-  render() {
-    return html`
-      <ul>${this.items.map(i => html`<li>${i}</li>`)}</ul>
-    `;
-  }
-}
-```
-
-```html
-<my-list>
-  <script type="application/json">
-    ["Item A", "Item B", "Item C"]
-  </script>
-</my-list>
-```
-
-## Static Methods
-
-| Method | Returns | Description |
-|--------|---------|-------------|
-| `buildHTML(json, attrs?)` | `string` | Build a safe inline HTML string with JSON data embedded in a `<script type="application/json">` child |
-
-```ts
-const html = MyList.buildHTML(['Item A', 'Item B'], { class: 'my-list' });
-// → '<my-list class="my-list"><script type="application/json">["Item A","Item B"]</script></my-list>'
-```
-
-## Protected Methods
-
-| Method | Returns | Description |
-|--------|---------|-------------|
-| `load(data?)` | `Promise<void>` | Called with the parsed JSON data after the element connects; override to handle data |
-| `error(error)` | `Promise<void>` | Called when JSON parsing fails; override to handle errors |

package/skills/iyulab-components/references/utilities/sanitizers.md

@@ -1,32 +0,0 @@
-# sanitizers
-
-```ts
-import { escapeHtmlText, escapeHtmlAttr, escapeHtmlHref, stripZeroWidth } from '@iyulab/components';
-```
-
-XSS-safe escaping helpers for HTML output. Use these whenever inserting user-supplied content into HTML strings (e.g. inside `buildElementHTML` or custom template rendering).
-
-## Functions
-
-| Function | Use case | Description |
-|----------|----------|-------------|
-| `escapeHtmlText(value)` | Text node content | Escapes `&`, `<`, `>`, `"`, `'` |
-| `escapeHtmlAttr(value)` | HTML attribute values | Escapes `&`, `<`, `>`, `"` |
-| `escapeHtmlHref(value)` | `href` / `src` URLs | Escapes HTML entities + blocks `javascript:` and `data:` protocol injection |
-| `stripZeroWidth(value)` | Any string output | Removes zero-width Unicode characters (e.g. U+200B) |
-
-## Example
-
-```ts
-import { escapeHtmlText, escapeHtmlHref } from '@iyulab/components';
-
-const userInput = '<script>alert(1)</script>';
-const html = `<p>${escapeHtmlText(userInput)}</p>`;
-// → <p>&lt;script&gt;alert(1)&lt;/script&gt;</p>
-
-const url = 'javascript:alert(1)';
-const safe = escapeHtmlHref(url);
-// → '' (blocked)
-```
-
-> Lit templates using `html` tagged literals automatically escape interpolated values. These helpers are needed when building raw HTML strings manually.