v1.0.0

Initial stable release of @artisanpack-ui/hooks-js. Public API is now stable and follows semantic versioning going forward.

Added

• Documentation surface: full README.md with install, quickstart, API reference,
  React adapter section, Module Federation section, deprecation section, and
  examples for both plain JS and React. Hook naming convention documented
  verbatim from the artisanpack-ui/hooks PHP README. Migration guide from
  @wordpress/hooks covering namespace removal, priority range, alias handling,
  React reactivity, and globals. Cross-link section pointing to the PHP twin.
• Long-form /docs tree with YAML frontmatter and GitLab-wiki-style
  cross-links: home.md, getting-started.md, actions.md, filters.md,
  priorities-and-execution-order.md, hook-naming-and-deprecations.md,
  react.md (+ react/ subtree covering useFilter, useAction,
  useHookedChildren, <HookSlot>, and SSR), module-federation.md,
  devtools-debug.md, migration-from-wordpress-hooks.md, testing.md,
  faq.md, security.md, contributing.md, changelog.md.
• CONTRIBUTING.md — dev setup, script matrix, code style, testing
  conventions, docs conventions, PR conventions, release process.
• Automated release workflow (.github/workflows/release.yml) — triggered
  on v*.*.* tags, lints/type-checks/tests/builds, verifies that the tag
  version matches package.json, then runs npm publish --provenance --access public and creates a GitHub Release whose body is extracted from the
  matching CHANGELOG.md section. Requires an NPM_TOKEN repo secret with
  publish rights on the @artisanpack-ui scope; provenance uses OIDC via
  id-token: write.
• Cross-module state singleton keyed by Symbol.for('@artisanpack-ui/hooks-js/singleton')
  on globalThis. Duplicate copies of the package (Module Federation without
  shared: { singleton: true }) share one registry so callbacks registered
  under one copy fire when dispatched from another.
• globalThis.ApHooks public-API escape hatch installed on first import of the
  entry module. Plugins loaded outside the bundler graph can call
  window.ApHooks.addAction(...) / .applyFilters(...) without importing the
  package; calls share state with the imported API.
• DevTools debug flag window.__AP_HOOKS_DEBUG__ = true — logs each doAction
  / applyFilters dispatch to console.debug with the hook name, a compact
  argument preview, and the current subscriber count. Read per-dispatch so it
  can be toggled from DevTools without reloading.
• README section documenting shared: { singleton: true, strictVersion: false }
  for @originjs/vite-plugin-federation, webpack ModuleFederationPlugin, and
  Rspack, plus a plugin bootModule recipe for pre-mount hook registration.
• Vitest v8 coverage config with per-file thresholds (95%+ core, 90%+ React
  adapter) wired into CI via npm run test:coverage.
• Expanded test suite: removeAll{Actions,Filters} with a specific priority
  edge cases, add-during-dispatch deferral semantics, applyFilters returning
  seed value when no subscribers, cross-alias dedup for identical bound
  methods, React adapter sibling-unmount isolation, StrictMode
  no-double-registration.
• Initial repository scaffold: TypeScript, tsup, Vitest (jsdom), ESLint, Prettier,
  GitHub Actions CI matrix (Node 20 / 22), and dual entry points (. + ./react).
• deprecateHook(oldName, newName) with chain collapse, cycle detection, and
  cross-bucket dedup on dispatch. addAction/addFilter on an alias silently
  attach to the canonical bucket; doAction/applyFilters fire callbacks
  registered under either name exactly once. Deprecation notices log once per
  alias per session at the level configured via
  window.__AP_HOOKS_DEPRECATION_LEVEL__ (off / debug / info / warn /
  error, defaults to info). Helpers: hasAliases(), aliasesFor(canonical),
  resetDeprecationLogState().
• React adapter (@artisanpack-ui/hooks-js/react): useFilter, useAction,
  useHookedChildren, and <HookSlot>. Backed by useSyncExternalStore on a
  per-hook version counter that bumps on every registry mutation, including
  changes on any reverse-alias bucket. useAction deep-compares args to avoid
  re-firing on freshly-allocated but semantically-equal tuples. SSR-safe:
  server render never subscribes, and callbacks registered in useEffect
  attach on hydrate.