@arqel-dev/types 0.8.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arqel Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+# @arqel-dev/types
+
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](../../LICENSE)
+[![TypeScript](https://img.shields.io/badge/typescript-%5E5.6-3178c6.svg)](https://www.typescriptlang.org)
+[![Status](https://img.shields.io/badge/status-pre--alpha-orange.svg)](#)
+
+Shared TypeScript types for the [Arqel](https://arqel.dev) ecosystem — fields, resources, tables, forms, actions, and Inertia shared props.
+
+## Status
+
+🚧 **Pre-alpha** — covers all serialiser shapes from the PHP packages.
+
+## Install
+
+```bash
+pnpm add -D @arqel-dev/types
+```
+
+## Usage
+
+```ts
+// Tree-shake-friendly subpath imports
+import type { FieldSchema, isFieldType } from '@arqel-dev/types/fields';
+import type { ResourceIndexProps, RecordType } from '@arqel-dev/types/resources';
+import type { SharedProps } from '@arqel-dev/types/inertia';
+
+// Or barrel
+import type { FieldSchema, ColumnSchema, FormSchema } from '@arqel-dev/types';
+```
+
+## Convenções
+
+- Zero runtime — só types + 4 type guards (`isFieldType`, `isFieldEntry`, `isLayoutEntry`, `resolveFieldEntry`)
+- `sideEffects: false` para máximo tree-shaking
+- Synced com `Arqel\Core\Support\FieldSchemaSerializer` PHP
+
+## Links
+
+- [Documentação](https://arqel.dev/docs/types) — em construção
+- [PLANNING](../../PLANNING/08-fase-1-mvp.md) — tickets `TYPES-*`

package/SKILL.md

@@ -0,0 +1,121 @@
+# SKILL.md — @arqel-dev/types
+
+> Contexto canónico para AI agents. Estrutura conforme `PLANNING/04-repo-structure.md` §11.
+
+## Purpose
+
+`@arqel-dev/types` é o pacote base de TypeScript types compartilhados por todos os outros pacotes JS do ecossistema Arqel. Materializa em TS o que o PHP serializa (Fields, Tables, Forms, Actions, Resource payloads, Inertia shared props) — um único source of truth para o React side consumir sem reshape.
+
+**Zero runtime** — apenas types + 4 type guards:
+- `isFieldType(field, type)` — narrow `FieldSchema` por tipo discriminator
+- `isFieldEntry(entry)` / `isLayoutEntry(entry)` — narrow `FormSchema` schema entries
+- `resolveFieldEntry(entry, fields)` — lookup de `FieldEntry` no array flat de Fields
+
+## Status
+
+**Entregue (TYPES-001..002, 004 parcial):**
+
+- Pacote npm `@arqel-dev/types` com 7 entry points (`./`, `./fields`, `./resources`, `./tables`, `./forms`, `./actions`, `./inertia`)
+- `tsup` build com `dts: true`, ESM, sourcemaps, tree-shake friendly (`sideEffects: false`)
+- 21 Field types em discriminated union sobre `type`
+- 9 Column types + 6 Filter types em discriminated unions
+- 7 Layout components (Section/Fieldset/Grid/Columns/Group/Tabs/Tab)
+- ResourceMeta, PaginationMeta, ResourceIndex/Create/Edit/Detail props (genéricos sobre `RecordType`)
+- ActionSchema com discriminated `type`, ConfirmationConfig, ActionFormField
+- SharedProps (Inertia) com auth/panel/tenant/flash/translations/arqel
+- Vitest + expect-type para type-level assertions
+- 19+ type-level assertions passando
+
+**Por chegar:**
+
+- Integração documentada com `spatie/laravel-typescript-transformer` (TYPES-003)
+
+## Key Contracts
+
+### FieldSchema (discriminated union)
+
+```ts
+import { type FieldSchema, isFieldType } from '@arqel-dev/types/fields';
+
+function render(field: FieldSchema) {
+    if (isFieldType(field, 'belongsTo')) {
+        // field.props.relatedResource é string (narrowed)
+        return <BelongsToInput resource={field.props.relatedResource} />;
+    }
+
+    if (isFieldType(field, 'select')) {
+        // field.props.options é SelectOption[] | Record<string, string>
+        return <SelectInput options={field.props.options} />;
+    }
+
+    return <TextInput field={field} />;
+}
+```
+
+Cada campo carrega `validation`, `visibility`, `dependsOn` e `props` (type-specific).
+
+### FormSchema + SchemaEntry
+
+```ts
+import { isLayoutEntry, isFieldEntry, type FormSchema } from '@arqel-dev/types/forms';
+
+function renderSchema(form: FormSchema, fields: FieldSchema[]) {
+    return form.schema.map((entry) => {
+        if (isLayoutEntry(entry)) {
+            // entry.type narrows entre 'section'|'fieldset'|...
+            return <LayoutComponent {...entry} />;
+        }
+
+        const resolved = resolveFieldEntry(entry, fields);
+        return resolved ? <FieldRenderer field={resolved} /> : null;
+    });
+}
+```
+
+### Resource page props
+
+```ts
+import type { ResourceIndexProps, RecordType } from '@arqel-dev/types/resources';
+
+interface User extends RecordType {
+    id: number;
+    email: string;
+}
+
+export default function UsersIndex({ resource, records, columns }: ResourceIndexProps<User>) {
+    // records é User[]; columns é ColumnSchema[]
+}
+```
+
+### Inertia SharedProps
+
+```ts
+import type { SharedProps } from '@arqel-dev/types/inertia';
+import { usePage } from '@inertiajs/react';
+
+const { auth, flash } = usePage<SharedProps>().props;
+// auth.user: AuthUserPayload | null
+// auth.can.viewAdminPanel: boolean | undefined
+```
+
+## Conventions
+
+- **Subpath imports** preferidos sobre o barrel para tree-shaking (`@arqel-dev/types/fields` em vez de `@arqel-dev/types`)
+- Discriminated unions usam `type` como discriminator — usa `isFieldType` etc. para narrow
+- `RecordType` é loose por defeito — apps com `spatie/laravel-typescript-transformer` (TYPES-003) substituem por interfaces strict
+- Mantém-se sync com `Arqel\Core\Support\FieldSchemaSerializer` PHP — divergência causa bugs de runtime no React
+
+## Anti-patterns
+
+- ❌ **Casts (`as FieldSchema`)** — usa type guards. Se o PHP emitir um shape inválido, prefere falhar cedo
+- ❌ **Manual reshape** dos payloads no React — o serializer já produz o shape canônico
+- ❌ **`any` em vez de `unknown`** para `defaultValue` / `tenant` — mantém safety, força narrow
+- ❌ **Duplicar Field types** em `@arqel-dev/fields` (UI side) — aquele pacote consome estes types
+- ❌ **Importar `dist/`** diretamente — usa apenas exports `./*` declarados em `package.json`
+
+## Related
+
+- Tickets: [`PLANNING/08-fase-1-mvp.md`](../../PLANNING/08-fase-1-mvp.md) §TYPES-001..004
+- API: [`PLANNING/06-api-react.md`](../../PLANNING/06-api-react.md) §3-7
+- Source: [`packages-js/types/src/`](src/)
+- Tests: [`packages-js/types/tests/`](tests/)

package/dist/actions.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Action schema mirroring `arqel-dev/actions` PHP serialisation.
+ *
+ * The shape is the output of `Action::toArray()` after PHP's
+ * `array_filter(... !== null)` — so optional fields are simply
+ * absent from the payload rather than `null`.
+ */
+type ActionType = 'row' | 'bulk' | 'toolbar' | 'header';
+type ActionColor = 'primary' | 'secondary' | 'destructive' | 'success' | 'warning' | 'info';
+type ActionVariant = 'default' | 'outline' | 'ghost' | 'destructive';
+type ActionMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+type ConfirmationColor = 'destructive' | 'warning' | 'info';
+/**
+ * Modal config emitted when an Action requires confirmation.
+ */
+interface ConfirmationConfig {
+    /** Modal heading. */
+    heading?: string;
+    /** Optional explanation rendered under the heading. */
+    description?: string;
+    /** Heroicon name. */
+    icon?: string;
+    /** Visual variant. Defaults to `destructive`. */
+    color?: ConfirmationColor;
+    /** Force the user to type this exact text before confirming. */
+    requiresText?: string;
+    /** Override for the submit button label. */
+    submitLabel?: string;
+    /** Override for the cancel button label. */
+    cancelLabel?: string;
+}
+type ModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
+/**
+ * Field schema entry used by Action form modals (see `arqel-dev/actions`
+ * `HasForm`). Action form fields are intentionally a flat list —
+ * layout components live in regular `Form` schemas.
+ */
+interface ActionFormField {
+    name: string;
+    type: string;
+}
+/**
+ * Action shape consumed by the React renderer (`<ActionButton>`,
+ * `<ActionMenu>`, `<ActionFormModal>`).
+ */
+interface ActionSchema {
+    name: string;
+    type: ActionType;
+    label: string;
+    icon?: string;
+    color: ActionColor;
+    variant: ActionVariant;
+    method: ActionMethod;
+    /** Resolved URL for link-mode actions; absent for callbacks. */
+    url?: string;
+    tooltip?: string;
+    /** True when the action is disabled per-record. */
+    disabled?: true;
+    /** True when the action requires confirmation. */
+    requiresConfirmation?: true;
+    /** Modal config; absent when confirmation is not required. */
+    confirmation?: ConfirmationConfig;
+    /** Form modal field schema; absent when the action has no form. */
+    form?: ActionFormField[];
+    /** Modal size for form actions. */
+    modalSize?: ModalSize;
+    /** Flash message shown on successful execution. */
+    successNotification?: string;
+    /** Flash message shown when the callback throws. */
+    failureNotification?: string;
+}
+/**
+ * Server-side action collections for a Resource (`Resource::actions`,
+ * `bulkActions`, `toolbarActions`, `headerActions`).
+ */
+interface ResourceActions {
+    row: ActionSchema[];
+    bulk: ActionSchema[];
+    toolbar: ActionSchema[];
+}
+
+export type { ActionColor, ActionFormField, ActionMethod, ActionSchema, ActionType, ActionVariant, ConfirmationColor, ConfirmationConfig, ModalSize, ResourceActions };

package/dist/actions.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=actions.js.map
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"actions.js"}

package/dist/fields.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Field schema mirroring `Arqel\Core\Support\FieldSchemaSerializer`
+ * output. The discriminated union narrows on `type`; per-type
+ * `props` carry the type-specific metadata emitted by each Field's
+ * `getTypeSpecificProps()`.
+ */
+type FieldType = 'text' | 'textarea' | 'email' | 'url' | 'password' | 'slug' | 'number' | 'currency' | 'boolean' | 'toggle' | 'select' | 'multiSelect' | 'radio' | 'belongsTo' | 'hasMany' | 'date' | 'dateTime' | 'file' | 'image' | 'color' | 'hidden';
+interface FieldValidation {
+    rules: string[];
+    messages: Record<string, string>;
+    attribute: string | null;
+}
+/**
+ * Per-context visibility flags (mirrors `HasVisibility::isVisibleIn`).
+ * `canSee` is the per-user/record gate from `HasAuthorization`.
+ */
+interface FieldVisibility {
+    create: boolean;
+    edit: boolean;
+    detail: boolean;
+    table: boolean;
+    canSee: boolean;
+}
+/**
+ * Common shape every Field carries before the discriminated `props`.
+ */
+interface FieldBase<TType extends FieldType, TProps> {
+    type: TType;
+    name: string;
+    label: string | null;
+    component: string | null;
+    required: boolean;
+    readonly: boolean;
+    disabled: boolean;
+    placeholder: string | null;
+    helperText: string | null;
+    defaultValue: unknown;
+    columnSpan: number | string;
+    live: boolean;
+    liveDebounce: number | null;
+    validation: FieldValidation;
+    visibility: FieldVisibility;
+    dependsOn: string[];
+    props: TProps;
+}
+interface TextFieldProps {
+    maxLength?: number;
+    minLength?: number;
+    pattern?: string;
+    autocomplete?: string;
+    mask?: string;
+}
+interface NumberFieldProps {
+    min?: number;
+    max?: number;
+    step?: number | string;
+    integer?: boolean;
+    decimals?: number;
+}
+interface CurrencyFieldProps extends NumberFieldProps {
+    prefix: string;
+    suffix?: string;
+    thousandsSeparator: string;
+    decimalSeparator: string;
+}
+interface BooleanFieldProps {
+    inline?: boolean;
+}
+interface ToggleFieldProps {
+    onLabel?: string;
+    offLabel?: string;
+}
+interface SelectOption {
+    value: string | number;
+    label: string;
+}
+interface SelectFieldProps {
+    options: SelectOption[] | Record<string, string>;
+    searchable?: boolean;
+    multiple?: boolean;
+    placeholder?: string;
+}
+interface MultiSelectFieldProps extends SelectFieldProps {
+    multiple: true;
+}
+interface RadioFieldProps {
+    options: SelectOption[];
+    inline?: boolean;
+}
+interface BelongsToFieldProps {
+    relatedResource: string;
+    relationship: string;
+    searchable: boolean;
+    searchColumns: string[];
+    preload: boolean;
+    /** Set client-side from the panel routes. */
+    searchRoute?: string;
+}
+interface HasManyFieldProps {
+    relatedResource: string;
+    relationship: string;
+    canAddRecords?: boolean;
+    canEditRecords?: boolean;
+}
+interface DateFieldProps {
+    format: string;
+    displayFormat: string;
+    minDate?: string;
+    maxDate?: string;
+    closeOnDateSelection?: boolean;
+    timezone?: string;
+}
+interface DateTimeFieldProps extends DateFieldProps {
+    seconds?: boolean;
+}
+interface FileFieldProps {
+    disk: string;
+    directory?: string;
+    visibility?: 'public' | 'private';
+    maxSize?: number;
+    acceptedFileTypes?: string[];
+    multiple?: boolean;
+    reorderable?: boolean;
+    strategy?: string;
+    /** Set client-side from the panel routes. */
+    uploadRoute?: string;
+}
+interface ImageFieldProps extends FileFieldProps {
+    aspectRatio?: number;
+    crop?: boolean;
+}
+type ColorFormat = 'hex' | 'rgb' | 'hsl';
+interface ColorFieldProps {
+    presets?: string[];
+    format?: ColorFormat;
+    alpha?: boolean;
+}
+interface SlugFieldProps extends TextFieldProps {
+    reservedSlugs?: string[];
+}
+type TextFieldSchema = FieldBase<'text', TextFieldProps>;
+type TextareaFieldSchema = FieldBase<'textarea', TextFieldProps>;
+type EmailFieldSchema = FieldBase<'email', TextFieldProps>;
+type UrlFieldSchema = FieldBase<'url', TextFieldProps>;
+type PasswordFieldSchema = FieldBase<'password', TextFieldProps>;
+type SlugFieldSchema = FieldBase<'slug', SlugFieldProps>;
+type NumberFieldSchema = FieldBase<'number', NumberFieldProps>;
+type CurrencyFieldSchema = FieldBase<'currency', CurrencyFieldProps>;
+type BooleanFieldSchema = FieldBase<'boolean', BooleanFieldProps>;
+type ToggleFieldSchema = FieldBase<'toggle', ToggleFieldProps>;
+type SelectFieldSchema = FieldBase<'select', SelectFieldProps>;
+type MultiSelectFieldSchema = FieldBase<'multiSelect', MultiSelectFieldProps>;
+type RadioFieldSchema = FieldBase<'radio', RadioFieldProps>;
+type BelongsToFieldSchema = FieldBase<'belongsTo', BelongsToFieldProps>;
+type HasManyFieldSchema = FieldBase<'hasMany', HasManyFieldProps>;
+type DateFieldSchema = FieldBase<'date', DateFieldProps>;
+type DateTimeFieldSchema = FieldBase<'dateTime', DateTimeFieldProps>;
+type FileFieldSchema = FieldBase<'file', FileFieldProps>;
+type ImageFieldSchema = FieldBase<'image', ImageFieldProps>;
+type ColorFieldSchema = FieldBase<'color', ColorFieldProps>;
+type HiddenFieldSchema = FieldBase<'hidden', Record<string, never>>;
+type FieldSchema = TextFieldSchema | TextareaFieldSchema | EmailFieldSchema | UrlFieldSchema | PasswordFieldSchema | SlugFieldSchema | NumberFieldSchema | CurrencyFieldSchema | BooleanFieldSchema | ToggleFieldSchema | SelectFieldSchema | MultiSelectFieldSchema | RadioFieldSchema | BelongsToFieldSchema | HasManyFieldSchema | DateFieldSchema | DateTimeFieldSchema | FileFieldSchema | ImageFieldSchema | ColorFieldSchema | HiddenFieldSchema;
+declare function isFieldType<T extends FieldType>(field: FieldSchema, type: T): field is Extract<FieldSchema, {
+    type: T;
+}>;
+
+export { type BelongsToFieldProps, type BelongsToFieldSchema, type BooleanFieldProps, type BooleanFieldSchema, type ColorFieldProps, type ColorFieldSchema, type ColorFormat, type CurrencyFieldProps, type CurrencyFieldSchema, type DateFieldProps, type DateFieldSchema, type DateTimeFieldProps, type DateTimeFieldSchema, type EmailFieldSchema, type FieldSchema, type FieldType, type FieldValidation, type FieldVisibility, type FileFieldProps, type FileFieldSchema, type HasManyFieldProps, type HasManyFieldSchema, type HiddenFieldSchema, type ImageFieldProps, type ImageFieldSchema, type MultiSelectFieldProps, type MultiSelectFieldSchema, type NumberFieldProps, type NumberFieldSchema, type PasswordFieldSchema, type RadioFieldProps, type RadioFieldSchema, type SelectFieldProps, type SelectFieldSchema, type SelectOption, type SlugFieldProps, type SlugFieldSchema, type TextFieldProps, type TextFieldSchema, type TextareaFieldSchema, type ToggleFieldProps, type ToggleFieldSchema, type UrlFieldSchema, isFieldType };

package/dist/fields.js

@@ -0,0 +1,8 @@
+// src/fields.ts
+function isFieldType(field, type) {
+  return field.type === type;
+}
+
+export { isFieldType };
+//# sourceMappingURL=fields.js.map
+//# sourceMappingURL=fields.js.map

package/dist/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fields.ts"],"names":[],"mappings":";AA2OO,SAAS,WAAA,CACd,OACA,IAAA,EAC4C;AAC5C,EAAA,OAAO,MAAM,IAAA,KAAS,IAAA;AACxB","file":"fields.js","sourcesContent":["/**\n * Field schema mirroring `Arqel\\Core\\Support\\FieldSchemaSerializer`\n * output. The discriminated union narrows on `type`; per-type\n * `props` carry the type-specific metadata emitted by each Field's\n * `getTypeSpecificProps()`.\n */\n\nexport type FieldType =\n  | 'text'\n  | 'textarea'\n  | 'email'\n  | 'url'\n  | 'password'\n  | 'slug'\n  | 'number'\n  | 'currency'\n  | 'boolean'\n  | 'toggle'\n  | 'select'\n  | 'multiSelect'\n  | 'radio'\n  | 'belongsTo'\n  | 'hasMany'\n  | 'date'\n  | 'dateTime'\n  | 'file'\n  | 'image'\n  | 'color'\n  | 'hidden';\n\nexport interface FieldValidation {\n  rules: string[];\n  messages: Record<string, string>;\n  attribute: string | null;\n}\n\n/**\n * Per-context visibility flags (mirrors `HasVisibility::isVisibleIn`).\n * `canSee` is the per-user/record gate from `HasAuthorization`.\n */\nexport interface FieldVisibility {\n  create: boolean;\n  edit: boolean;\n  detail: boolean;\n  table: boolean;\n  canSee: boolean;\n}\n\n/**\n * Common shape every Field carries before the discriminated `props`.\n */\ninterface FieldBase<TType extends FieldType, TProps> {\n  type: TType;\n  name: string;\n  label: string | null;\n  component: string | null;\n  required: boolean;\n  readonly: boolean;\n  disabled: boolean;\n  placeholder: string | null;\n  helperText: string | null;\n  defaultValue: unknown;\n  columnSpan: number | string;\n  live: boolean;\n  liveDebounce: number | null;\n  validation: FieldValidation;\n  visibility: FieldVisibility;\n  dependsOn: string[];\n  props: TProps;\n}\n\n/* ─── Per-type props ────────────────────────────────────────────── */\n\nexport interface TextFieldProps {\n  maxLength?: number;\n  minLength?: number;\n  pattern?: string;\n  autocomplete?: string;\n  mask?: string;\n}\n\nexport interface NumberFieldProps {\n  min?: number;\n  max?: number;\n  step?: number | string;\n  integer?: boolean;\n  decimals?: number;\n}\n\nexport interface CurrencyFieldProps extends NumberFieldProps {\n  prefix: string;\n  suffix?: string;\n  thousandsSeparator: string;\n  decimalSeparator: string;\n}\n\nexport interface BooleanFieldProps {\n  inline?: boolean;\n}\n\nexport interface ToggleFieldProps {\n  onLabel?: string;\n  offLabel?: string;\n}\n\nexport interface SelectOption {\n  value: string | number;\n  label: string;\n}\n\nexport interface SelectFieldProps {\n  options: SelectOption[] | Record<string, string>;\n  searchable?: boolean;\n  multiple?: boolean;\n  placeholder?: string;\n}\n\nexport interface MultiSelectFieldProps extends SelectFieldProps {\n  multiple: true;\n}\n\nexport interface RadioFieldProps {\n  options: SelectOption[];\n  inline?: boolean;\n}\n\nexport interface BelongsToFieldProps {\n  relatedResource: string;\n  relationship: string;\n  searchable: boolean;\n  searchColumns: string[];\n  preload: boolean;\n  /** Set client-side from the panel routes. */\n  searchRoute?: string;\n}\n\nexport interface HasManyFieldProps {\n  relatedResource: string;\n  relationship: string;\n  canAddRecords?: boolean;\n  canEditRecords?: boolean;\n}\n\nexport interface DateFieldProps {\n  format: string;\n  displayFormat: string;\n  minDate?: string;\n  maxDate?: string;\n  closeOnDateSelection?: boolean;\n  timezone?: string;\n}\n\nexport interface DateTimeFieldProps extends DateFieldProps {\n  seconds?: boolean;\n}\n\nexport interface FileFieldProps {\n  disk: string;\n  directory?: string;\n  visibility?: 'public' | 'private';\n  maxSize?: number;\n  acceptedFileTypes?: string[];\n  multiple?: boolean;\n  reorderable?: boolean;\n  strategy?: string;\n  /** Set client-side from the panel routes. */\n  uploadRoute?: string;\n}\n\nexport interface ImageFieldProps extends FileFieldProps {\n  aspectRatio?: number;\n  crop?: boolean;\n}\n\nexport type ColorFormat = 'hex' | 'rgb' | 'hsl';\n\nexport interface ColorFieldProps {\n  presets?: string[];\n  format?: ColorFormat;\n  alpha?: boolean;\n}\n\nexport interface SlugFieldProps extends TextFieldProps {\n  reservedSlugs?: string[];\n}\n\n/* ─── Discriminated union ───────────────────────────────────────── */\n\nexport type TextFieldSchema = FieldBase<'text', TextFieldProps>;\nexport type TextareaFieldSchema = FieldBase<'textarea', TextFieldProps>;\nexport type EmailFieldSchema = FieldBase<'email', TextFieldProps>;\nexport type UrlFieldSchema = FieldBase<'url', TextFieldProps>;\nexport type PasswordFieldSchema = FieldBase<'password', TextFieldProps>;\nexport type SlugFieldSchema = FieldBase<'slug', SlugFieldProps>;\nexport type NumberFieldSchema = FieldBase<'number', NumberFieldProps>;\nexport type CurrencyFieldSchema = FieldBase<'currency', CurrencyFieldProps>;\nexport type BooleanFieldSchema = FieldBase<'boolean', BooleanFieldProps>;\nexport type ToggleFieldSchema = FieldBase<'toggle', ToggleFieldProps>;\nexport type SelectFieldSchema = FieldBase<'select', SelectFieldProps>;\nexport type MultiSelectFieldSchema = FieldBase<'multiSelect', MultiSelectFieldProps>;\nexport type RadioFieldSchema = FieldBase<'radio', RadioFieldProps>;\nexport type BelongsToFieldSchema = FieldBase<'belongsTo', BelongsToFieldProps>;\nexport type HasManyFieldSchema = FieldBase<'hasMany', HasManyFieldProps>;\nexport type DateFieldSchema = FieldBase<'date', DateFieldProps>;\nexport type DateTimeFieldSchema = FieldBase<'dateTime', DateTimeFieldProps>;\nexport type FileFieldSchema = FieldBase<'file', FileFieldProps>;\nexport type ImageFieldSchema = FieldBase<'image', ImageFieldProps>;\nexport type ColorFieldSchema = FieldBase<'color', ColorFieldProps>;\nexport type HiddenFieldSchema = FieldBase<'hidden', Record<string, never>>;\n\nexport type FieldSchema =\n  | TextFieldSchema\n  | TextareaFieldSchema\n  | EmailFieldSchema\n  | UrlFieldSchema\n  | PasswordFieldSchema\n  | SlugFieldSchema\n  | NumberFieldSchema\n  | CurrencyFieldSchema\n  | BooleanFieldSchema\n  | ToggleFieldSchema\n  | SelectFieldSchema\n  | MultiSelectFieldSchema\n  | RadioFieldSchema\n  | BelongsToFieldSchema\n  | HasManyFieldSchema\n  | DateFieldSchema\n  | DateTimeFieldSchema\n  | FileFieldSchema\n  | ImageFieldSchema\n  | ColorFieldSchema\n  | HiddenFieldSchema;\n\n/* ─── Type guards ───────────────────────────────────────────────── */\n\nexport function isFieldType<T extends FieldType>(\n  field: FieldSchema,\n  type: T,\n): field is Extract<FieldSchema, { type: T }> {\n  return field.type === type;\n}\n"]}

package/dist/forms.d.ts

@@ -0,0 +1,95 @@
+import { FieldSchema } from './fields.js';
+
+/**
+ * Form schema mirroring `arqel-dev/form` PHP serialisation.
+ *
+ * The `Form::toArray()` payload is a heterogeneous list of entries
+ * tagged by `kind`: a `field` carries `{name, type}` (the React
+ * side resolves the full Field schema from the Resource fields
+ * array), while a `layout` entry carries `{type, component,
+ * columnSpan, props}` plus the component's own children.
+ */
+
+type LayoutType = 'section' | 'fieldset' | 'grid' | 'columns' | 'group' | 'tabs' | 'tab';
+interface FieldEntry {
+    kind: 'field';
+    name: string;
+    type: string;
+}
+interface LayoutBase<TType extends LayoutType, TProps> {
+    kind: 'layout';
+    type: TType;
+    component: string;
+    columnSpan: number | string;
+    props: TProps;
+    /** Schema may include further entries (recursive). */
+    schema?: SchemaEntry[];
+}
+interface SectionProps {
+    heading: string;
+    description?: string;
+    icon?: string;
+    collapsible?: boolean;
+    collapsed?: boolean;
+    columns: number;
+    compact?: boolean;
+    aside?: boolean;
+}
+interface FieldsetProps {
+    legend: string;
+    columns: number;
+}
+interface GridProps {
+    columns: number | Record<string, number>;
+    gap?: string;
+}
+interface ColumnsProps {
+    columns: 2;
+}
+type GroupOrientation = 'horizontal' | 'vertical';
+interface GroupProps {
+    orientation: GroupOrientation;
+}
+type TabsOrientation = 'horizontal' | 'vertical';
+interface TabsProps {
+    defaultTab: string | null;
+    orientation: TabsOrientation;
+}
+interface TabProps {
+    id: string;
+    label: string;
+    icon?: string;
+    badge?: number;
+}
+type SectionEntry = LayoutBase<'section', SectionProps>;
+type FieldsetEntry = LayoutBase<'fieldset', FieldsetProps>;
+type GridEntry = LayoutBase<'grid', GridProps>;
+type ColumnsEntry = LayoutBase<'columns', ColumnsProps>;
+type GroupEntry = LayoutBase<'group', GroupProps>;
+type TabsEntry = LayoutBase<'tabs', TabsProps>;
+type TabEntry = LayoutBase<'tab', TabProps>;
+type LayoutEntry = SectionEntry | FieldsetEntry | GridEntry | ColumnsEntry | GroupEntry | TabsEntry | TabEntry;
+type SchemaEntry = FieldEntry | LayoutEntry;
+/**
+ * The full `Form::toArray()` payload.
+ */
+interface FormSchema {
+    schema: SchemaEntry[];
+    columns: number;
+    model: string | null;
+    inline: boolean;
+    disabled: boolean;
+}
+/**
+ * Type guard narrowing on `kind`.
+ */
+declare function isLayoutEntry(entry: SchemaEntry): entry is LayoutEntry;
+declare function isFieldEntry(entry: SchemaEntry): entry is FieldEntry;
+/**
+ * Resolve a `FieldEntry`'s full schema by name from a flat list
+ * of Field schemas. Returns `null` when the field is missing —
+ * authoring sites typically render a fallback.
+ */
+declare function resolveFieldEntry(entry: FieldEntry, fields: FieldSchema[]): FieldSchema | null;
+
+export { type ColumnsEntry, type ColumnsProps, type FieldEntry, type FieldsetEntry, type FieldsetProps, type FormSchema, type GridEntry, type GridProps, type GroupEntry, type GroupOrientation, type GroupProps, type LayoutEntry, type LayoutType, type SchemaEntry, type SectionEntry, type SectionProps, type TabEntry, type TabProps, type TabsEntry, type TabsOrientation, type TabsProps, isFieldEntry, isLayoutEntry, resolveFieldEntry };

package/dist/forms.js

@@ -0,0 +1,14 @@
+// src/forms.ts
+function isLayoutEntry(entry) {
+  return entry.kind === "layout";
+}
+function isFieldEntry(entry) {
+  return entry.kind === "field";
+}
+function resolveFieldEntry(entry, fields) {
+  return fields.find((field) => field.name === entry.name) ?? null;
+}
+
+export { isFieldEntry, isLayoutEntry, resolveFieldEntry };
+//# sourceMappingURL=forms.js.map
+//# sourceMappingURL=forms.js.map

package/dist/forms.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/forms.ts"],"names":[],"mappings":";AA8GO,SAAS,cAAc,KAAA,EAA0C;AACtE,EAAA,OAAO,MAAM,IAAA,KAAS,QAAA;AACxB;AAEO,SAAS,aAAa,KAAA,EAAyC;AACpE,EAAA,OAAO,MAAM,IAAA,KAAS,OAAA;AACxB;AAOO,SAAS,iBAAA,CAAkB,OAAmB,MAAA,EAA2C;AAC9F,EAAA,OAAO,MAAA,CAAO,KAAK,CAAC,KAAA,KAAU,MAAM,IAAA,KAAS,KAAA,CAAM,IAAI,CAAA,IAAK,IAAA;AAC9D","file":"forms.js","sourcesContent":["/**\n * Form schema mirroring `arqel-dev/form` PHP serialisation.\n *\n * The `Form::toArray()` payload is a heterogeneous list of entries\n * tagged by `kind`: a `field` carries `{name, type}` (the React\n * side resolves the full Field schema from the Resource fields\n * array), while a `layout` entry carries `{type, component,\n * columnSpan, props}` plus the component's own children.\n */\n\nimport type { FieldSchema } from './fields.js';\n\nexport type LayoutType = 'section' | 'fieldset' | 'grid' | 'columns' | 'group' | 'tabs' | 'tab';\n\nexport interface FieldEntry {\n  kind: 'field';\n  name: string;\n  type: string;\n}\n\ninterface LayoutBase<TType extends LayoutType, TProps> {\n  kind: 'layout';\n  type: TType;\n  component: string;\n  columnSpan: number | string;\n  props: TProps;\n  /** Schema may include further entries (recursive). */\n  schema?: SchemaEntry[];\n}\n\n/* ─── Layout props ──────────────────────────────────────────────── */\n\nexport interface SectionProps {\n  heading: string;\n  description?: string;\n  icon?: string;\n  collapsible?: boolean;\n  collapsed?: boolean;\n  columns: number;\n  compact?: boolean;\n  aside?: boolean;\n}\n\nexport interface FieldsetProps {\n  legend: string;\n  columns: number;\n}\n\nexport interface GridProps {\n  columns: number | Record<string, number>;\n  gap?: string;\n}\n\nexport interface ColumnsProps {\n  columns: 2;\n}\n\nexport type GroupOrientation = 'horizontal' | 'vertical';\n\nexport interface GroupProps {\n  orientation: GroupOrientation;\n}\n\nexport type TabsOrientation = 'horizontal' | 'vertical';\n\nexport interface TabsProps {\n  defaultTab: string | null;\n  orientation: TabsOrientation;\n}\n\nexport interface TabProps {\n  id: string;\n  label: string;\n  icon?: string;\n  badge?: number;\n}\n\nexport type SectionEntry = LayoutBase<'section', SectionProps>;\nexport type FieldsetEntry = LayoutBase<'fieldset', FieldsetProps>;\nexport type GridEntry = LayoutBase<'grid', GridProps>;\nexport type ColumnsEntry = LayoutBase<'columns', ColumnsProps>;\nexport type GroupEntry = LayoutBase<'group', GroupProps>;\nexport type TabsEntry = LayoutBase<'tabs', TabsProps>;\nexport type TabEntry = LayoutBase<'tab', TabProps>;\n\nexport type LayoutEntry =\n  | SectionEntry\n  | FieldsetEntry\n  | GridEntry\n  | ColumnsEntry\n  | GroupEntry\n  | TabsEntry\n  | TabEntry;\n\nexport type SchemaEntry = FieldEntry | LayoutEntry;\n\n/**\n * The full `Form::toArray()` payload.\n */\nexport interface FormSchema {\n  schema: SchemaEntry[];\n  columns: number;\n  model: string | null;\n  inline: boolean;\n  disabled: boolean;\n}\n\n/**\n * Type guard narrowing on `kind`.\n */\nexport function isLayoutEntry(entry: SchemaEntry): entry is LayoutEntry {\n  return entry.kind === 'layout';\n}\n\nexport function isFieldEntry(entry: SchemaEntry): entry is FieldEntry {\n  return entry.kind === 'field';\n}\n\n/**\n * Resolve a `FieldEntry`'s full schema by name from a flat list\n * of Field schemas. Returns `null` when the field is missing —\n * authoring sites typically render a fallback.\n */\nexport function resolveFieldEntry(entry: FieldEntry, fields: FieldSchema[]): FieldSchema | null {\n  return fields.find((field) => field.name === entry.name) ?? null;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { ActionColor, ActionFormField, ActionMethod, ActionSchema, ActionType, ActionVariant, ConfirmationColor, ConfirmationConfig, ModalSize, ResourceActions } from './actions.js';
+export { BelongsToFieldProps, BelongsToFieldSchema, BooleanFieldProps, BooleanFieldSchema, ColorFieldProps, ColorFieldSchema, ColorFormat, CurrencyFieldProps, CurrencyFieldSchema, DateFieldProps, DateFieldSchema, DateTimeFieldProps, DateTimeFieldSchema, EmailFieldSchema, FieldSchema, FieldType, FieldValidation, FieldVisibility, FileFieldProps, FileFieldSchema, HasManyFieldProps, HasManyFieldSchema, HiddenFieldSchema, ImageFieldProps, ImageFieldSchema, MultiSelectFieldProps, MultiSelectFieldSchema, NumberFieldProps, NumberFieldSchema, PasswordFieldSchema, RadioFieldProps, RadioFieldSchema, SelectFieldProps, SelectFieldSchema, SelectOption, SlugFieldProps, SlugFieldSchema, TextFieldProps, TextFieldSchema, TextareaFieldSchema, ToggleFieldProps, ToggleFieldSchema, UrlFieldSchema, isFieldType } from './fields.js';
+export { ColumnsEntry, ColumnsProps, FieldEntry, FieldsetEntry, FieldsetProps, FormSchema, GridEntry, GridProps, GroupEntry, GroupOrientation, GroupProps, LayoutEntry, LayoutType, SchemaEntry, SectionEntry, SectionProps, TabEntry, TabProps, TabsEntry, TabsOrientation, TabsProps, isFieldEntry, isLayoutEntry, resolveFieldEntry } from './forms.js';
+export { ArqelMeta, ArqelPageProps, AuthPayload, AuthUserPayload, FlashPayload, PanelPayload, SharedProps } from './inertia.js';
+export { PaginationMeta, PlainResourceIndexProps, RecordType, ResourceCreateProps, ResourceDetailProps, ResourceEditProps, ResourceIndexProps, ResourceMeta } from './resources.js';
+export { BadgeColumnProps, BadgeColumnSchema, BadgeOption, BooleanColumnProps, BooleanColumnSchema, ColumnAlign, ColumnSchema, ColumnType, ComputedColumnProps, ComputedColumnSchema, DateColumnMode, DateColumnProps, DateColumnSchema, DateRangeFilterProps, DateRangeFilterSchema, FilterSchema, FilterType, IconColumnProps, IconColumnSchema, ImageColumnProps, ImageColumnSchema, ImageColumnShape, MultiSelectFilterSchema, NumberColumnProps, NumberColumnSchema, RelationshipColumnProps, RelationshipColumnSchema, ScopeFilterSchema, SelectFilterProps, SelectFilterSchema, SortDirection, TableSort, TernaryFilterProps, TernaryFilterSchema, TernaryState, TextColumnProps, TextColumnSchema, TextFilterSchema } from './tables.js';

package/dist/index.js

@@ -0,0 +1,19 @@
+// src/fields.ts
+function isFieldType(field, type) {
+  return field.type === type;
+}
+
+// src/forms.ts
+function isLayoutEntry(entry) {
+  return entry.kind === "layout";
+}
+function isFieldEntry(entry) {
+  return entry.kind === "field";
+}
+function resolveFieldEntry(entry, fields) {
+  return fields.find((field) => field.name === entry.name) ?? null;
+}
+
+export { isFieldEntry, isFieldType, isLayoutEntry, resolveFieldEntry };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fields.ts","../src/forms.ts"],"names":[],"mappings":";AA2OO,SAAS,WAAA,CACd,OACA,IAAA,EAC4C;AAC5C,EAAA,OAAO,MAAM,IAAA,KAAS,IAAA;AACxB;;;AClIO,SAAS,cAAc,KAAA,EAA0C;AACtE,EAAA,OAAO,MAAM,IAAA,KAAS,QAAA;AACxB;AAEO,SAAS,aAAa,KAAA,EAAyC;AACpE,EAAA,OAAO,MAAM,IAAA,KAAS,OAAA;AACxB;AAOO,SAAS,iBAAA,CAAkB,OAAmB,MAAA,EAA2C;AAC9F,EAAA,OAAO,MAAA,CAAO,KAAK,CAAC,KAAA,KAAU,MAAM,IAAA,KAAS,KAAA,CAAM,IAAI,CAAA,IAAK,IAAA;AAC9D","file":"index.js","sourcesContent":["/**\n * Field schema mirroring `Arqel\\Core\\Support\\FieldSchemaSerializer`\n * output. The discriminated union narrows on `type`; per-type\n * `props` carry the type-specific metadata emitted by each Field's\n * `getTypeSpecificProps()`.\n */\n\nexport type FieldType =\n  | 'text'\n  | 'textarea'\n  | 'email'\n  | 'url'\n  | 'password'\n  | 'slug'\n  | 'number'\n  | 'currency'\n  | 'boolean'\n  | 'toggle'\n  | 'select'\n  | 'multiSelect'\n  | 'radio'\n  | 'belongsTo'\n  | 'hasMany'\n  | 'date'\n  | 'dateTime'\n  | 'file'\n  | 'image'\n  | 'color'\n  | 'hidden';\n\nexport interface FieldValidation {\n  rules: string[];\n  messages: Record<string, string>;\n  attribute: string | null;\n}\n\n/**\n * Per-context visibility flags (mirrors `HasVisibility::isVisibleIn`).\n * `canSee` is the per-user/record gate from `HasAuthorization`.\n */\nexport interface FieldVisibility {\n  create: boolean;\n  edit: boolean;\n  detail: boolean;\n  table: boolean;\n  canSee: boolean;\n}\n\n/**\n * Common shape every Field carries before the discriminated `props`.\n */\ninterface FieldBase<TType extends FieldType, TProps> {\n  type: TType;\n  name: string;\n  label: string | null;\n  component: string | null;\n  required: boolean;\n  readonly: boolean;\n  disabled: boolean;\n  placeholder: string | null;\n  helperText: string | null;\n  defaultValue: unknown;\n  columnSpan: number | string;\n  live: boolean;\n  liveDebounce: number | null;\n  validation: FieldValidation;\n  visibility: FieldVisibility;\n  dependsOn: string[];\n  props: TProps;\n}\n\n/* ─── Per-type props ────────────────────────────────────────────── */\n\nexport interface TextFieldProps {\n  maxLength?: number;\n  minLength?: number;\n  pattern?: string;\n  autocomplete?: string;\n  mask?: string;\n}\n\nexport interface NumberFieldProps {\n  min?: number;\n  max?: number;\n  step?: number | string;\n  integer?: boolean;\n  decimals?: number;\n}\n\nexport interface CurrencyFieldProps extends NumberFieldProps {\n  prefix: string;\n  suffix?: string;\n  thousandsSeparator: string;\n  decimalSeparator: string;\n}\n\nexport interface BooleanFieldProps {\n  inline?: boolean;\n}\n\nexport interface ToggleFieldProps {\n  onLabel?: string;\n  offLabel?: string;\n}\n\nexport interface SelectOption {\n  value: string | number;\n  label: string;\n}\n\nexport interface SelectFieldProps {\n  options: SelectOption[] | Record<string, string>;\n  searchable?: boolean;\n  multiple?: boolean;\n  placeholder?: string;\n}\n\nexport interface MultiSelectFieldProps extends SelectFieldProps {\n  multiple: true;\n}\n\nexport interface RadioFieldProps {\n  options: SelectOption[];\n  inline?: boolean;\n}\n\nexport interface BelongsToFieldProps {\n  relatedResource: string;\n  relationship: string;\n  searchable: boolean;\n  searchColumns: string[];\n  preload: boolean;\n  /** Set client-side from the panel routes. */\n  searchRoute?: string;\n}\n\nexport interface HasManyFieldProps {\n  relatedResource: string;\n  relationship: string;\n  canAddRecords?: boolean;\n  canEditRecords?: boolean;\n}\n\nexport interface DateFieldProps {\n  format: string;\n  displayFormat: string;\n  minDate?: string;\n  maxDate?: string;\n  closeOnDateSelection?: boolean;\n  timezone?: string;\n}\n\nexport interface DateTimeFieldProps extends DateFieldProps {\n  seconds?: boolean;\n}\n\nexport interface FileFieldProps {\n  disk: string;\n  directory?: string;\n  visibility?: 'public' | 'private';\n  maxSize?: number;\n  acceptedFileTypes?: string[];\n  multiple?: boolean;\n  reorderable?: boolean;\n  strategy?: string;\n  /** Set client-side from the panel routes. */\n  uploadRoute?: string;\n}\n\nexport interface ImageFieldProps extends FileFieldProps {\n  aspectRatio?: number;\n  crop?: boolean;\n}\n\nexport type ColorFormat = 'hex' | 'rgb' | 'hsl';\n\nexport interface ColorFieldProps {\n  presets?: string[];\n  format?: ColorFormat;\n  alpha?: boolean;\n}\n\nexport interface SlugFieldProps extends TextFieldProps {\n  reservedSlugs?: string[];\n}\n\n/* ─── Discriminated union ───────────────────────────────────────── */\n\nexport type TextFieldSchema = FieldBase<'text', TextFieldProps>;\nexport type TextareaFieldSchema = FieldBase<'textarea', TextFieldProps>;\nexport type EmailFieldSchema = FieldBase<'email', TextFieldProps>;\nexport type UrlFieldSchema = FieldBase<'url', TextFieldProps>;\nexport type PasswordFieldSchema = FieldBase<'password', TextFieldProps>;\nexport type SlugFieldSchema = FieldBase<'slug', SlugFieldProps>;\nexport type NumberFieldSchema = FieldBase<'number', NumberFieldProps>;\nexport type CurrencyFieldSchema = FieldBase<'currency', CurrencyFieldProps>;\nexport type BooleanFieldSchema = FieldBase<'boolean', BooleanFieldProps>;\nexport type ToggleFieldSchema = FieldBase<'toggle', ToggleFieldProps>;\nexport type SelectFieldSchema = FieldBase<'select', SelectFieldProps>;\nexport type MultiSelectFieldSchema = FieldBase<'multiSelect', MultiSelectFieldProps>;\nexport type RadioFieldSchema = FieldBase<'radio', RadioFieldProps>;\nexport type BelongsToFieldSchema = FieldBase<'belongsTo', BelongsToFieldProps>;\nexport type HasManyFieldSchema = FieldBase<'hasMany', HasManyFieldProps>;\nexport type DateFieldSchema = FieldBase<'date', DateFieldProps>;\nexport type DateTimeFieldSchema = FieldBase<'dateTime', DateTimeFieldProps>;\nexport type FileFieldSchema = FieldBase<'file', FileFieldProps>;\nexport type ImageFieldSchema = FieldBase<'image', ImageFieldProps>;\nexport type ColorFieldSchema = FieldBase<'color', ColorFieldProps>;\nexport type HiddenFieldSchema = FieldBase<'hidden', Record<string, never>>;\n\nexport type FieldSchema =\n  | TextFieldSchema\n  | TextareaFieldSchema\n  | EmailFieldSchema\n  | UrlFieldSchema\n  | PasswordFieldSchema\n  | SlugFieldSchema\n  | NumberFieldSchema\n  | CurrencyFieldSchema\n  | BooleanFieldSchema\n  | ToggleFieldSchema\n  | SelectFieldSchema\n  | MultiSelectFieldSchema\n  | RadioFieldSchema\n  | BelongsToFieldSchema\n  | HasManyFieldSchema\n  | DateFieldSchema\n  | DateTimeFieldSchema\n  | FileFieldSchema\n  | ImageFieldSchema\n  | ColorFieldSchema\n  | HiddenFieldSchema;\n\n/* ─── Type guards ───────────────────────────────────────────────── */\n\nexport function isFieldType<T extends FieldType>(\n  field: FieldSchema,\n  type: T,\n): field is Extract<FieldSchema, { type: T }> {\n  return field.type === type;\n}\n","/**\n * Form schema mirroring `arqel-dev/form` PHP serialisation.\n *\n * The `Form::toArray()` payload is a heterogeneous list of entries\n * tagged by `kind`: a `field` carries `{name, type}` (the React\n * side resolves the full Field schema from the Resource fields\n * array), while a `layout` entry carries `{type, component,\n * columnSpan, props}` plus the component's own children.\n */\n\nimport type { FieldSchema } from './fields.js';\n\nexport type LayoutType = 'section' | 'fieldset' | 'grid' | 'columns' | 'group' | 'tabs' | 'tab';\n\nexport interface FieldEntry {\n  kind: 'field';\n  name: string;\n  type: string;\n}\n\ninterface LayoutBase<TType extends LayoutType, TProps> {\n  kind: 'layout';\n  type: TType;\n  component: string;\n  columnSpan: number | string;\n  props: TProps;\n  /** Schema may include further entries (recursive). */\n  schema?: SchemaEntry[];\n}\n\n/* ─── Layout props ──────────────────────────────────────────────── */\n\nexport interface SectionProps {\n  heading: string;\n  description?: string;\n  icon?: string;\n  collapsible?: boolean;\n  collapsed?: boolean;\n  columns: number;\n  compact?: boolean;\n  aside?: boolean;\n}\n\nexport interface FieldsetProps {\n  legend: string;\n  columns: number;\n}\n\nexport interface GridProps {\n  columns: number | Record<string, number>;\n  gap?: string;\n}\n\nexport interface ColumnsProps {\n  columns: 2;\n}\n\nexport type GroupOrientation = 'horizontal' | 'vertical';\n\nexport interface GroupProps {\n  orientation: GroupOrientation;\n}\n\nexport type TabsOrientation = 'horizontal' | 'vertical';\n\nexport interface TabsProps {\n  defaultTab: string | null;\n  orientation: TabsOrientation;\n}\n\nexport interface TabProps {\n  id: string;\n  label: string;\n  icon?: string;\n  badge?: number;\n}\n\nexport type SectionEntry = LayoutBase<'section', SectionProps>;\nexport type FieldsetEntry = LayoutBase<'fieldset', FieldsetProps>;\nexport type GridEntry = LayoutBase<'grid', GridProps>;\nexport type ColumnsEntry = LayoutBase<'columns', ColumnsProps>;\nexport type GroupEntry = LayoutBase<'group', GroupProps>;\nexport type TabsEntry = LayoutBase<'tabs', TabsProps>;\nexport type TabEntry = LayoutBase<'tab', TabProps>;\n\nexport type LayoutEntry =\n  | SectionEntry\n  | FieldsetEntry\n  | GridEntry\n  | ColumnsEntry\n  | GroupEntry\n  | TabsEntry\n  | TabEntry;\n\nexport type SchemaEntry = FieldEntry | LayoutEntry;\n\n/**\n * The full `Form::toArray()` payload.\n */\nexport interface FormSchema {\n  schema: SchemaEntry[];\n  columns: number;\n  model: string | null;\n  inline: boolean;\n  disabled: boolean;\n}\n\n/**\n * Type guard narrowing on `kind`.\n */\nexport function isLayoutEntry(entry: SchemaEntry): entry is LayoutEntry {\n  return entry.kind === 'layout';\n}\n\nexport function isFieldEntry(entry: SchemaEntry): entry is FieldEntry {\n  return entry.kind === 'field';\n}\n\n/**\n * Resolve a `FieldEntry`'s full schema by name from a flat list\n * of Field schemas. Returns `null` when the field is missing —\n * authoring sites typically render a fallback.\n */\nexport function resolveFieldEntry(entry: FieldEntry, fields: FieldSchema[]): FieldSchema | null {\n  return fields.find((field) => field.name === entry.name) ?? null;\n}\n"]}

package/dist/inertia.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Inertia shared props injected by
+ * `Arqel\Core\Http\Middleware\HandleArqelInertiaRequests`.
+ *
+ * Apps extend the Inertia `PageProps` interface so every page
+ * receives `auth`, `panel`, `tenant`, `flash`, `translations`,
+ * `arqel.version` for free.
+ */
+interface AuthUserPayload {
+    id: number | string;
+    name?: string | null;
+    email?: string | null;
+}
+interface AuthPayload {
+    user: AuthUserPayload | null;
+    /** Shape: `{ ability: boolean, ... }` from `AbilityRegistry`. */
+    can: Record<string, boolean>;
+}
+interface PanelPayload {
+    id: string;
+    path: string;
+    /** `Panel::brand()` → `{ name, logo? }`. */
+    brand: {
+        name: string;
+        logo: string | null;
+    };
+}
+interface FlashPayload {
+    success: string | null;
+    error: string | null;
+    info: string | null;
+    warning: string | null;
+}
+interface ArqelMeta {
+    version: string;
+}
+/**
+ * The full set of shared props every Arqel page receives.
+ */
+interface SharedProps {
+    auth: AuthPayload;
+    panel: PanelPayload | null;
+    /** Tenant payload — null in Phase 1 (scaffold only). */
+    tenant: unknown;
+    flash: FlashPayload;
+    /** Translation map under the `arqel::*` namespace. */
+    translations: Record<string, unknown>;
+    arqel: ArqelMeta;
+}
+/**
+ * Convenience alias for Inertia v3 `usePage<T>()`. Apps with extra
+ * shared props extend via intersection: `SharedProps & MyShared`.
+ */
+type ArqelPageProps = SharedProps;
+
+export type { ArqelMeta, ArqelPageProps, AuthPayload, AuthUserPayload, FlashPayload, PanelPayload, SharedProps };

package/dist/inertia.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=inertia.js.map
+//# sourceMappingURL=inertia.js.map

package/dist/inertia.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"inertia.js"}

package/dist/resources.d.ts

@@ -0,0 +1,91 @@
+import { ResourceActions } from './actions.js';
+import { FieldSchema } from './fields.js';
+import { ColumnSchema, FilterSchema, TableSort } from './tables.js';
+
+/**
+ * Resource-level Inertia payloads — the shapes returned by
+ * `InertiaDataBuilder::buildIndexData/CreateData/EditData/ShowData`.
+ */
+
+/**
+ * Loose record shape — apps that opt into
+ * `spatie/laravel-typescript-transformer` (TYPES-003) replace this
+ * with strongly-typed `interface User { id: number; ... }` etc.
+ */
+type RecordType = Record<string, unknown> & {
+    id: number | string;
+    arqel?: {
+        title?: string;
+        subtitle?: string | null;
+    };
+};
+/**
+ * Resource metadata block (`InertiaDataBuilder::resourceMeta`).
+ */
+interface ResourceMeta {
+    class: string;
+    slug: string;
+    label: string;
+    pluralLabel: string;
+    navigationIcon: string | null;
+    navigationGroup: string | null;
+}
+/**
+ * Pagination payload (`Illuminate\Pagination\LengthAwarePaginator`
+ * stripped for Inertia).
+ */
+interface PaginationMeta {
+    currentPage: number;
+    lastPage: number;
+    perPage: number;
+    total: number;
+}
+/**
+ * Index page props — the rich Table flavour, used when
+ * `Resource::table()` returns an Arqel Table.
+ */
+interface ResourceIndexProps<TRecord extends RecordType = RecordType> {
+    resource: ResourceMeta;
+    records: TRecord[];
+    pagination: PaginationMeta | null;
+    columns: ColumnSchema[];
+    filters: FilterSchema[];
+    actions: ResourceActions;
+    search: string | null;
+    sort: TableSort;
+}
+/**
+ * Index page props — plain (no Table) flavour.
+ */
+interface PlainResourceIndexProps<TRecord extends RecordType = RecordType> {
+    resource: ResourceMeta;
+    records: TRecord[];
+    pagination: PaginationMeta;
+    fields: FieldSchema[];
+}
+/**
+ * Create page props (no record context).
+ */
+interface ResourceCreateProps {
+    resource: ResourceMeta;
+    record: null;
+    fields: FieldSchema[];
+}
+/**
+ * Edit page props — record + fields (record-aware visibility +
+ * readonly applied server-side).
+ */
+interface ResourceEditProps<TRecord extends RecordType = RecordType> {
+    resource: ResourceMeta;
+    record: TRecord;
+    recordTitle: string;
+    recordSubtitle: string | null;
+    fields: FieldSchema[];
+}
+/**
+ * Show / detail page props — same shape as edit; React renders
+ * fields read-only.
+ */
+type ResourceDetailProps<TRecord extends RecordType = RecordType> = ResourceEditProps<TRecord>;
+
+export type { PaginationMeta, PlainResourceIndexProps, RecordType, ResourceCreateProps, ResourceDetailProps, ResourceEditProps, ResourceIndexProps, ResourceMeta };

package/dist/resources.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=resources.js.map
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"resources.js"}

package/dist/tables.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Table column schema mirroring `arqel-dev/table` PHP serialisation.
+ */
+type ColumnType = 'text' | 'badge' | 'boolean' | 'date' | 'number' | 'icon' | 'image' | 'relationship' | 'computed';
+type ColumnAlign = 'start' | 'center' | 'end';
+type DateColumnMode = 'date' | 'datetime' | 'since';
+type ImageColumnShape = 'square' | 'circular';
+type SortDirection = 'asc' | 'desc';
+interface ColumnBase<TType extends ColumnType, TProps = Record<string, never>> {
+    type: TType;
+    name: string;
+    label: string | null;
+    sortable: boolean;
+    searchable: boolean;
+    copyable: boolean;
+    hidden: boolean;
+    hiddenOnMobile: boolean;
+    align: ColumnAlign;
+    width: string | null;
+    tooltip: string | null;
+    /** Resolved URL for clickable cells. */
+    url?: string;
+    props: TProps;
+}
+interface TextColumnProps {
+    truncate?: number;
+    color?: string;
+    weight?: 'normal' | 'medium' | 'bold';
+}
+interface BadgeOption {
+    value: string | number | boolean;
+    label?: string;
+    color?: string;
+    icon?: string;
+}
+interface BadgeColumnProps {
+    options?: BadgeOption[];
+    pill?: boolean;
+}
+interface BooleanColumnProps {
+    trueIcon?: string;
+    falseIcon?: string;
+    trueColor?: string;
+    falseColor?: string;
+}
+interface DateColumnProps {
+    mode: DateColumnMode;
+    format?: string;
+    timezone?: string;
+}
+interface NumberColumnProps {
+    decimals?: number;
+    thousandsSeparator?: string;
+    decimalSeparator?: string;
+    prefix?: string;
+    suffix?: string;
+}
+interface IconColumnProps {
+    icon: string;
+    color?: string;
+    size?: 'sm' | 'md' | 'lg';
+}
+interface ImageColumnProps {
+    shape?: ImageColumnShape;
+    size?: number;
+    rounded?: boolean;
+}
+interface RelationshipColumnProps {
+    relationship: string;
+    attribute: string;
+}
+interface ComputedColumnProps {
+    /** Closure-resolved values are emitted directly per row. */
+    placeholder?: string;
+}
+type TextColumnSchema = ColumnBase<'text', TextColumnProps>;
+type BadgeColumnSchema = ColumnBase<'badge', BadgeColumnProps>;
+type BooleanColumnSchema = ColumnBase<'boolean', BooleanColumnProps>;
+type DateColumnSchema = ColumnBase<'date', DateColumnProps>;
+type NumberColumnSchema = ColumnBase<'number', NumberColumnProps>;
+type IconColumnSchema = ColumnBase<'icon', IconColumnProps>;
+type ImageColumnSchema = ColumnBase<'image', ImageColumnProps>;
+type RelationshipColumnSchema = ColumnBase<'relationship', RelationshipColumnProps>;
+type ComputedColumnSchema = ColumnBase<'computed', ComputedColumnProps>;
+type ColumnSchema = TextColumnSchema | BadgeColumnSchema | BooleanColumnSchema | DateColumnSchema | NumberColumnSchema | IconColumnSchema | ImageColumnSchema | RelationshipColumnSchema | ComputedColumnSchema;
+type FilterType = 'select' | 'multiSelect' | 'dateRange' | 'text' | 'ternary' | 'scope';
+interface FilterBase<TType extends FilterType, TProps = Record<string, never>> {
+    type: TType;
+    name: string;
+    label: string | null;
+    persist: boolean;
+    default: unknown;
+    props: TProps;
+}
+interface SelectFilterProps {
+    options: {
+        value: string | number;
+        label: string;
+    }[];
+}
+interface DateRangeFilterProps {
+    minDate?: string;
+    maxDate?: string;
+}
+type TernaryState = 'true' | 'false' | 'all';
+interface TernaryFilterProps {
+    trueLabel?: string;
+    falseLabel?: string;
+    allLabel?: string;
+}
+type SelectFilterSchema = FilterBase<'select', SelectFilterProps>;
+type MultiSelectFilterSchema = FilterBase<'multiSelect', SelectFilterProps>;
+type DateRangeFilterSchema = FilterBase<'dateRange', DateRangeFilterProps>;
+type TextFilterSchema = FilterBase<'text'>;
+type TernaryFilterSchema = FilterBase<'ternary', TernaryFilterProps>;
+type ScopeFilterSchema = FilterBase<'scope'>;
+type FilterSchema = SelectFilterSchema | MultiSelectFilterSchema | DateRangeFilterSchema | TextFilterSchema | TernaryFilterSchema | ScopeFilterSchema;
+interface TableSort {
+    column: string | null;
+    direction: SortDirection | null;
+}
+
+export type { BadgeColumnProps, BadgeColumnSchema, BadgeOption, BooleanColumnProps, BooleanColumnSchema, ColumnAlign, ColumnSchema, ColumnType, ComputedColumnProps, ComputedColumnSchema, DateColumnMode, DateColumnProps, DateColumnSchema, DateRangeFilterProps, DateRangeFilterSchema, FilterSchema, FilterType, IconColumnProps, IconColumnSchema, ImageColumnProps, ImageColumnSchema, ImageColumnShape, MultiSelectFilterSchema, NumberColumnProps, NumberColumnSchema, RelationshipColumnProps, RelationshipColumnSchema, ScopeFilterSchema, SelectFilterProps, SelectFilterSchema, SortDirection, TableSort, TernaryFilterProps, TernaryFilterSchema, TernaryState, TextColumnProps, TextColumnSchema, TextFilterSchema };

package/dist/tables.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=tables.js.map
+//# sourceMappingURL=tables.js.map

package/dist/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"tables.js"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@arqel-dev/types",
+  "version": "0.8.0",
+  "description": "Shared TypeScript types for Arqel — fields, resources, tables, forms, actions, and Inertia shared props.",
+  "license": "MIT",
+  "homepage": "https://arqel.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arqel-dev/arqel.git",
+    "directory": "packages-js/types"
+  },
+  "keywords": [
+    "arqel",
+    "laravel",
+    "inertia",
+    "typescript",
+    "types"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./fields": {
+      "types": "./dist/fields.d.ts",
+      "import": "./dist/fields.js"
+    },
+    "./resources": {
+      "types": "./dist/resources.d.ts",
+      "import": "./dist/resources.js"
+    },
+    "./tables": {
+      "types": "./dist/tables.d.ts",
+      "import": "./dist/tables.js"
+    },
+    "./forms": {
+      "types": "./dist/forms.d.ts",
+      "import": "./dist/forms.js"
+    },
+    "./actions": {
+      "types": "./dist/actions.d.ts",
+      "import": "./dist/actions.js"
+    },
+    "./inertia": {
+      "types": "./dist/inertia.d.ts",
+      "import": "./dist/inertia.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "SKILL.md"
+  ],
+  "devDependencies": {
+    "expect-type": "^1.2.2",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check --diagnostic-level=error src tests",
+    "format": "biome format --write src tests",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}