improvements

[gfazioli]

• refactor(Clock): 🛠️ improve Clock for SSR, accessibility, and performance
• refactor: clean up clock hooks and stories for consistency 🧹
• feat(clock): 🕒 add Clock.Digital and new clock features
• 🚀 feat: add absolute tick positioning and perimeter-based numbers for rectangle geometry
• 🛠️ Fix hand positioning using correct center coordinates
• feat(ClockDigital): add ClockDigital component with docs and demos
• docs(demo): center Clock demo group alignment 📄
• ✨ Add ClockDigital styles API demo
• refactor: 📚 Add componentPrefix to DocsTabs for Clock components

[Copilot]

Pull request overview

This PR significantly expands and refactors the clock package: adding a new ClockDigital component, introducing geometry-driven rendering (including rounded-rect “watch” faces), improving SSR safety/performance, and modernizing hooks/docs/testing setup.

Changes:

• Add ClockDigital (compound Clock.Digital + standalone export) with Styles API, tests, and docs/demos.
• Introduce geometry module to support circular + rounded-rectangle layouts, absolute tick positioning, and sector paths.
• Refactor useClock / useClockCountDown return shapes (numeric + formatted fields), drift-free countdown logic, and update test infrastructure (custom Jest transformer).

Reviewed changes

Copilot reviewed 46 out of 49 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
scripts/docgen.ts	Include ClockDigital in doc generation inputs
package/src/index.ts	Export new component/types and geometry API
package/src/hooks/use-clock.ts	Return numeric time + formatted strings; update frequency clamp; remove start
package/src/hooks/use-clock.test.tsx	Replace placeholder tests with real hook tests
package/src/hooks/use-clock.story.tsx	Update stories to new hook API (formatted*, resume)
package/src/hooks/use-clock-count-down.ts	Drift-free countdown, formatted outputs, API surface changes
package/src/hooks/use-clock-count-down.test.tsx	Replace placeholder tests with real countdown tests
package/src/hooks/use-clock-count-down.story.tsx	Update stories to new countdown API (days, resume)
package/src/geometry.ts	New geometry abstraction + rounded-rect perimeter logic
package/src/geometry.test.ts	Add unit tests for geometry utilities/classes
package/src/ClockDigital.tsx	New digital clock component using Mantine factory + useClock
package/src/ClockDigital.test.tsx	Tests for rendering/accessibility/ref forwarding/compound usage
package/src/ClockDigital.module.css	Styling for digital clock segments/date/am-pm
package/src/Clock.tsx	Major refactor: geometry-driven layout, Clock.Digital, sectors, faceContent, auto size, mount animation, onTimeChange
package/src/Clock.test.tsx	Expand tests for new features and behaviors
package/src/Clock.module.css	CSS adjustments + new faceContent selector
package/package.json	Update package keywords
package.json	Bump tool/library versions (yarn/dayjs/mantine/storybook/etc.)
jest.config.cjs	Switch to local custom transformer
esbuild-jest-transformer.cjs	Add custom esbuild transformer to avoid babel fallback
docs/styles-api/index.ts	Register ClockDigital styles API
docs/styles-api/ClockDigital.styles-api.ts	Add Styles API data for ClockDigital
docs/styles-api/Clock.styles-api.ts	Document new faceContent selector
docs/pages/index.tsx	Update DocsTabs to include ClockDigital + component prefix
docs/package.json	Rename docs package + bump Mantine/Next deps
docs/docs.mdx	Update hook docs + add Clock.Digital / shapes / sectors / etc. sections
docs/demos/useClockCountDown.demo.targetDates.tsx	Update demo to new countdown API and formatted fields
docs/demos/useClockCountDown.demo.interactive.tsx	Update demo to new countdown API (resume, formatted fields)
docs/demos/useClock.demo.worldClocks.tsx	Use formatted fields in display
docs/demos/useClock.demo.specificTime.tsx	Replace start with resume
docs/demos/useClock.demo.basic.tsx	Use formatted fields + resume in controls
docs/demos/index.ts	Export new demo modules
docs/demos/ClockDigital.demo.stylesApi.tsx	Add styles-api demo for ClockDigital
docs/demos/ClockDigital.demo.configurator.tsx	Add configurator demo for ClockDigital
docs/demos/ClockCountDown.demo.basic.tsx	Update imports + formatted fields + API changes
docs/demos/Clock.demo.shapes.tsx	Add shapes demo (rounded-rect/aspectRatio)
docs/demos/Clock.demo.sectors.tsx	Add sectors demo
docs/demos/Clock.demo.reverseCountdown.tsx	Update reverse countdown to formatted fields + resume
docs/demos/Clock.demo.responsiveSize.tsx	Add auto-size demo
docs/demos/Clock.demo.mountAnimation.tsx	Add animate-on-mount demo
docs/demos/Clock.demo.faceContent.tsx	Add faceContent demo
docs/demos/Clock.demo.digital.tsx	Add Clock.Digital usage demo
docs/demos/Clock.demo.customHands.tsx	Add custom hand rendering demo
docs/demos/Clock.demo.configurator.tsx	Extend configurator controls for shape props
CLAUDE.md	Add repo guidance/commands/architecture notes
.yarnrc.yml	Update yarn release path

Comments suppressed due to low confidence (1)

package/src/hooks/use-clock.ts:71

• useClock removes the start control method from the returned ClockData. If this hook is part of the public API, this is a breaking change for consumers. Consider keeping start as an alias of resume (possibly deprecated) or clearly documenting the breaking change and coordinating it with a version bump.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 46 out of 49 changed files in this pull request and generated 6 comments.

Comments suppressed due to low confidence (1)

package/src/hooks/use-clock.ts:71

• useClock no longer returns a start() method (only resume()), which is a breaking API change for hook consumers. Consider keeping start as an alias of resume (as done in useClockCountDown) or documenting the breaking change + versioning it appropriately.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.