@happyvertical/smrt-fields 0.40.60 → 0.40.61

package/dist/svelte/__tests__/fixtures/TooltipFixture.svelte

@@ -0,0 +1,25 @@
+<script lang="ts">
+/**
+ * Test fixture: PolicyField with helpDensity='tooltip' to verify the help
+ * text attaches to the label as a title attribute instead of rendering a
+ * visible hint.
+ */
+
+import type { ResolvedObjectFieldPolicy } from '../../../types.js';
+import FieldPolicyProvider from '../../components/FieldPolicyProvider.svelte';
+import PolicyField from '../../components/PolicyField.svelte';
+
+let {
+  policy,
+  helpDensity = 'tooltip',
+}: {
+  policy: ResolvedObjectFieldPolicy;
+  helpDensity?: 'hint' | 'tooltip';
+} = $props();
+</script>
+
+<FieldPolicyProvider {policy} mode="basic">
+  <PolicyField name="name" {helpDensity}>
+    <input id="name" name="name" type="text" />
+  </PolicyField>
+</FieldPolicyProvider>

package/dist/svelte/__tests__/fixtures/TooltipFixture.svelte.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Test fixture: PolicyField with helpDensity='tooltip' to verify the help
+ * text attaches to the label as a title attribute instead of rendering a
+ * visible hint.
+ */
+import type { ResolvedObjectFieldPolicy } from '../../../types.js';
+type $$ComponentProps = {
+    policy: ResolvedObjectFieldPolicy;
+    helpDensity?: 'hint' | 'tooltip';
+};
+declare const TooltipFixture: import("svelte").Component<$$ComponentProps, {}, "">;
+type TooltipFixture = ReturnType<typeof TooltipFixture>;
+export default TooltipFixture;
+//# sourceMappingURL=TooltipFixture.svelte.d.ts.map

package/dist/svelte/__tests__/fixtures/TooltipFixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TooltipFixture.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/__tests__/fixtures/TooltipFixture.svelte.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAIlE,KAAK,gBAAgB,GAAI;IACxB,MAAM,EAAE,yBAAyB,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,CAAC;AAsBF,QAAA,MAAM,cAAc,sDAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/svelte/__tests__/settings-catalog.test.js

@@ -0,0 +1,161 @@
+import { describe, expect, it } from 'vitest';
+import { auditObjectRefs, decorateCatalogPage, fieldPolicyCatalogPreservedParams, fieldPolicyControlPanelNavItem, fieldPolicyRollup, orgRowIdsForObject, prunableDriftRows, } from '../settings-catalog.js';
+const objectRef = '@test/smrt-fields:Document';
+function audit() {
+    return {
+        caller: {
+            tenantId: 'tenant',
+            userId: 'user',
+            canManageOrg: true,
+            canPersonalize: true,
+        },
+        appRows: [],
+        orgRows: [
+            {
+                id: 'org-row',
+                objectRef,
+                fieldName: 'title',
+                scopeType: 'tenant',
+                tenantId: 'tenant',
+                userId: null,
+                updatedBy: 'user',
+                createdAt: null,
+                updatedAt: null,
+                defaultValue: null,
+                displayOrder: null,
+                help: null,
+                label: null,
+                locked: null,
+                visibility: 'advanced',
+            },
+        ],
+        inheritedOrgKeys: {},
+        userOverrideCounts: { [objectRef]: { title: 2 } },
+        driftRows: [
+            {
+                id: 'stale',
+                objectRef: '@gone:Old',
+                fieldName: 'gone',
+                scopeType: 'tenant',
+                tenantId: 'tenant',
+                userId: null,
+                updatedBy: null,
+                createdAt: null,
+                updatedAt: null,
+                reason: 'unknown-object',
+                prunable: true,
+            },
+        ],
+        policies: {
+            [objectRef]: {
+                objectRef,
+                fields: {
+                    title: {
+                        fieldName: 'title',
+                        hasDefault: true,
+                        defaultValue: 'tenant',
+                        visibility: 'advanced',
+                        help: null,
+                        label: null,
+                        order: null,
+                        group: null,
+                        locked: false,
+                        required: false,
+                    },
+                },
+                layers: {
+                    title: [
+                        {
+                            layer: 'code',
+                            delta: { default: { value: 'code' }, visibility: 'basic' },
+                        },
+                        {
+                            layer: 'tenant',
+                            tenantId: 'tenant',
+                            delta: { default: { value: 'tenant' }, visibility: 'advanced' },
+                        },
+                    ],
+                },
+            },
+        },
+    };
+}
+describe('field-policy control-panel adapters', () => {
+    it('replays explained layers for code/app/org cells and never exposes user rows', () => {
+        const rollup = fieldPolicyRollup(audit(), objectRef, 'title');
+        expect(rollup.code).toMatchObject({
+            defaultValue: 'code',
+            visibility: 'basic',
+        });
+        expect(rollup.org).toMatchObject({
+            defaultValue: 'tenant',
+            visibility: 'advanced',
+            contributed: true,
+        });
+        expect(rollup.userCount).toBe(2);
+        expect(rollup.orgRow?.id).toBe('org-row');
+    });
+    it('keeps a selected off-page object in the capped policy read while count refs remain complete', () => {
+        const page = {
+            items: Array.from({ length: 100 }, (_, index) => ({
+                objectRef: `@test:Thing${index}`,
+            })),
+            selected: { objectRef: '@test:Selected' },
+        };
+        const refs = auditObjectRefs(page);
+        expect(refs.objectRefs).toHaveLength(100);
+        expect(refs.objectRefs[0]).toBe('@test:Selected');
+        expect(refs.countObjectRefs).toHaveLength(101);
+    });
+    it('decorates an off-page selected detail alongside page summaries', () => {
+        const page = decorateCatalogPage({
+            items: [],
+            selected: {
+                id: 'selected',
+                objectRef,
+                fieldName: 'title',
+                className: 'Document',
+                packageName: '@test/smrt-fields',
+                label: 'Raw title',
+                description: 'Raw description',
+                fields: {},
+            },
+            query: '',
+            page: 1,
+            pageSize: 25,
+            total: 1,
+        }, audit());
+        expect(page.selected).toMatchObject({
+            label: 'Title',
+            status: 'Organization · 2 user overrides',
+            fields: {},
+        });
+    });
+    it('selects only caller-prunable drift rows and produces a permission-gated tenant nav item', () => {
+        expect(prunableDriftRows(audit()).map((row) => row.id)).toEqual(['stale']);
+        expect(orgRowIdsForObject(audit(), objectRef)).toEqual(['org-row']);
+        expect(fieldPolicyControlPanelNavItem({
+            href: '/admin/fields',
+            permissions: [],
+        })).toBeNull();
+        expect(fieldPolicyControlPanelNavItem({
+            href: '/admin/fields',
+            permissions: ['fields.policy.manage'],
+        })).toMatchObject({ href: '/admin/fields', label: 'Field settings' });
+    });
+    it('keeps a nondefault page size across catalog search, selection, and pagination links', () => {
+        expect(fieldPolicyCatalogPreservedParams({
+            page: { pageSize: 25 },
+            filters: {
+                packageFilter: 'package',
+                objectFilter: 'object',
+                customizedOnly: true,
+            },
+        })).toEqual({
+            package: 'package',
+            object: 'object',
+            customized: '1',
+            pageSize: '25',
+        });
+    });
+});

package/dist/svelte/components/AdvancedFields.svelte

@@ -0,0 +1,49 @@
+<script lang="ts">
+/**
+ * AdvancedFields — a disclosure section for advanced-tier fields.
+ *
+ * An optional composition that wraps PolicyField-wrapped advanced fields. Uses
+ * `@happyvertical/smrt-ui/ui`'s Disclosure (native `<details>/<summary>` —
+ * good a11y baseline). The title shows the advanced field count from the
+ * resolved policy.
+ *
+ * The disclosure's open state is **not** coupled to the provider's mode: the
+ * mode determines *visibility* (advanced fields are hidden in basic mode),
+ * while the disclosure provides a *collapsed* view of those same fields when
+ * they are visible (advanced mode). Consumers who prefer the mode toggle alone
+ * (ModeSwitch) do not need this component.
+ *
+ * Must be used inside a FieldPolicyProvider.
+ */
+import { Disclosure } from '@happyvertical/smrt-ui/ui';
+import type { Snippet } from 'svelte';
+import { getFieldPolicyContext } from '../context.svelte.js';
+
+export interface Props {
+  /**
+   * Title for the disclosure. Defaults to "Advanced" with the field count.
+   */
+  title?: string;
+  /** Whether the disclosure starts open. */
+  open?: boolean;
+  /** Children — the advanced fields to render inside the disclosure. */
+  children?: Snippet;
+  /** Additional class. */
+  class?: string;
+}
+
+let { title, open = false, children, class: className = '' }: Props = $props();
+
+const context = getFieldPolicyContext();
+
+const resolvedTitle = $derived(
+  title ??
+    `Advanced · ${context.advancedFieldCount} field${context.advancedFieldCount === 1 ? '' : 's'}`,
+);
+</script>
+
+{#if context.mode.current === 'advanced' && context.advancedFieldCount > 0}
+  <Disclosure title={resolvedTitle} {open} class={className}>
+    {@render children?.()}
+  </Disclosure>
+{/if}

package/dist/svelte/components/AdvancedFields.svelte.d.ts

@@ -0,0 +1,17 @@
+import type { Snippet } from 'svelte';
+export interface Props {
+    /**
+     * Title for the disclosure. Defaults to "Advanced" with the field count.
+     */
+    title?: string;
+    /** Whether the disclosure starts open. */
+    open?: boolean;
+    /** Children — the advanced fields to render inside the disclosure. */
+    children?: Snippet;
+    /** Additional class. */
+    class?: string;
+}
+declare const AdvancedFields: import("svelte").Component<Props, {}, "">;
+type AdvancedFields = ReturnType<typeof AdvancedFields>;
+export default AdvancedFields;
+//# sourceMappingURL=AdvancedFields.svelte.d.ts.map

package/dist/svelte/components/AdvancedFields.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdvancedFields.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/AdvancedFields.svelte.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAItC,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA0BD,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/svelte/components/FieldInput.svelte

@@ -0,0 +1,159 @@
+<script lang="ts">
+/** Provider-free built-in adapters for the SMRT generated wire field types. */
+import { Input, Textarea, Toggle } from '@happyvertical/smrt-ui/forms';
+import { onDestroy } from 'svelte';
+import type { FieldInputProps } from '../types.js';
+
+let {
+  id,
+  name,
+  label,
+  field,
+  value,
+  required,
+  disabled,
+  onvaluechange,
+  onvaliditychange,
+}: FieldInputProps = $props();
+
+let jsonText = $state('');
+let jsonError = $state<string | null>(null);
+
+onDestroy(() => {
+  // A hidden/unmounted invalid JSON control must not leave its parent form
+  // permanently blocked after a mode change.
+  if (jsonError) onvaliditychange?.(true);
+});
+
+function formatJson(next: unknown): string {
+  if (next === undefined || next === null) return '';
+  return JSON.stringify(next, null, 2);
+}
+
+$effect(() => {
+  // Keep external record updates visible, but never overwrite an invalid JSON
+  // draft while the user is correcting it. Compare serialized text rather than
+  // object identity: callers may pass a fresh record object each render.
+  if (jsonError) return;
+  const next = formatJson(value);
+  if (jsonText !== next) jsonText = next;
+});
+
+function setText(event: Event): void {
+  onvaluechange((event.currentTarget as HTMLInputElement).value);
+}
+
+function setNumber(event: Event, integer: boolean): void {
+  const input = event.currentTarget as HTMLInputElement;
+  // Browsers report incomplete number text (for example a lone sign or an
+  // unfinished exponent) as `value === ''` plus `badInput`. That is not a
+  // deliberate clear, so leave the record untouched until the edit is valid.
+  if (input.validity.badInput) return;
+  const raw = input.value;
+  if (raw === '') {
+    onvaluechange(undefined);
+    return;
+  }
+  const number = Number(raw);
+  // Number inputs can transiently contain incomplete exponent/sign text while
+  // editing. Keep the last valid record value until the browser supplies a
+  // finite number; never leak NaN/Infinity into a create or edit payload.
+  if (!Number.isFinite(number)) return;
+  onvaluechange(integer ? Math.trunc(number) : number);
+}
+
+function setJson(event: Event): void {
+  jsonText = (event.currentTarget as HTMLTextAreaElement).value;
+  if (jsonText.trim() === '') {
+    jsonError = null;
+    onvaliditychange?.(true);
+    onvaluechange(undefined);
+    return;
+  }
+  try {
+    const parsed = JSON.parse(jsonText);
+    jsonError = null;
+    onvaliditychange?.(true);
+    onvaluechange(parsed);
+  } catch {
+    jsonError = 'Enter valid JSON before submitting this form.';
+    onvaliditychange?.(false);
+  }
+}
+
+function formatDateTimeLocal(value: unknown): string {
+  const date = value instanceof Date ? value : new Date(String(value));
+  if (Number.isNaN(date.getTime())) return '';
+  const part = (number: number) => String(number).padStart(2, '0');
+  return `${date.getFullYear()}-${part(date.getMonth() + 1)}-${part(date.getDate())}T${part(date.getHours())}:${part(date.getMinutes())}`;
+}
+
+function setDateTime(event: Event): void {
+  const raw = (event.currentTarget as HTMLInputElement).value;
+  if (!raw) {
+    onvaluechange(undefined);
+    return;
+  }
+  const date = new Date(raw);
+  onvaluechange(Number.isNaN(date.getTime()) ? raw : date.toISOString());
+}
+</script>
+
+{#if field.definition.type === 'boolean'}
+  <Toggle
+    {id}
+    {name}
+    checked={value === true}
+    {disabled}
+    ariaLabel={label ?? name}
+    onchange={onvaluechange}
+  />
+{:else if field.definition.type === 'json'}
+  <Textarea
+    {id}
+    {name}
+    value={jsonText}
+    {disabled}
+    {required}
+    rows={8}
+    aria-invalid={jsonError ? 'true' : undefined}
+    aria-describedby={jsonError ? `${id}-json-error` : undefined}
+    oninput={setJson}
+  />
+  {#if jsonError}
+    <p id={`${id}-json-error`} class="field-input__error" role="alert">{jsonError}</p>
+  {/if}
+{:else if field.definition.type === 'integer' || field.definition.type === 'decimal'}
+  <Input
+    {id}
+    {name}
+    type="number"
+    step={field.definition.type === 'integer' ? '1' : 'any'}
+    value={typeof value === 'number' ? value : ''}
+    {disabled}
+    {required}
+    oninput={(event: Event) => setNumber(event, field.definition.type === 'integer')}
+  />
+{:else if field.definition.type === 'datetime'}
+  <Input
+    {id}
+    {name}
+    type="datetime-local"
+    value={formatDateTimeLocal(value)}
+    {disabled}
+    {required}
+    oninput={setDateTime}
+  />
+{:else}
+  <Input
+    {id}
+    {name}
+    type="text"
+    value={typeof value === 'string' ? value : ''}
+    {disabled}
+    {required}
+    oninput={setText}
+  />
+{/if}
+
+<style>.field-input__error { color: var(--smrt-color-error, #b42318); margin: 0; }</style>

package/dist/svelte/components/FieldInput.svelte.d.ts

@@ -0,0 +1,5 @@
+import type { FieldInputProps } from '../types.js';
+declare const FieldInput: import("svelte").Component<FieldInputProps, {}, "">;
+type FieldInput = ReturnType<typeof FieldInput>;
+export default FieldInput;
+//# sourceMappingURL=FieldInput.svelte.d.ts.map

package/dist/svelte/components/FieldInput.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldInput.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/FieldInput.svelte.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA0HnD,QAAA,MAAM,UAAU,qDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}