@happyvertical/smrt-fields 0.40.59 → 0.40.61

package/dist/svelte/playground/FieldPolicyFormPreview.svelte

@@ -0,0 +1,212 @@
+<script lang="ts">
+/**
+ * Playground preview (#2048 AC1): a hand-written widget form that adopts
+ * PolicyField on a subset of its fields WITHOUT giving up its markup.
+ *
+ * The resolved policy is passed as a prop (the headless contract — the app
+ * supplies the policy, no smrt-web import). Two fields adopt PolicyField
+ * (name, sku) to gain help hints + required markers + prefill; the remaining
+ * fields stay as raw hand-written markup, proving "unwrapped fields keep
+ * working untouched" and "no layout change".
+ *
+ * The Basic/Advanced switch + disclosure + form help demonstrate the mode UX
+ * and glossary affordances layered over the same hand-written form.
+ */
+import { Input, Textarea } from '@happyvertical/smrt-ui/forms';
+import { Button } from '@happyvertical/smrt-ui/ui';
+import type { ResolvedObjectFieldPolicy } from '../../types.js';
+import {
+  AdvancedFields,
+  FieldPolicyProvider,
+  FormHelp,
+  ModeSwitch,
+  PolicyField,
+} from '../index.js';
+
+/**
+ * A resolved policy shaped exactly like `resolveFieldPolicy()` / the
+ * `resolveBatch` endpoint response. In a real app this comes from the server
+ * or the batch endpoint; here it is a static fixture for the mock playground.
+ */
+const resolvedPolicy: ResolvedObjectFieldPolicy = {
+  objectRef: '@happyvertical/smrt-products:Product',
+  fields: {
+    name: {
+      fieldName: 'name',
+      hasDefault: false,
+      defaultValue: undefined,
+      visibility: 'basic',
+      help: 'The customer-facing product name. Keep it short and unique.',
+      label: 'Product name',
+      order: 1,
+      group: null,
+      locked: false,
+      required: true,
+    },
+    sku: {
+      fieldName: 'sku',
+      hasDefault: true,
+      defaultValue: 'SKU-0000',
+      visibility: 'basic',
+      help: 'Stock-keeping unit. Auto-prefilled from the code default.',
+      label: 'SKU',
+      order: 2,
+      group: null,
+      locked: false,
+      required: false,
+    },
+    wholesalePrice: {
+      fieldName: 'wholesalePrice',
+      hasDefault: true,
+      defaultValue: 0,
+      visibility: 'advanced',
+      help: 'Per-unit price for wholesale channels. Hidden in basic mode.',
+      label: 'Wholesale price',
+      order: 3,
+      group: 'pricing',
+      locked: false,
+      required: false,
+    },
+    reorderPoint: {
+      fieldName: 'reorderPoint',
+      hasDefault: false,
+      defaultValue: undefined,
+      visibility: 'advanced',
+      help: 'Inventory level that triggers a reorder suggestion.',
+      label: 'Reorder point',
+      order: 4,
+      group: 'inventory',
+      locked: false,
+      required: false,
+    },
+  },
+};
+
+let name = $state('');
+let sku = $state('');
+let wholesalePrice = $state('');
+let reorderPoint = $state('');
+// A raw, unwrapped field — deliberately NOT wrapped in PolicyField.
+let rawNotes = $state('');
+
+let submitted = $state<string | null>(null);
+
+function handleSubmit() {
+  submitted = `Saved "${name || '(unnamed)'}" (sku: ${sku || '(auto)'})`;
+}
+</script>
+
+<section class="field-policy-preview">
+  <header class="preview-header">
+    <h2>Hand-written form adopting PolicyField</h2>
+    <p class="preview-desc">
+      A developer-authored product form. Two fields (name, SKU) adopt
+      PolicyField for help, defaults, and progressive disclosure; the rest stay
+      hand-written. Toggle the mode switch to reveal advanced-tier fields.
+    </p>
+    <FormHelp
+      objectDescription="A sellable catalog product with wholesale pricing and inventory controls."
+    />
+  </header>
+
+  <FieldPolicyProvider policy={resolvedPolicy} mode="basic">
+    <div class="toolbar">
+      <ModeSwitch />
+    </div>
+
+    <form class="widget-form" onsubmit={(e) => { e.preventDefault(); handleSubmit(); }}>
+      <!-- Adopted field: gets label, help hint, required marker from the policy -->
+      <PolicyField name="name">
+        <Input id="name" name="name" bind:value={name} placeholder="Widget Deluxe" />
+      </PolicyField>
+
+      <!-- Adopted field: prefilled with the resolved default on new records -->
+      <PolicyField name="sku">
+        <Input id="sku" name="sku" bind:value={sku} />
+      </PolicyField>
+
+      <!-- Unwrapped hand-written field — keeps working untouched -->
+      <div class="raw-field">
+        <label for="rawNotes">Notes (unwrapped, hand-written)</label>
+        <Textarea
+          id="rawNotes"
+          name="rawNotes"
+          bind:value={rawNotes}
+          placeholder="Free-form notes, no policy wrapping"
+        />
+      </div>
+
+      <!-- Advanced-tier fields live in the disclosure -->
+      <AdvancedFields>
+        <PolicyField name="wholesalePrice">
+          <Input id="wholesalePrice" name="wholesalePrice" type="number" bind:value={wholesalePrice} />
+        </PolicyField>
+        <PolicyField name="reorderPoint">
+          <Input id="reorderPoint" name="reorderPoint" type="number" bind:value={reorderPoint} />
+        </PolicyField>
+      </AdvancedFields>
+
+      <div class="actions">
+        <Button type="submit">Save product</Button>
+      </div>
+    </form>
+
+    {#if submitted}
+      <p class="status" role="status">{submitted}</p>
+    {/if}
+  </FieldPolicyProvider>
+</section>
+
+<style>
+  .field-policy-preview {
+    display: flex;
+    flex-direction: column;
+    gap: var(--smrt-spacing-4, 1rem);
+    max-width: 40rem;
+  }
+
+  .preview-header h2 {
+    font: var(--smrt-typography-headline-small-font, inherit);
+    margin: 0 0 var(--smrt-spacing-1, 0.25rem);
+  }
+
+  .preview-desc {
+    font: var(--smrt-typography-body-medium-font, inherit);
+    color: var(--smrt-color-on-surface-variant, currentColor);
+    margin: 0 0 var(--smrt-spacing-2, 0.5rem);
+  }
+
+  .toolbar {
+    display: flex;
+    justify-content: flex-end;
+    margin-bottom: var(--smrt-spacing-3, 0.75rem);
+  }
+
+  .widget-form {
+    display: flex;
+    flex-direction: column;
+    gap: var(--smrt-spacing-3, 0.75rem);
+  }
+
+  .raw-field {
+    display: flex;
+    flex-direction: column;
+    gap: var(--smrt-spacing-1, 0.25rem);
+  }
+
+  .raw-field label {
+    font: var(--smrt-typography-label-large-font, inherit);
+    color: var(--smrt-color-on-surface, currentColor);
+  }
+
+  .actions {
+    display: flex;
+    gap: var(--smrt-spacing-2, 0.5rem);
+    padding-top: var(--smrt-spacing-2, 0.5rem);
+  }
+
+  .status {
+    font: var(--smrt-typography-body-medium-font, inherit);
+    color: var(--smrt-color-primary, #6750a4);
+  }
+</style>

package/dist/svelte/playground/FieldPolicyFormPreview.svelte.d.ts

@@ -0,0 +1,4 @@
+declare const FieldPolicyFormPreview: import("svelte").Component<Record<string, never>, {}, "">;
+type FieldPolicyFormPreview = ReturnType<typeof FieldPolicyFormPreview>;
+export default FieldPolicyFormPreview;
+//# sourceMappingURL=FieldPolicyFormPreview.svelte.d.ts.map

package/dist/svelte/playground/FieldPolicyFormPreview.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldPolicyFormPreview.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/playground/FieldPolicyFormPreview.svelte.ts"],"names":[],"mappings":"AAqKA,QAAA,MAAM,sBAAsB,2DAAwC,CAAC;AACrE,KAAK,sBAAsB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACxE,eAAe,sBAAsB,CAAC"}

package/dist/svelte/playground/ObjectFormPreview.svelte

@@ -0,0 +1,129 @@
+<script lang="ts">
+/** Generated-form showcase for ObjectForm, including a custom field snippet. */
+import { Input } from '@happyvertical/smrt-ui/forms';
+import type { ResolvedObjectFieldPolicy } from '../../types.js';
+import {
+  ObjectForm,
+  ObjectFormSourceProvider,
+  ObjectFormSourceRegistry,
+} from '../index.js';
+import type {
+  ObjectFormFieldDefinition,
+  ObjectFormFieldSnippetProps,
+} from '../types.js';
+
+const fields: Record<string, ObjectFormFieldDefinition> = {
+  name: { type: 'text', required: true },
+  sku: { type: 'text' },
+  price: { type: 'decimal', ui: { group: 'Pricing', order: 3 } },
+  active: { type: 'boolean', ui: { group: 'Publishing', order: 4 } },
+  metadata: { type: 'json', ui: { group: 'Publishing', order: 5 } },
+};
+
+const policy: ResolvedObjectFieldPolicy = {
+  objectRef: '@happyvertical/smrt-products:Product',
+  fields: {
+    name: {
+      fieldName: 'name',
+      hasDefault: false,
+      defaultValue: undefined,
+      visibility: 'basic',
+      help: 'A customer-facing product name.',
+      label: 'Product name',
+      order: 1,
+      group: null,
+      locked: false,
+      required: true,
+    },
+    sku: {
+      fieldName: 'sku',
+      hasDefault: true,
+      defaultValue: 'SKU-0000',
+      visibility: 'basic',
+      help: 'Uses a custom snippet renderer.',
+      label: 'SKU',
+      order: 2,
+      group: null,
+      locked: false,
+      required: false,
+    },
+    price: {
+      fieldName: 'price',
+      hasDefault: false,
+      defaultValue: undefined,
+      visibility: 'advanced',
+      help: null,
+      label: 'Price',
+      order: 3,
+      group: 'Pricing',
+      locked: false,
+      required: false,
+    },
+    active: {
+      fieldName: 'active',
+      hasDefault: true,
+      defaultValue: true,
+      visibility: 'advanced',
+      help: null,
+      label: 'Active',
+      order: 4,
+      group: 'Publishing',
+      locked: false,
+      required: false,
+    },
+    metadata: {
+      fieldName: 'metadata',
+      hasDefault: false,
+      defaultValue: undefined,
+      visibility: 'advanced',
+      help: 'Structured publishing metadata.',
+      label: 'Metadata',
+      order: 5,
+      group: 'Publishing',
+      locked: false,
+      required: false,
+    },
+  },
+};
+
+const source = new ObjectFormSourceRegistry({
+  resolveBatch: async () => ({ policies: { [policy.objectRef]: policy } }),
+});
+source.register({ objectRef: policy.objectRef, fields });
+
+let record = $state<Record<string, unknown>>({});
+</script>
+
+{#snippet skuRenderer(props: ObjectFormFieldSnippetProps)}
+  <Input
+    id="sku"
+    name="sku"
+    value={String(props.value ?? '')}
+    disabled={props.disabled}
+    aria-label="Custom SKU"
+    oninput={(event) => props.setValue((event.currentTarget as HTMLInputElement).value.toUpperCase())}
+  />
+{/snippet}
+
+<section class="object-form-preview">
+  <h2>Generated ObjectForm</h2>
+  <p>
+    This single form is driven by browser-safe fields and resolved policy. Basic
+    fields render immediately; advanced grouped fields appear after switching mode.
+    SKU is a per-field custom snippet.
+  </p>
+  <ObjectFormSourceProvider {source}>
+    <ObjectForm
+      objectRef={policy.objectRef}
+      bind:value={record}
+      renderers={{ sku: skuRenderer }}
+    />
+  </ObjectFormSourceProvider>
+  <output class="record-preview">{JSON.stringify(record)}</output>
+</section>
+
+<style>
+  .object-form-preview { display: grid; gap: var(--smrt-spacing-3, 0.75rem); max-width: 40rem; }
+  h2, p { margin: 0; }
+  .record-preview { font: var(--smrt-typography-body-small-font, monospace); color: var(--smrt-color-on-surface-variant, currentColor); overflow-wrap: anywhere; }
+</style>

package/dist/svelte/playground/ObjectFormPreview.svelte.d.ts

@@ -0,0 +1,4 @@
+declare const ObjectFormPreview: import("svelte").Component<Record<string, never>, {}, "">;
+type ObjectFormPreview = ReturnType<typeof ObjectFormPreview>;
+export default ObjectFormPreview;
+//# sourceMappingURL=ObjectFormPreview.svelte.d.ts.map

package/dist/svelte/playground/ObjectFormPreview.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectFormPreview.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/playground/ObjectFormPreview.svelte.ts"],"names":[],"mappings":"AA8HA,QAAA,MAAM,iBAAiB,2DAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}

package/dist/svelte/playground.d.ts

@@ -0,0 +1,20 @@
+declare const _default: {
+    packageName: string;
+    displayName: string;
+    description: string;
+    entries: {
+        id: string;
+        title: string;
+        description: string;
+        loadComponent: () => Promise<typeof import("./playground/FieldPolicyFormPreview.svelte")>;
+        order: number;
+        tags: string[];
+        modes: {
+            mock: {
+                label: string;
+            };
+        };
+    }[];
+};
+export default _default;
+//# sourceMappingURL=playground.d.ts.map

package/dist/svelte/playground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../../src/svelte/playground.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAWA,wBA+BE"}

package/dist/svelte/playground.js

@@ -0,0 +1,38 @@
+/**
+ * Field-policy playground previews (#2048).
+ *
+ * Registered with the shared playground host via the auto-discovered
+ * "packages/STAR/src/svelte/playground.ts" convention (smrt-playground vite
+ * plugin).
+ */
+const loadFieldPolicyForm = () => import('./playground/FieldPolicyFormPreview.svelte');
+const loadObjectForm = () => import('./playground/ObjectFormPreview.svelte');
+export default {
+    packageName: '@happyvertical/smrt-fields',
+    displayName: 'Field Policies',
+    description: 'Headless form primitives: FieldPolicyProvider, PolicyField, basic/advanced modes, and manifest-sourced help.',
+    entries: [
+        {
+            id: 'policy-form',
+            title: 'Policy-Driven Form',
+            description: 'A hand-written product form adopting PolicyField on a subset of fields — visibility by mode, default prefill, help hints, and the form-level glossary.',
+            loadComponent: loadFieldPolicyForm,
+            order: 1,
+            tags: ['forms', 'fields', 'policy', 'defaults'],
+            modes: {
+                mock: {
+                    label: 'Mock',
+                },
+            },
+        },
+        {
+            id: 'object-form',
+            title: 'Generated ObjectForm',
+            description: 'A reusable create/edit form from generated web fields and resolved policy, including advanced groups and a per-field custom renderer.',
+            loadComponent: loadObjectForm,
+            order: 2,
+            tags: ['forms', 'fields', 'object-form', 'registry'],
+            modes: { mock: { label: 'Mock' } },
+        },
+    ],
+};

package/dist/svelte/settings-catalog.d.ts

@@ -0,0 +1,54 @@
+/** Browser-safe view helpers for the field-policy settings catalog. */
+import type { FieldPolicyDetailItem, FieldPolicySettingsCatalogData, FieldPolicySettingsCatalogPage, FieldPolicySummaryItem } from '../settings-catalog.js';
+import type { FieldPolicyAuditSnapshot, FieldPolicyDriftRow, FieldPolicyVisibility, ResolvedFieldPolicy } from '../types.js';
+import type { FieldPolicyEditorAdapter } from './field-policy-editor.js';
+export declare const MAX_FIELD_POLICY_AUDIT_OBJECT_REFS = 100;
+export interface FieldPolicyControlPanelAdapter extends FieldPolicyEditorAdapter {
+    loadAudit(input?: {
+        objectRefs?: string[];
+        countObjectRefs?: string[];
+        includeDrift?: boolean;
+    }): Promise<FieldPolicyAuditSnapshot>;
+}
+/** Keeps every catalog navigation path on the caller-selected page size. */
+export declare function fieldPolicyCatalogPreservedParams(data: Pick<FieldPolicySettingsCatalogData, 'page' | 'filters'>): Record<string, string>;
+export interface FieldPolicyLayerCell {
+    contributed: boolean;
+    defaultValue: unknown;
+    hasDefault: boolean;
+    locked: boolean;
+    visibility: FieldPolicyVisibility;
+    visibilityForced: boolean;
+}
+export interface FieldPolicyFieldRollup {
+    known: boolean;
+    code: FieldPolicyLayerCell;
+    app: FieldPolicyLayerCell;
+    org: FieldPolicyLayerCell;
+    userCount: number;
+    orgRow?: FieldPolicyAuditSnapshot['orgRows'][number];
+    appRow?: FieldPolicyAuditSnapshot['appRows'][number];
+    resolved?: ResolvedFieldPolicy;
+}
+export declare function auditObjectRefs(page: Pick<FieldPolicySettingsCatalogPage, 'items' | 'selected'>): {
+    objectRefs: string[];
+    countObjectRefs: string[];
+};
+export declare function fieldPolicyRollup(audit: FieldPolicyAuditSnapshot, objectRef: string, fieldName: string): FieldPolicyFieldRollup;
+export declare function decorateCatalogPage(page: FieldPolicySettingsCatalogPage, audit: FieldPolicyAuditSnapshot): FieldPolicySettingsCatalogPage;
+export declare function decorateCatalogItem<T extends FieldPolicySummaryItem>(item: T, audit: FieldPolicyAuditSnapshot): Omit<T, 'label' | 'description' | 'status'> & FieldPolicySummaryItem;
+export declare function orgRowIdsForObject(audit: FieldPolicyAuditSnapshot, objectRef: string): string[];
+export declare function prunableDriftRows(audit: FieldPolicyAuditSnapshot): FieldPolicyDriftRow[];
+/** Structural tenant-nav seam; hosts supply it to AdminShell's tenant edge. */
+export declare function fieldPolicyControlPanelNavItem(options: {
+    href: string;
+    permissions?: readonly string[];
+    label?: string;
+    icon?: string;
+}): {
+    href: string;
+    label: string;
+    icon?: string;
+} | null;
+export type { FieldPolicyDetailItem };
+//# sourceMappingURL=settings-catalog.d.ts.map

package/dist/svelte/settings-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-catalog.d.ts","sourceRoot":"","sources":["../../src/svelte/settings-catalog.ts"],"names":[],"mappings":"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"}

package/dist/svelte/settings-catalog.js

@@ -0,0 +1,116 @@
+/** Browser-safe view helpers for the field-policy settings catalog. */
+export const MAX_FIELD_POLICY_AUDIT_OBJECT_REFS = 100;
+/** Keeps every catalog navigation path on the caller-selected page size. */
+export function fieldPolicyCatalogPreservedParams(data) {
+    return {
+        ...(data.filters.packageFilter
+            ? { package: data.filters.packageFilter }
+            : {}),
+        ...(data.filters.objectFilter ? { object: data.filters.objectFilter } : {}),
+        ...(data.filters.customizedOnly ? { customized: '1' } : {}),
+        pageSize: String(data.page.pageSize),
+    };
+}
+export function auditObjectRefs(page) {
+    const countObjectRefs = [
+        ...new Set([
+            ...(page.selected ? [page.selected.objectRef] : []),
+            ...page.items.map((item) => item.objectRef),
+        ]),
+    ];
+    return {
+        objectRefs: countObjectRefs.slice(0, MAX_FIELD_POLICY_AUDIT_OBJECT_REFS),
+        countObjectRefs,
+    };
+}
+export function fieldPolicyRollup(audit, objectRef, fieldName) {
+    const policy = audit.policies[objectRef];
+    const resolved = policy?.fields[fieldName];
+    const layers = policy?.layers[fieldName] ?? [];
+    const cell = (tiers, own) => {
+        let defaultValue;
+        let hasDefault = false;
+        let visibility = 'basic';
+        let locked = false;
+        const accepted = layers.filter((layer) => tiers.includes(layer.layer));
+        for (const layer of accepted) {
+            if (layer.delta.default) {
+                hasDefault = true;
+                defaultValue = layer.delta.default.value;
+            }
+            if (layer.delta.visibility)
+                visibility = layer.delta.visibility;
+            if (layer.delta.locked !== undefined)
+                locked = layer.delta.locked;
+        }
+        const visibilityForced = resolved?.visibilityForced === true && visibility !== 'basic';
+        return {
+            contributed: accepted.some((layer) => layer.layer === own),
+            defaultValue,
+            hasDefault,
+            visibility: visibilityForced ? 'basic' : visibility,
+            locked,
+            visibilityForced,
+        };
+    };
+    return {
+        known: resolved !== undefined,
+        code: cell(['code'], 'code'),
+        app: cell(['code', 'app'], 'app'),
+        org: cell(['code', 'app', 'tenant'], 'tenant'),
+        userCount: audit.userOverrideCounts[objectRef]?.[fieldName] ?? 0,
+        orgRow: audit.orgRows.find((row) => row.objectRef === objectRef && row.fieldName === fieldName),
+        appRow: audit.appRows.find((row) => row.objectRef === objectRef && row.fieldName === fieldName),
+        ...(resolved ? { resolved } : {}),
+    };
+}
+export function decorateCatalogPage(page, audit) {
+    return {
+        ...page,
+        items: page.items.map((item) => decorateCatalogItem(item, audit)),
+        selected: page.selected ? decorateCatalogItem(page.selected, audit) : null,
+    };
+}
+export function decorateCatalogItem(item, audit) {
+    const rollup = fieldPolicyRollup(audit, item.objectRef, item.fieldName);
+    const status = [
+        rollup.app.contributed || rollup.appRow ? 'App' : null,
+        rollup.org.contributed || rollup.orgRow ? 'Organization' : null,
+        rollup.userCount
+            ? `${rollup.userCount} user override${rollup.userCount === 1 ? '' : 's'}`
+            : null,
+    ]
+        .filter(Boolean)
+        .join(' · ');
+    return {
+        ...item,
+        label: rollup.resolved?.label ?? humanize(item.fieldName),
+        description: rollup.resolved?.help ?? item.description,
+        ...(status ? { status } : {}),
+    };
+}
+export function orgRowIdsForObject(audit, objectRef) {
+    return audit.orgRows
+        .filter((row) => row.objectRef === objectRef)
+        .map((row) => row.id);
+}
+export function prunableDriftRows(audit) {
+    return audit.driftRows.filter((row) => row.prunable);
+}
+/** Structural tenant-nav seam; hosts supply it to AdminShell's tenant edge. */
+export function fieldPolicyControlPanelNavItem(options) {
+    if (options.permissions &&
+        !options.permissions.includes('fields.policy.manage'))
+        return null;
+    return {
+        href: options.href,
+        label: options.label ?? 'Field settings',
+        ...(options.icon ? { icon: options.icon } : {}),
+    };
+}
+function humanize(value) {
+    return value
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/[_-]+/g, ' ')
+        .replace(/^./, (character) => character.toUpperCase());
+}