@devslab/dds-solid 0.29.1 → 0.30.0

package/README.ko.md

@@ -26,6 +26,48 @@ DDS가 공개 API와 시각 토큰을 소유한다. 기존 import와 콜백 값
 포인터·포커스 상호작용 중과 브라우저 페이지가 비활성일 때는 알림 타이머가
 멈춘다. duration이 0 이하이면 명시적으로 닫을 때까지 유지한다.
 
+## 비동기 Toast와 액션
+
+`ToastProvider` 안의 `useToast()`는 `show`, `loading`, `update`, `promise`,
+`dismiss`, `clear`를 반환한다. ID와 수명 상태는 provider마다 독립적이다.
+`loading` tone은 수정하거나 닫을 때까지 유지한다. 스피너는 장식이므로 진행
+내용을 설명하는 메시지를 전달한다.
+
+```tsx
+const toast = useToast();
+const id = toast.loading({ message: "변경 사항 저장 중" });
+toast.update(id, { message: "변경 사항 저장됨", tone: "success" });
+
+const task = toast.promise(() => saveChanges(), {
+  loading: { message: "변경 사항 저장 중" },
+  success: { message: "변경 사항 저장됨" },
+  error: { message: "변경 사항을 저장하지 못했습니다" },
+});
+// 같은 ID를 즉시 사용할 수 있고, await는 원래 작업의 결과·오류를 전달한다.
+const saved = await task;
+
+toast.show({
+  message: "변경 사항 저장됨",
+  action: { label: "변경 사항 보기", onClick: () => openChanges(saved) },
+});
+```
+
+`update(id, patch)`는 생략한 필드를 유지하고 기존 알림을 수정한다. 선택적
+필드에 명시적으로 `undefined`를 전달하면 기본값으로 되돌리고, `action: null`은
+액션을 제거한다. 없거나 만료·닫힌 ID는 무시한다. 액션은 네이티브 버튼이며
+알림을 먼저 닫고 콜백을 한 번 실행한다. 주변 폼은 제출하지 않는다.
+
+`promise`는 Promise 또는 한 번 실행할 함수를 받으며 동기 예외도 rejection으로
+전달한다. `success`와 `error`는 입력 객체나 결과·원래 오류를 받는 동기 함수다.
+완료 입력은 loading 입력에 병합하며 완료 tone의 기본값은 success/danger이고,
+loading 이후에는 provider의 일반 유지 시간을 사용한다.
+반환형은 `Promise<T> & { readonly id: string }`이다. 다른 Promise와 동일하게
+rejection을 처리한다. dismiss·clear·닫기·액션 실행·수동 update·provider 해제는
+대기 중인 알림 갱신을 무효화한다. 원래 작업 결과는 호출자에게 전달되지만 완료
+메시지 함수는 호출하지 않고 알림도 다시 만들지 않는다. 완료 메시지 함수에서
+예외가 발생하면 현재 알림을 닫고 원래 작업의 결과·오류를 보존한다. 액션과
+Promise는 재시도·취소·업무 성공 판정을 추가하지 않는다.
+
 ## Button loading
 
 `loading`은 버튼의 크기와 접근 가능한 이름을 바꾸지 않는다. 라벨은 지우지 않고 숨기며

package/README.md

@@ -25,6 +25,51 @@ same. See [the migration guide](../../docs/ark-migration.md) for integration det
 pointer/focus interaction and when the browser page is idle. A non-positive duration
 keeps the toast until dismissed.
 
+## Async Toast and actions
+
+Inside `ToastProvider`, `useToast()` returns `show`, `loading`, `update`,
+`promise`, `dismiss` and `clear`. All IDs and lifecycle state belong to that
+provider. A `loading` tone persists until it is updated or dismissed; its spinner
+is decorative, so supply a message that describes the work.
+
+```tsx
+const toast = useToast();
+const id = toast.loading({ message: "Saving changes" });
+toast.update(id, { message: "Changes saved", tone: "success" });
+
+const task = toast.promise(() => saveChanges(), {
+  loading: { message: "Saving changes" },
+  success: { message: "Changes saved" },
+  error: { message: "Could not save changes" },
+});
+// The same ID is available immediately; awaiting preserves the operation's result/error.
+const saved = await task;
+
+toast.show({
+  message: "Changes saved",
+  action: { label: "View changes", onClick: () => openChanges(saved) },
+});
+```
+
+`update(id, patch)` keeps omitted fields and changes the toast in place. An
+explicit `undefined` resets an optional field to its default; `action: null`
+removes the action. Unknown, expired and dismissed IDs are ignored. An action is
+a native button: it dismisses the toast before invoking its callback once and
+does not submit a surrounding form.
+
+`promise` accepts a promise or a once-only factory, including synchronous throws.
+Its `success` and `error` inputs can also be synchronous functions receiving the
+result or original error. It merges terminal input into the loading input,
+defaults terminal tones to success/danger, and uses the provider's normal
+duration after loading. It returns `Promise<T> & { readonly id: string }`.
+Handle rejected operations as you would any other promise. Dismissing, clearing,
+closing, activating an action, manually updating or disposing the provider
+supersedes the pending notification; settlement still reaches the caller but
+does not run its terminal message factory or recreate the notification. If a
+terminal message factory throws, the current notification is dismissed and the
+original operation outcome is preserved. Actions and promises introduce no
+retry, cancellation or inference of business success.
+
 ## Button loading
 
 `loading` keeps the button's size and accessible name: the label is hidden, not removed, and the

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export { createPendingAction, type PendingAction, type PendingActionRunOptions }
 export { createStatusPill } from "./status-pill";
 export type { StatusTone } from "./status-pill";
 export { Tab, TabList, TabPanel, Tabs, type TabPanelProps, type TabProps, type TabsProps } from "./tabs";
-export { ToastProvider, useToast, type ToastApi, type ToastInput, type ToastProviderProps, type ToastTone } from "./toast";
+export { ToastProvider, useToast, type ToastAction, type ToastApi, type ToastInput, type ToastLoadingInput, type ToastPromise, type ToastPromiseOptions, type ToastProviderProps, type ToastRecord, type ToastTone, type ToastUpdate } from "./toast";
 export { Tooltip, type TooltipProps, type TooltipTriggerProps } from "./tooltip";
 export { DatePicker, type DatePickerProps } from "./date-picker";
 export { TimePicker, type TimePickerProps, type TimeMessages } from "./time-picker";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EACL,MAAM,EACN,QAAQ,EACR,KAAK,EACL,UAAU,EACV,KAAK,EACL,MAAM,EACN,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC/J,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzG,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAC3H,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACpF,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EACL,MAAM,EACN,QAAQ,EACR,KAAK,EACL,UAAU,EACV,KAAK,EACL,MAAM,EACN,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC/J,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzG,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AACtP,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACpF,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC"}