Merge pull request #3 from devendramilmile121/release/0.3.0

release: 0.2.1 — DX gates, a11y harness, ng-add, discoverability

Author: devendramilmile121

.github/workflows/ci.yml

@@ -22,6 +22,9 @@ jobs:
       - run: npm run typecheck
       - run: npm test
       - run: npm run build
+      # Publish-quality gate: publint + arethetypeswrong + bundle-size budget.
+      - name: Package gate (publint, attw, size budget)
+        run: npm run check:package
       - name: Pack tarball
         run: mkdir -p "$GITHUB_WORKSPACE/artifacts" && cd dist/datelane && npm pack --pack-destination "$GITHUB_WORKSPACE/artifacts"
       - uses: actions/upload-artifact@v4

CHANGELOG.md

@@ -4,6 +4,31 @@ All notable changes to `@datelane/core` are documented here.
 The format follows [Keep a Changelog](https://keepachangelog.com/) and this project adheres to
 [Semantic Versioning](https://semver.org/).
 
+## [0.2.1] - 2026-08-15
+
+Developer-experience and release-quality groundwork (Milestone A) plus discoverability polish.
+No public API changes.
+
+### Added
+
+- **Package quality gate** (`npm run check:package`): `publint` + `arethetypeswrong` type-resolution
+  check + a gzip **bundle-size budget** (`scripts/check-size.mjs`), wired into CI after the build.
+- **Accessibility test harness**: `axe-core` assertions via `src/lib/testing/axe.ts`, with a11y
+  specs for the shell (every view + both popovers) and the month view. Runs under `npm test`.
+- **`ng add @datelane/core` schematic**: registers the scheduler stylesheet in the target project's
+  build `styles` and prints setup guidance.
+- **README + npm discoverability**: badges (version, downloads, gzip size, CI, license), a
+  "Why datelane?" comparison, a hero screenshot, live-demo / StackBlitz links, and an expanded
+  keyword set.
+
+### Fixed
+
+- **ARIA grid structure** across every view: added missing `role="row"`/`rowgroup` wrappers and
+  flattened structural containers so `columnheader`/`gridcell` elements have valid parents
+  (vertical-time, month, timeline, year, month-agenda). Timeline column headers are no longer
+  `<button role="columnheader">` (invalid) and gained keyboard activation; month-agenda day cells
+  use `aria-selected` instead of `aria-pressed`.
+
 ## [0.2.0] - 2026-06-21
 
 Adds recurrence expansion plus navigation and scrolling features. Backward compatible — no breaking

README.md

@@ -1,14 +1,45 @@
 # @datelane/core
 
-A lightweight, fully customizable **Angular scheduler / calendar** — all 12 view modes
-(Day, Week, Work Week, Month, Year, Agenda, Month Agenda, and the five Timeline views) — with
-**zero hard runtime dependencies** and a **pluggable date layer** (Native, Luxon, or Moment).
+[![npm version](https://img.shields.io/npm/v/@datelane/core.svg)](https://www.npmjs.com/package/@datelane/core)
+[![npm downloads](https://img.shields.io/npm/dw/@datelane/core.svg)](https://www.npmjs.com/package/@datelane/core)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/@datelane/core.svg?label=gzip)](https://bundlephobia.com/package/@datelane/core)
+[![zero deps](https://img.shields.io/badge/runtime%20deps-0-brightgreen.svg)](https://www.npmjs.com/package/@datelane/core?activeTab=dependencies)
+[![Angular](https://img.shields.io/badge/Angular-18%20%E2%80%93%2022-dd0031.svg)](#angular-support)
+[![CI](https://github.com/devendramilmile121/datelane/actions/workflows/ci.yml/badge.svg)](https://github.com/devendramilmile121/datelane/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/@datelane/core.svg)](LICENSE)
+
+**The free, zero-dependency Angular scheduler.** All 12 view modes — Day, Week, Work Week, Month,
+Year, Agenda, Month Agenda, and 5 Timeline views — with drag & resize, recurrence, resources,
+dark mode, and RTL. **~38 KB gzipped, no runtime dependencies, MIT-licensed**, and a pluggable date
+layer (Native / Luxon / Moment).
+
+**[▶ Live demo](https://devendramilmile121.github.io/datelane/)** · [Quick start](#quick-start-standalone-native-dates) · [Views](#views) · [Why datelane?](#why-datelane)
+
+<p align="center">
+  <a href="https://devendramilmile121.github.io/datelane/">
+    <img src="docs/hero.png" alt="datelane Angular scheduler — week view with colored events, all-day band, and now-line" width="900">
+  </a>
+</p>
 
 > Status: `0.2.0` pre-release. The 12 views, drag/resize, a host-driven quick-view, resources,
 > auto-scroll, **recurrence (RRULE expansion + EXDATE)**, a **date-jump calendar popover**,
 > **header/cell drill-down navigation**, and **virtual scrolling** are implemented. A full editor
 > window and full keyboard grid navigation are on the roadmap (see [Limitations](#limitations)).
 
+## Why datelane?
+
+| | datelane | FullCalendar | Syncfusion | DHTMLX |
+|---|:---:|:---:|:---:|:---:|
+| License | **MIT (free)** | MIT + paid | Commercial | Commercial |
+| Runtime deps | **0** | preact | many | many |
+| Bundle (gzip) | **~38 KB** | ~90 KB+ | large | large |
+| Angular standalone + signals | **✅ native** | wrapper | ✅ | wrapper |
+| Date library | **pluggable** | built-in | built-in | built-in |
+| Timeline + resources | **✅** | paid | ✅ | ✅ |
+| Bring-your-own editor | **✅** | partial | built-in | built-in |
+
+Built for modern Angular (18+, standalone, signal-first). You pay only for the views you import.
+
 ## Highlights
 
 - **Lightweight** — core has no runtime deps; each view is a tree-shakeable factory; you ship only
@@ -35,6 +66,15 @@ npm i luxon      # or: npm i moment
 Peer deps: `@angular/core` and `@angular/common` `>=18.0.0 <23.0.0`. `luxon`/`moment` are
 **optional** peers.
 
+Or scaffold it in one step:
+
+```bash
+ng add @datelane/core   # registers the stylesheet and prints setup steps
+```
+
+**Try it live:** [interactive demo](https://devendramilmile121.github.io/datelane/) ·
+[edit on StackBlitz](https://stackblitz.com/github/devendramilmile121/datelane).
+
 ## Quick start (standalone, Native dates)
 
 Register the scheduler providers once at bootstrap:

docs/hero.png

@@ -4,13 +4,16 @@
   "private": true,
   "scripts": {
     "start": "ng serve demo",
-    "build": "ng build datelane --configuration production",
+    "build": "ng build datelane --configuration production && npm run build:schematics",
+    "build:schematics": "tsc -p projects/datelane/schematics/tsconfig.json && cp projects/datelane/schematics/collection.json dist/datelane/schematics/collection.json && cp projects/datelane/schematics/ng-add/schema.json dist/datelane/schematics/ng-add/schema.json",
     "build:watch": "ng build datelane --watch --configuration development",
     "test": "ng test datelane --watch=false",
     "test:watch": "ng test datelane --watch",
     "lint": "ng lint",
     "format": "prettier --write \"projects/**/*.{ts,html,scss,json}\"",
     "typecheck": "tsc -p projects/datelane/tsconfig.lib.json --noEmit",
+    "check:size": "node scripts/check-size.mjs",
+    "check:package": "bash scripts/check-package.sh",
     "pack:lib": "npm run build && cd dist/datelane && npm pack"
   },
   "devDependencies": {
@@ -26,6 +29,7 @@
     "@types/luxon": "^3.4.0",
     "@vitest/coverage-v8": "^3.2.6",
     "angular-eslint": "^20.0.0",
+    "axe-core": "^4.9.1",
     "eslint": "^9.0.0",
     "jasmine-core": "~5.7.0",
     "jest-axe": "^9.0.0",
@@ -38,6 +42,7 @@
     "luxon": "^3.4.0",
     "moment": "^2.30.0",
     "ng-packagr": "^20.0.0",
+    "playwright": "^1.62.1",
     "prettier": "^3.2.0",
     "rxjs": "~7.8.0",
     "tslib": "^2.6.0",

package-lock.json

@@ -1,14 +1,22 @@
 {
   "name": "@datelane/core",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Lightweight, customizable, dependency-free Angular scheduler/calendar with pluggable date adapters (Native/Luxon/Moment).",
   "license": "MIT",
-  "keywords": ["angular", "scheduler", "calendar", "timeline", "agenda", "events", "luxon", "moment"],
+  "keywords": [
+    "angular", "scheduler", "calendar", "timeline", "agenda", "events", "appointments",
+    "resource-scheduling", "gantt", "day-view", "week-view", "month-view", "year-view",
+    "recurrence", "rrule", "drag-and-drop", "standalone", "signals", "angular-scheduler",
+    "angular-calendar", "fullcalendar-alternative", "syncfusion-alternative", "lightweight",
+    "zero-dependency", "date-adapter", "luxon", "moment", "rtl", "dark-mode"
+  ],
   "repository": { "type": "git", "url": "git+https://github.com/devendramilmile121/datelane.git" },
   "homepage": "https://github.com/devendramilmile121/datelane#readme",
   "bugs": { "url": "https://github.com/devendramilmile121/datelane/issues" },
   "sideEffects": false,
   "publishConfig": { "access": "public" },
+  "schematics": "./schematics/collection.json",
+  "ng-add": { "save": "dependencies" },
   "exports": {
     "./styles/*": "./styles/*",
     "./styles/scheduler": "./styles/scheduler.scss"

package.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "../../../node_modules/@angular-devkit/schematics/collection-schema.json",
+  "schematics": {
+    "ng-add": {
+      "description": "Register @datelane/core stylesheet and print setup guidance.",
+      "factory": "./ng-add/index#ngAdd",
+      "schema": "./ng-add/schema.json"
+    }
+  }
+}

projects/datelane/package.json

@@ -0,0 +1,82 @@
+// schematics/ng-add/index.ts — `ng add @datelane/core`.
+// Registers the scheduler stylesheet in the target project's build `styles` and prints the
+// minimal wiring a consumer still has to do (provider + view factories). Keeps the surface small:
+// it never edits app code, so it can't clobber a hand-written bootstrap.
+
+import { JsonArray } from '@angular-devkit/core';
+import { Rule, SchematicContext, SchematicsException, Tree } from '@angular-devkit/schematics';
+import { getWorkspace, updateWorkspace } from '@schematics/angular/utility/workspace';
+import { Schema } from './schema';
+
+/** Source SCSS shipped by the package (compiled by Angular's own build pipeline). */
+const STYLE_ENTRY = 'node_modules/@datelane/core/styles/scheduler.scss';
+
+export function ngAdd(options: Schema): Rule {
+  return async (tree: Tree, context: SchematicContext) => {
+    const workspace = await getWorkspace(tree);
+
+    const projectName =
+      options.project ||
+      (workspace.extensions['defaultProject'] as string | undefined) ||
+      firstApplication(workspace);
+
+    if (!projectName || !workspace.projects.has(projectName)) {
+      throw new SchematicsException(
+        `Could not find a project to add @datelane/core to. Pass --project=<name>.`,
+      );
+    }
+
+    return updateWorkspace((ws) => {
+      const project = ws.projects.get(projectName)!;
+      const build = project.targets.get('build');
+      if (!build) {
+        context.logger.warn(
+          `Project "${projectName}" has no build target; skipped stylesheet registration. ` +
+            `Import "${STYLE_ENTRY}" manually.`,
+        );
+      } else {
+        build.options ??= {};
+        const styles = (build.options['styles'] as JsonArray | undefined) ?? [];
+        const already = styles.some((s) => s === STYLE_ENTRY);
+        if (already) {
+          context.logger.info(`@datelane/core stylesheet already registered — nothing to do.`);
+        } else {
+          build.options['styles'] = [STYLE_ENTRY, ...styles];
+          context.logger.info(`✓ Added ${STYLE_ENTRY} to "${projectName}" build styles.`);
+        }
+      }
+
+      printNextSteps(context);
+    });
+  };
+}
+
+/** First application-type project in the workspace, used when no default is set. */
+function firstApplication(
+  workspace: Awaited<ReturnType<typeof getWorkspace>>,
+): string | undefined {
+  for (const [name, project] of workspace.projects) {
+    if (project.extensions['projectType'] === 'application') return name;
+  }
+  return undefined;
+}
+
+function printNextSteps(context: SchematicContext): void {
+  context.logger.info(
+    [
+      '',
+      'Next steps to render a scheduler:',
+      '',
+      "  1. Provide a date adapter in your app config:",
+      "       import { provideScheduler, provideNativeDateAdapter } from '@datelane/core';",
+      '       providers: [provideScheduler(), provideNativeDateAdapter()]',
+      '',
+      "  2. Use the component + view factories in a template:",
+      "       import { SchedulerComponent, weekView, monthView } from '@datelane/core';",
+      "       <dl-scheduler [views]=\"[weekView(), monthView()]\" [events]=\"events\" [fieldMap]=\"fieldMap\" />",
+      '',
+      '  Docs: https://github.com/devendramilmile121/datelane#readme',
+      '',
+    ].join('\n'),
+  );
+}

projects/datelane/schematics/collection.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "DatelaneCoreNgAdd",
+  "title": "@datelane/core ng-add options",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "Name of the project to add the scheduler stylesheet to.",
+      "$default": { "$source": "projectName" }
+    }
+  },
+  "additionalProperties": false
+}