@lostgradient/cinder 0.4.1 → 0.6.0

package/src/components/alert-dialog/alert-dialog.svelte

@@ -1,80 +0,0 @@
-<script lang="ts" module>
-  /**
-   * @cinder
-   * @category overlay
-   * @status stable
-   * @purpose Sticky alert dialog for urgent acknowledgement that cannot be dismissed by backdrop click or Escape.
-   * @tag overlay
-   * @tag dialog
-   * @useWhen Requiring acknowledgement of a blocking warning before the user can continue.
-   * @useWhen Presenting a destructive or high-risk message that needs an explicit OK action.
-   * @avoidWhen Asking a reversible yes/no question — use confirm-dialog.
-   * @avoidWhen Collecting rich form input — compose modal instead.
-   * @related modal, confirm-dialog, drawer
-   */
-  export type { AlertDialogProps } from './alert-dialog.types.ts';
-</script>
-
-<script lang="ts">
-  import type { AlertDialogProps } from './alert-dialog.types.ts';
-  import Button from '../button/button.svelte';
-  import Modal from '../modal/modal.svelte';
-  import { classNames } from '../../utilities/class-names.ts';
-
-  const descriptionId = $props.id();
-
-  let {
-    open = $bindable(false),
-    title,
-    description,
-    acknowledgeLabel = 'OK',
-    cancelLabel,
-    destructive = false,
-    onacknowledge,
-    oncancel,
-    triggerRef = null,
-    class: className,
-  }: AlertDialogProps = $props();
-
-  function handleAcknowledge() {
-    open = false;
-    onacknowledge();
-  }
-
-  function handleCancel() {
-    open = false;
-    oncancel?.();
-  }
-
-  const acknowledgeAutofocus = $derived(!(destructive && cancelLabel));
-  const cancelAutofocus = $derived(Boolean(destructive && cancelLabel));
-</script>
-
-<Modal
-  bind:open
-  {title}
-  {triggerRef}
-  role="alertdialog"
-  dismissOnBackdropClick={false}
-  dismissOnEscape={false}
-  showCloseButton={false}
-  describedById={descriptionId}
-  class={classNames('cinder-alert-dialog', className)}
->
-  <p id={descriptionId} class="cinder-alert-dialog__description">{description}</p>
-
-  {#snippet footer()}
-    {#if cancelLabel}
-      <Button variant="secondary" autofocus={cancelAutofocus} onclick={handleCancel}>
-        {cancelLabel}
-      </Button>
-    {/if}
-    <Button
-      variant={destructive ? 'danger' : 'primary'}
-      autofocus={acknowledgeAutofocus}
-      onclick={handleAcknowledge}
-    >
-      {acknowledgeLabel}
-    </Button>
-  {/snippet}
-</Modal>

package/src/components/alert-dialog/alert-dialog.types.ts

@@ -1,19 +0,0 @@
-export type AlertDialogProps = {
-  /** Controls whether the alert dialog is open; bindable for controlled usage. */
-  open: boolean;
-  /** Text rendered as the dialog's visible heading and accessible label. */
-  title: string;
-  /** Explanatory paragraph displayed in the dialog body and wired to the dialog via aria-describedby. */
-  description: string;
-  /** Label for the primary acknowledgement button. Default `OK`. */
-  acknowledgeLabel?: string;
-  /** Label for the optional cancel button. When omitted, no cancel button is rendered. */
-  cancelLabel?: string;
-  /** When true, styles the acknowledgement button as a danger action and, when a cancel button is rendered, gives it initial focus instead of the acknowledgement button. Default `false`. */
-  destructive?: boolean;
-  onacknowledge: () => void;
-  oncancel?: () => void;
-  triggerRef?: HTMLElement | null;
-  /** Additional class names merged with the component's root class. */
-  class?: string;
-};

package/src/components/alert-dialog/index.ts

@@ -1,6 +0,0 @@
-import './alert-dialog.css';
-import AlertDialog from './alert-dialog.svelte';
-
-export default AlertDialog;
-export type { AlertDialogProps } from './alert-dialog.types.ts';
-export { AlertDialog };

package/src/components/approval-card/README.md

@@ -1,92 +0,0 @@
-# ApprovalCard
-
-Presentational human-in-the-loop approval surface for reviewing a tool operation
-before the host application executes it.
-
-## Usage
-
-```svelte
-<script lang="ts">
-  import { ApprovalCard } from '@lostgradient/cinder/approval-card';
-</script>
-
-<ApprovalCard
-  tool={{ name: 'deploy-cloud', risk: 'medium' }}
-  sandbox={{
-    provider: 'codex',
-    name: 'workspace-write',
-    workingDir: '/workspace/project',
-  }}
-  operation={{
-    kind: 'command',
-    command: 'bun run --filter=@lostgradient/cinder validate',
-    argsPreview: { package: '@lostgradient/cinder' },
-  }}
-  env={['DATABASE_URL', 'OPENAI_API_KEY']}
-  policyVersion="policy-2026-06"
-  idempotencyKey="approval-01JZ8T"
-  state="pending"
-  onapprove={() => approve()}
-  ondeny={() => deny()}
-/>
-```
-
-`ApprovalCard` is fully controlled. It does not execute commands, apply patches,
-persist policy decisions, or read environment values. The component only renders
-the supplied context and invokes callback props for host-owned actions.
-
-## Operation rendering
-
-- `operation.kind: 'command'` renders the command with `CodeBlock`.
-- `operation.kind: 'patch'` renders the supplied unified patch as diff code.
-- `operation.argsPreview` renders through `PayloadInspector`; oversized previews
-  are replaced with a bounded truncation notice before rendering.
-- `env` renders variable names only. Values are not accepted and are stripped if
-  a caller accidentally passes `NAME=value`.
-
-## Approval states
-
-Pending requests render action buttons. Non-pending requests render a read-only
-summary. When `expiresAt` passes while `state` is still `pending`, the effective
-state becomes `expired`, actions disappear, and no callback fires automatically.
-
-## Props
-
-<!-- generated:props:start -->
-
-| Prop                 | Type                                                                                                                                                                                                                                                                                                                                              | Required | Default | Description                                                                                                                                              |
-| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `class`              | `string`                                                                                                                                                                                                                                                                                                                                          | no       | —       | Additional CSS classes applied to the root element.                                                                                                      |
-| `editableArgs`       | `boolean`                                                                                                                                                                                                                                                                                                                                         | no       | —       | Whether approving with edited JSON arguments is available. Default `false`.                                                                              |
-| `env`                | `string`[]                                                                                                                                                                                                                                                                                                                                        | no       | —       | Environment variable names only. Values are ignored if accidentally supplied as `NAME=value`.                                                            |
-| `expiresAt`          | `string`                                                                                                                                                                                                                                                                                                                                          | no       | —       | Optional ISO timestamp after which a pending approval is treated as expired.                                                                             |
-| `idempotencyKey`     | `string`                                                                                                                                                                                                                                                                                                                                          | yes      | —       | Idempotency key that makes repeated decisions durable.                                                                                                   |
-| `operation`          | { argsPreview?: `unknown`; command: `string`; filesTouched?: `string`[]; kind: `"command"` } \| { argsPreview?: `unknown`; filesTouched: `string`[]; kind: `"file-write"` } \| { argsPreview?: `unknown`; diff: `string`; filesTouched?: `string`[]; kind: `"patch"` } \| { argsPreview?: `unknown`; filesTouched?: `string`[]; kind: `"other"` } | yes      | —       | Operation details shown to the approver.                                                                                                                 |
-| `policyVersion`      | `string`                                                                                                                                                                                                                                                                                                                                          | yes      | —       | Policy version that produced the approval request.                                                                                                       |
-| `sandbox`            | { name: `string`; provider: `string`; workingDir: `string` }                                                                                                                                                                                                                                                                                      | no       | —       | Optional sandbox context in which the operation will run.                                                                                                |
-| `snapshotId`         | `string`                                                                                                                                                                                                                                                                                                                                          | no       | —       | Snapshot identifier for the pending approval context.                                                                                                    |
-| `state`              | `"pending"` \| `"approved"` \| `"approved_with_edits"` \| `"denied"` \| `"expired"` \| `"cancelled"`                                                                                                                                                                                                                                              | yes      | —       | Persisted approval state.                                                                                                                                |
-| `tool`               | { name: `string`; risk: `"low"` \| `"medium"` \| `"high"` }                                                                                                                                                                                                                                                                                       | yes      | —       | Tool requesting approval.                                                                                                                                |
-| `onapprove`          | `(opaque)`                                                                                                                                                                                                                                                                                                                                        | no       | —       | Called when the approver accepts the operation as presented. Not expressible in JSON Schema; see the component types for the signature.                  |
-| `onapprovewithedits` | `(opaque)`                                                                                                                                                                                                                                                                                                                                        | no       | —       | Called with parsed JSON arguments when the approver accepts edited arguments. Not expressible in JSON Schema; see the component types for the signature. |
-| `oncancel`           | `(opaque)`                                                                                                                                                                                                                                                                                                                                        | no       | —       | Called when the approver cancels the approval prompt. Not expressible in JSON Schema; see the component types for the signature.                         |
-| `ondeny`             | `(opaque)`                                                                                                                                                                                                                                                                                                                                        | no       | —       | Called when the approver denies the operation. Not expressible in JSON Schema; see the component types for the signature.                                |
-| `onremember`         | `(opaque)`                                                                                                                                                                                                                                                                                                                                        | no       | —       | Called when the approver asks the host application to remember the decision. Not expressible in JSON Schema; see the component types for the signature.  |
-
-<!-- generated:props:end -->
-
-## CSS Variables
-
-<!-- generated:variables:start -->
-
-This component does not declare any local CSS variables.
-
-<!-- generated:variables:end -->
-
-## Subcomponents
-
-<!-- generated:subcomponents:start -->
-
-None.
-
-<!-- generated:subcomponents:end -->

package/src/components/approval-card/approval-card-state.ts

@@ -1,24 +0,0 @@
-import type { ApprovalState } from './approval-card.types.ts';
-
-export function resolveEffectiveApprovalState(
-  approvalState: ApprovalState,
-  expirationTimestamp: number | undefined,
-  currentTime: number | undefined,
-): ApprovalState {
-  if (approvalState !== 'pending' || expirationTimestamp === undefined) return approvalState;
-  return resolveComparisonTime(currentTime) >= expirationTimestamp ? 'expired' : approvalState;
-}
-
-export function isApprovalActionable(
-  approvalState: ApprovalState,
-  expirationTimestamp: number | undefined,
-  currentTime: number | undefined,
-): boolean {
-  if (approvalState !== 'pending') return false;
-  if (expirationTimestamp === undefined) return true;
-  return resolveComparisonTime(currentTime) < expirationTimestamp;
-}
-
-function resolveComparisonTime(currentTime: number | undefined): number {
-  return currentTime ?? Date.now();
-}