Arkyn Releases
This file centralizes release notes for the documentation and package set of the Arkyn ecosystem.
v3.0.1-beta.146
Date: 2026-06-13
Status: New FullCalendar component with day, week, and month views.
Changes By Package
@arkyn/components
- Added new
FullCalendar component — an interactive calendar supporting three built-in views: day, week, and month.
- The component is composed of the following internal sub-modules:
FullCalendarProvider — React context that manages navigation state (viewDate), event list, and navigation actions (nextDay, previousWeek, nextMonth, etc.).
ViewService — pure service class responsible for computing time grids (hours list, 30-min slots from 08:00 to 18:00), weekly matrix, and monthly matrix with overflow cells from adjacent months.
FullCalendarHeader — header bar with a CardTab switcher (Dia / Semana / Mês) and IconButton chevron navigation, displaying the current date in pt-BR long format.
DayCalendar — day view composed of DayCalendarContainer, DayCalendarRow, and DayCalendarEvent.
WeekCalendar — week view composed of WeekCalendarTableContainer, WeekCalendarTableHeader, WeekCalendarTableBody, WeekCalendarTableTd, and WeekCalendarEvent.
MonthlyCalendar — month view composed of MonthlyCalendarTableContainer, MonthlyCalendarTableHeader, MonthlyCalendarTableBody, MonthlyCalendarTableTd, and MonthlyCalendarEvent.
FullCalendar accepts the following props:
defaultView — initial view ("day" | "week" | "month"). Default: "month".
defaultValue — initial selected date. Defaults to today.
events — array of FullCalendarEvent objects (title, date, endDate?, data?, scheme?, onClick?).
onChange — callback fired when the selected date changes.
onChangeView — callback fired when the user navigates to a different period.
- Event chips support five color schemes:
primary, success, warning, danger, and info.
- Exported
FullCalendar from the package root (packages/components/src/index.ts).
- Full JSDoc coverage added to the public component API.
Notes
- This is a purely additive release; no existing component APIs or styles were modified.
FullCalendarProvider exposes an internal language prop (defaults to "pt-BR") for future localization support, but it is not yet part of the public FullCalendar API.
- The day view hour range is currently fixed at 08:00–18:00 in 30-minute increments.
- Version bumped across all packages (
@arkyn/components, @arkyn/server, @arkyn/shared, @arkyn/templates).s
v3.0.1-beta.145
Date: 2026-06-13
Status: Default orientation correction for PhoneInput.
Changes By Package
@arkyn/components
- Corrected the default value of the
orientation prop on PhoneInput from "horizontal" to "vertical", aligning runtime behavior with the field template layout convention used by all other form components.
- Updated JSDoc and inline type documentation to reflect the corrected default.
Notes
- This is a behavioral correction: any
PhoneInput rendered without an explicit orientation prop will now default to the vertical layout instead of horizontal.
- No other component APIs or styles were changed.
- Version bumped across all packages (
@arkyn/components, @arkyn/server, @arkyn/shared, @arkyn/templates).
v3.0.1-beta.144
Date: 2026-06-13
Status: Full JSDoc coverage across all packages and design token refinements in @arkyn/components.
Changes By Package
-
@arkyn/components
- Added full JSDoc documentation to all components: Alert, AudioPlayer, AudioUpload, Badge, Button, CardTab, Checkbox, ClientOnly, CurrencyInput, Divider, Drawer, FacebookPixel, FieldError, FieldLabel, FieldWrapper, FileUpload, GoogleAnalytics, GoogleTagManager, IconButton, ImageUpload, Input, MapView, MaskedInput, Modal, MultiSelect, Pagination, PhoneInput, Popover, Radio, RichText, SearchPlaces, Select, Slider, Switch, Tab, Table, Textarea, and Tooltip.
- Added full JSDoc documentation to all hooks:
useAutomation, useDrawer, useForm, useHydrated, useModal, useScopedParams, useScrollLock, useSearchAutomation, useSlider, and useToast.
- Added full JSDoc documentation to all providers:
DrawerProvider, FormProvider, ModalProvider, PlacesProvider, and ToastProvider.
- Added full JSDoc documentation to all services:
toHtml and toRichTextValue.
- Refined design tokens in
variables.css:
- Added
--white as a first-class token.
- Updated background tokens to the zinc scale (
--background, --card-foreground-primary).
- Updated text tokens to the zinc scale (
--text-heading, --text-body, --text-muted).
- Added
--spotlight-*-light variants for all six color roles (primary, secondary, success, danger, info, warning).
-
@arkyn/server
- Added full JSDoc documentation to all bad responses, success responses, services (
ApiService, DebugService, LogService), utilities, and validations.
-
@arkyn/shared
- Added full JSDoc documentation to all formats, generators, parsers, services, and utilities.
Notes
- This release contains no behavioral or API changes. All modifications are documentation and design token updates.
- JSDoc coverage was applied uniformly across all three packages, aligning inline documentation style with the patterns established in prior releases.
- The zinc-scale token update in
variables.css is a visual-only refinement; no component class names or CSS custom property names were changed.
- Version bumped across all packages (
@arkyn/components, @arkyn/server, @arkyn/shared, @arkyn/templates).
v3.0.1-beta.143
Date: 2026-06-11
Status: Visual style corrections for Button, IconButton, and CardTab components.
Changes By Package
@arkyn/components
- Fixed outline variant background color for Button and IconButton, replacing --card-foreground-primary with --card for correct surface contrast.
- Redesigned CardTab visual style:
- CardTabContainer now uses a filled background (--card-foreground-primary) with internal padding and gap instead of a bordered frame, giving the tab strip a pill-container appearance.
- CardTabButton default state updated to transparent background with a fixed height of 40px, rounded corners (6px), and heading-level text color (--text-heading).
- Removed the border-right separator rule between tab buttons.
- Hover and active states now apply a white background (--white) with a visible border (--border) instead of the previous primary-colored highlight.
Notes
- All changes in this release are purely visual and do not affect component APIs or behavior.
- The CardTab redesign aligns its appearance with the rest of the component library's surface and border token conventions.
- Version bumped across all packages (@arkyn/components, @arkyn/server, @arkyn/shared, @arkyn/templates).
v3.0.1-beta.142
Date: 2026-06-10
Status: Correction for the successful deployment of v3.0.1-beta.141, with a minor update to the changelog entry for clarity.
Notes
- This release is a non-code update to ensure the changelog accurately reflects the changes made in v3.0.1-beta.141.
v3.0.1-beta.141
Date: 2026-06-10
Status: Form field template standardization, component API expansion, and automation behavior update.
Changes By Package
@arkyn/components
- Added a new shared FieldTemplate service to centralize FieldWrapper, FieldLabel, and FieldError rendering.
- Refactored these components to use FieldTemplate:
- Checkbox
- CurrencyInput
- ImageUpload
- Input
- MultiSelect
- PhoneInput
- RadioGroup
- RichText
- Select
- Switch
- Expanded component APIs with support for unShowFieldTemplate and orientation across the refactored form components.
- Added or propagated showAsterisk, className, and errorMessage handling where needed to keep field template behavior consistent.
- Updated RichText types to include className, unShowFieldTemplate, and orientation.
- Added full JSDoc coverage for PhoneInput and updated JSDoc in the refactored components to describe the new field-template-related props.
- Updated useAutomation behavior:
- Added scroll support via cause.data.scrollTo using react-scroll.
- Added first field error extraction from cause.fieldErrors for danger toast priority.
- Reworked toast decision logic to use successResponses and badResponses.
- Ignored the Unprocessable entity message in toast output.
- Kept modal auto-close flow and centralized toast execution in a dedicated internal function.
Notes
- This release consolidates form field rendering patterns and reduces duplicated wrapper/label/error logic across components.
- The update also improves response automation UX by aligning scroll and toast behavior with structured backend error payloads.
- Scope reflects only what is currently staged in
@arkyn/components.
v3.0.1-beta.140
Date: 2026-06-09
Status: Incremental documentation update.
Changes By Package
@arkyn/components
- Added documentation for the new
Calendar component.
Notes
- This release includes only the
Calendar component addition.
v3.0.1-beta.139
Date: 2026-06-02
Status: First official stable version of the documented ecosystem.
Changes By Package
-
@arkyn/components
- Consolidated documentation for UI components, overlays, forms, feedback, media, and navigation.
- Official hooks documented for automation, forms, hydration, overlays, search, slider, toast, and scroll lock.
- Official providers documented for drawer, modal, form, and toast.
- Rich text services documented (
toHtml and toRichTextValue).
-
@arkyn/server
- Official documented structure for bad responses, success responses, services, utilities, and validations.
- HTTP response standards, error handling, and validation flow support formalized in the baseline.
-
@arkyn/shared
- Official documented scope for formats, generators, parsers, services, and utilities.
- Shared utility library consolidated as part of the stable foundation.
-
@arkyn/templates
- Official templates documented for countries, country-currencies, and brazilian-states.
- Standardized utility data foundation for use across other packages.
Notes
- This release defines contract stability for what is currently documented.
- Future evolutions will be published in new changelog entries, preserving compatibility whenever possible.