@ojiepermana/angular 22.0.1 → 22.0.29

package/generator/guide/bin/src/engine/walk.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.collectMarkdown = collectMarkdown;
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-function collectMarkdown(sourceDir) {
-    const out = [];
-    walk(sourceDir, sourceDir, out);
-    return out.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
-}
-function walk(root, dir, out) {
-    const entries = (0, node_fs_1.readdirSync)(dir, { withFileTypes: true });
-    for (const entry of entries) {
-        const abs = (0, node_path_1.join)(dir, entry.name);
-        if (entry.isDirectory()) {
-            walk(root, abs, out);
-            continue;
-        }
-        if (!entry.isFile() || !entry.name.toLowerCase().endsWith('.md'))
-            continue;
-        const st = (0, node_fs_1.statSync)(abs);
-        if (!st.isFile())
-            continue;
-        const rel = (0, node_path_1.relative)(root, abs)
-            .split(/[\\/]+/)
-            .join('/');
-        const segments = rel.replace(/\.md$/i, '').split('/');
-        out.push({
-            absolutePath: abs,
-            relativePath: rel,
-            segments,
-            content: (0, node_fs_1.readFileSync)(abs, 'utf8'),
-        });
-    }
-}

package/generator/guide/guide.config.example.json

@@ -1,9 +0,0 @@
-{
-  "$schema": "./node_modules/@ojiepermana/angular/generator/guide/schematics/build/schema.json",
-  "sourceDir": "./docs",
-  "outputDir": "./projects/demo/library/src/app/docs",
-  "routeFile": "doc.routes.ts",
-  "componentPrefix": "Doc",
-  "componentStyle": "none",
-  "routeExportName": "DOC_ROUTES"
-}

package/generator/guide/schematics/build/schema.json

@@ -1,14 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema",
-  "$id": "GuideBuildSchema",
-  "title": "Guide · build",
-  "type": "object",
-  "additionalProperties": false,
-  "properties": {
-    "config": {
-      "type": "string",
-      "description": "Path to the guide config file, relative to the workspace root.",
-      "default": "config/guide.config.json"
-    }
-  }
-}

package/generator/guide/schematics/init/schema.json

@@ -1,19 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema",
-  "$id": "GuideInitSchema",
-  "title": "Guide · init",
-  "type": "object",
-  "additionalProperties": false,
-  "properties": {
-    "path": {
-      "type": "string",
-      "description": "Destination path for the generated guide.config.json, relative to the workspace root.",
-      "default": "config/guide.config.json"
-    },
-    "force": {
-      "type": "boolean",
-      "description": "Overwrite an existing guide.config.json.",
-      "default": false
-    }
-  }
-}

package/layout/component/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../fesm2022/ojiepermana-angular-layout-component.mjs",
-  "typings": "../../types/ojiepermana-angular-layout-component.d.ts"
-}

package/layout/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../fesm2022/ojiepermana-angular-layout.mjs",
-  "typings": "../types/ojiepermana-angular-layout.d.ts"
-}

package/layout/provider/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../fesm2022/ojiepermana-angular-layout-provider.mjs",
-  "typings": "../../types/ojiepermana-angular-layout-provider.d.ts"
-}

package/layout/services/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../fesm2022/ojiepermana-angular-layout-services.mjs",
-  "typings": "../../types/ojiepermana-angular-layout-services.d.ts"
-}

package/layout/shell/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../fesm2022/ojiepermana-angular-layout-shell.mjs",
-  "typings": "../../types/ojiepermana-angular-layout-shell.d.ts"
-}

package/layout/token/directive/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../../fesm2022/ojiepermana-angular-layout-token-directive.mjs",
-  "typings": "../../../types/ojiepermana-angular-layout-token-directive.d.ts"
-}

package/layout/token/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../fesm2022/ojiepermana-angular-layout-token.mjs",
-  "typings": "../../types/ojiepermana-angular-layout-token.d.ts"
-}

package/layout/type/empty/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../../fesm2022/ojiepermana-angular-layout-type-empty.mjs",
-  "typings": "../../../types/ojiepermana-angular-layout-type-empty.d.ts"
-}

package/layout/type/horizontal/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../../fesm2022/ojiepermana-angular-layout-type-horizontal.mjs",
-  "typings": "../../../types/ojiepermana-angular-layout-type-horizontal.d.ts"
-}

package/layout/type/vertical/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../../fesm2022/ojiepermana-angular-layout-type-vertical.mjs",
-  "typings": "../../../types/ojiepermana-angular-layout-type-vertical.d.ts"
-}

package/navigation/demo-data/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../fesm2022/ojiepermana-angular-navigation-demo-data.mjs",
-  "typings": "../../types/ojiepermana-angular-navigation-demo-data.d.ts"
-}

package/navigation/icon/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../fesm2022/ojiepermana-angular-navigation-icon.mjs",
-  "typings": "../../types/ojiepermana-angular-navigation-icon.d.ts"
-}

package/navigation/item/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../fesm2022/ojiepermana-angular-navigation-item.mjs",
-  "typings": "../../types/ojiepermana-angular-navigation-item.d.ts"
-}

package/navigation/service/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../fesm2022/ojiepermana-angular-navigation-service.mjs",
-  "typings": "../../types/ojiepermana-angular-navigation-service.d.ts"
-}

package/navigation/sidebar/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../fesm2022/ojiepermana-angular-navigation-sidebar.mjs",
-  "typings": "../../types/ojiepermana-angular-navigation-sidebar.d.ts"
-}

package/navigation/topbar/README.md

@@ -1,196 +0,0 @@
-# Topbar
-
-Horizontal navigation root for application shells, documentation headers, and flyout-style site navigation.
-
-## Import
-
-```ts
-import { TopbarComponent } from '@ojiepermana/angular/navigation/topbar';
-import type { NavigationItem, TopbarVariant } from '@ojiepermana/angular/navigation/types';
-```
-
-## Composition
-
-The topbar renders a menubar-style root and projects optional leading and trailing slots around the navigation items.
-
-```text
-topbar
-├── [items]="NavigationItem[]"
-│   ├── type: 'basic' -> direct link item
-│   ├── type: 'group' -> dropdown trigger + overlay panel
-│   └── type: 'collapsable' -> dropdown trigger + overlay panel
-├── `variant="flyout"` -> descriptive title + subtitle cards in dropdown panels
-├── [topbar-start] projected brand or leading actions
-└── [topbar-end] projected trailing actions
-```
-
-## Basic usage
-
-Pass `NavigationItem[]` directly when the page owns its own navigation tree.
-
-```ts
-const navigationItems: NavigationItem[] = [
-  {
-    id: 'getting-started',
-    type: 'group',
-    title: 'Getting started',
-    children: [
-      {
-        id: 'introduction',
-        type: 'basic',
-        title: 'Introduction',
-        subtitle: 'Overview and design-system fundamentals.',
-        link: '/docs/introduction',
-      },
-      {
-        id: 'installation',
-        type: 'basic',
-        title: 'Installation',
-        subtitle: 'Package install and workspace setup steps.',
-        link: '/docs/getting-started/installation',
-      },
-    ],
-  },
-  { id: 'docs', type: 'basic', title: 'Docs', link: '/docs/introduction' },
-];
-```
-
-```html
-<topbar variant="flyout" [items]="navigationItems" [showHamburger]="false" ariaLabel="Primary site navigation">
-  <a topbar-start href="/" class="inline-flex items-center rounded-md px-2 py-2 text-sm font-semibold text-foreground">
-    Acme UI
-  </a>
-
-  <a
-    topbar-end
-    href="/docs/introduction"
-    class="inline-flex h-9 items-center rounded-md bg-primary px-4 text-sm font-medium text-primary-foreground">
-    Get started
-  </a>
-</topbar>
-```
-
-## Common patterns
-
-### Grouped dropdowns
-
-Use `group` or `collapsable` items when the trigger should open a panel of related destinations.
-
-Set `variant="flyout"` when those dropdown panels should render descriptive title and subtitle cards in a wider flyout layout.
-
-```ts
-const productItems: NavigationItem[] = [
-  {
-    id: 'resources',
-    type: 'group',
-    title: 'Resources',
-    children: [
-      {
-        id: 'guides',
-        type: 'basic',
-        title: 'Guides',
-        subtitle: 'Browse getting started material and implementation notes.',
-        link: '/docs/introduction',
-      },
-      {
-        id: 'api',
-        type: 'basic',
-        title: 'API reference',
-        subtitle: 'Inspect Angular-first component and directive imports by entrypoint.',
-        link: '/docs/components/shadcn/button',
-      },
-      {
-        id: 'releases',
-        type: 'basic',
-        title: 'Releases',
-        subtitle: 'Track published changes, migration notes, and newly added primitives.',
-        link: '/docs/changelog',
-      },
-    ],
-  },
-  { id: 'pricing', type: 'basic', title: 'Pricing', link: '/pricing' },
-];
-```
-
-### Direct link items
-
-Use `basic` items when the top-level item should navigate immediately instead of opening a panel.
-
-```ts
-const linkItems: NavigationItem[] = [
-  { id: 'documentation', type: 'basic', title: 'Documentation', link: '/docs/introduction' },
-  { id: 'components', type: 'basic', title: 'Components', link: '/ui/shadcn/button' },
-  {
-    id: 'github',
-    type: 'basic',
-    title: 'GitHub',
-    link: 'https://github.com/shadcn-ui/ui',
-    externalLink: true,
-    target: '_blank',
-  },
-];
-```
-
-### Shared shell state
-
-When the shell already uses the navigation registry, let the topbar resolve items from `NavigationService` by `navigationId` instead of passing `items` everywhere.
-
-```html
-<topbar navigationId="main" ariaLabel="Primary"></topbar>
-```
-
-## API reference
-
-### `TopbarComponent`
-
-| Input            | Type               | Default             |
-| ---------------- | ------------------ | ------------------- |
-| `items`          | `NavigationItem[]` | `[]`                |
-| `navigationId`   | `string`           | `'main'`            |
-| `variant`        | `TopbarVariant`    | `'default'`         |
-| `ariaLabel`      | `string`           | `'Primary'`         |
-| `class`          | `string`           | `''`                |
-| `autoRegister`   | `boolean`          | `true`              |
-| `showHamburger`  | `boolean`          | `true`              |
-| `hamburgerLabel` | `string`           | `'Open navigation'` |
-
-### Supporting types
-
-- `NavigationItem` is the typed data model for `basic`, `group`, `collapsable`, and related navigation branches.
-- `TopbarVariant` is currently `'default' | 'flyout'`.
-- Lower-level item rendering and shell coordination live in `@ojiepermana/angular/navigation/item` and `@ojiepermana/angular/navigation/service`.
-- In `flyout` mode, `basic` child item `subtitle` values render as supporting description copy inside dropdown cards.
-
-## Styling and theming
-
-The component is sticky by default and uses the shared theme tokens for foreground, accent, focus ring, and dropdown chrome.
-
-- Pass `class` to `topbar` when the shell needs custom border, background, width, or spacing utilities.
-- Style projected `[topbar-start]` and `[topbar-end]` content directly on the projected hosts.
-- For documentation or embedded previews, override the sticky positioning locally with `style="position: static; top: auto;"`.
-- The dropdown panel now uses `border-border` and background theme tokens, with a wider card grid when `variant="flyout"`.
-
-## Accessibility
-
-- The host exposes `role="navigation"`; set `ariaLabel` when multiple navigation landmarks exist on the page.
-- The item list uses `role="menubar"`, and top-level interactive items expose `role="menuitem"`.
-- Direct destinations should stay `basic` items so Angular renders anchors with native link semantics.
-- Keep projected CTA elements keyboard reachable and visually distinct from navigation triggers.
-
-## Keyboard interactions
-
-- Left and Right Arrow move focus across the top-level items.
-- Home and End jump to the first and last top-level item.
-- Down Arrow moves focus into an already-open dropdown panel.
-- Escape closes the active dropdown and returns focus to the trigger.
-
-## Angular notes
-
-- Use `NavigationItem` data or projected slot content to compose shell-level navigation.
-- `autoRegister` keeps `NavigationService` in sync with explicit `items`, so active-trail logic still works when the shell uses the shared registry.
-- Prefer `variant="flyout"` plus `subtitle` on child `basic` items when the goal is descriptive dropdown-card content.
-- Prefer `@ojiepermana/angular/component/navigation-menu` when the page needs explicit trigger/content composition rather than a shell-driven data model.
-
-## Source parity
-
-This entrypoint covers the Angular shell-navigation behavior that matters most for top-level application chrome: a horizontal menubar, grouped dropdown triggers, descriptive dropdown cards in `flyout` mode, direct link items, projected brand and action slots, and shared shell integration. Use the dedicated navigation-menu component entrypoint when the goal is a closer shadcn-style website navigation composition.

package/navigation/topbar/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../fesm2022/ojiepermana-angular-navigation-topbar.mjs",
-  "typings": "../../types/ojiepermana-angular-navigation-topbar.d.ts"
-}

package/navigation/types/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../fesm2022/ojiepermana-angular-navigation-types.mjs",
-  "typings": "../../types/ojiepermana-angular-navigation-types.d.ts"
-}

package/theme/README.md

@@ -1,174 +0,0 @@
-# Theme
-
-Shared runtime theme engine and CSS asset surface for `@ojiepermana/angular`.
-
-This secondary entrypoint provides:
-
-- `@ojiepermana/angular/theme` for `provideMaterialTheme`, `withMaterialDefaults`, `ThemeService`, and theme token types.
-- `@ojiepermana/angular/theme/services` for `ThemeService`.
-- `@ojiepermana/angular/theme/provider` for `provideMaterialTheme` and `withMaterialDefaults`.
-- `@ojiepermana/angular/theme/token` for config types, guards, constants, and `MATERIAL_THEME_CONFIG`.
-- `@ojiepermana/angular/theme/styles` for the root stylesheet that composes the active mode, color, and style layers.
-- `@ojiepermana/angular/theme/tailwind/theme.css` for the Tailwind v4 token bridge.
-
-## Consumer usage
-
-```ts
-import { provideMaterialTheme, withMaterialDefaults } from '@ojiepermana/angular/theme';
-
-export const appConfig = {
-  providers: [
-    provideMaterialTheme(
-      {
-        mode: 'system',
-        color: 'base',
-        style: 'default',
-      },
-      withMaterialDefaults(),
-    ),
-  ],
-};
-```
-
-```css
-@import '@ojiepermana/angular/theme/styles';
-@import 'tailwindcss';
-@import '@ojiepermana/angular/theme/tailwind/theme.css';
-```
-
-The public import contract stays stable even if the source files inside this
-entrypoint move.
-
-## Typography mapping
-
-shadcn `Typography` maps to semantic HTML plus this theme entrypoint. There is
-no `@ojiepermana/angular/component/typography` secondary entrypoint.
-
-### Import
-
-```css
-@import '@ojiepermana/angular/theme/styles';
-@import 'tailwindcss';
-@import '@ojiepermana/angular/theme/tailwind/theme.css';
-```
-
-### Composition
-
-```text
-article
-├── h1
-├── p.lead
-├── h2 / h3 / h4
-├── p + a
-├── blockquote
-├── ul / ol
-├── code
-└── table
-```
-
-### Basic usage
-
-```html
-<article class="max-w-2xl text-foreground">
-  <h1 class="scroll-m-20 text-4xl font-extrabold tracking-tight text-balance">
-    Taxing Laughter: The Joke Tax Chronicles
-  </h1>
-
-  <p class="text-xl leading-7 text-muted-foreground [&:not(:first-child)]:mt-6">
-    Once upon a time, in a far-off land, there was a very lazy king who spent all day lounging on his throne.
-  </p>
-
-  <h2 class="mt-10 scroll-m-20 border-b border-border pb-2 text-3xl font-semibold tracking-tight first:mt-0">
-    The King's Plan
-  </h2>
-
-  <p class="leading-7 [&:not(:first-child)]:mt-6">
-    The king thought long and hard and came up with
-    <a href="#" class="font-medium text-primary underline underline-offset-4">a brilliant plan</a>.
-  </p>
-
-  <blockquote class="mt-6 border-s-2 border-border ps-6 italic">
-    "After all," he said, "everyone enjoys a good joke."
-  </blockquote>
-</article>
-```
-
-### Common patterns
-
-- Use `text-xl leading-7 text-muted-foreground` for a lead paragraph below the page title.
-- Use `relative rounded bg-muted px-[0.3rem] py-[0.2rem] font-mono text-sm font-semibold` for short inline code.
-- Use `border-border`, `text-start`, and real `scope="col"` headers on data tables.
-- Use logical spacing utilities such as `border-s-2`, `ps-6`, and `ms-6` so the same recipe works in RTL.
-
-### API reference
-
-| Concept      | Local surface                                     | Notes                                                                                        |
-| ------------ | ------------------------------------------------- | -------------------------------------------------------------------------------------------- |
-| Theme styles | `@ojiepermana/angular/theme` and CSS imports      | Provides the token-backed styles and Tailwind bridge.                                        |
-| Headings     | Native `h1`-`h4` elements                         | Keep the heading hierarchy semantic and style each usage site directly.                      |
-| Body copy    | Native `p`, `blockquote`, `ul`, `ol`, and `table` | Typography stays documentation-first and does not wrap content in custom Angular components. |
-| Inline code  | Native `code`                                     | Use a muted surface and mono text for short snippets.                                        |
-| RTL          | `dir="rtl"` on a wrapping container               | Prefer logical spacing utilities when the layout should mirror.                              |
-
-### Styling and theming
-
-Use token-aware utilities such as `border-border`, `bg-muted`,
-`text-foreground`, `text-muted-foreground`, and `text-primary`. Keep the
-typography classes close to the article or page slice that owns the prose
-instead of centralizing them in a rigid wrapper component.
-
-### Accessibility
-
-- Keep heading levels sequential within an article or documentation page.
-- Preserve native list, table, blockquote, and anchor semantics.
-- Add `scope="col"` to table headers when the table communicates real data.
-- Maintain visible link affordances with contrast and underline offset.
-
-### Keyboard interactions
-
-- Typography relies on native browser behavior for links, selection, scrolling,
-  and table navigation.
-- There is no custom roving-focus or composite widget behavior in this mapping.
-
-### Angular notes
-
-- No TypeScript import is required for typography itself; the runtime surface is
-  semantic HTML plus theme CSS.
-- Keep prose data in component fields, markdown content, or a CMS instead of
-  encoding text into a fake typography component API.
-- Use logical spacing utilities when the content may need right-to-left support.
-
-### Source parity
-
-This entrypoint is the durable Angular-first mapping for shadcn `Typography`.
-It follows the same visual recipes while staying honest about the local API:
-there is no dedicated typography secondary entrypoint, and the authoritative
-consumer guidance lives in the theme entrypoint plus the `ui/shadcn/typography`
-demo page.
-
-## Source layout
-
-- `public-api.ts` aggregates the granular runtime entrypoints for `@ojiepermana/angular/theme`.
-- `services` owns `ThemeService` plus its runtime tests.
-- `provider` owns DI provider helpers plus provider-focused tests.
-- `token` owns config types, guards, constants, and token-focused tests.
-- `css/foundation` contains the cascade layer registration, shared semantic tokens, and component-facing global helpers.
-- `css/variants/mode` contains light and dark mode layers.
-- `css/variants/color` contains named color themes.
-- `css/variants/style` contains style personality layers such as `default`, `sharp`, `brutal`, and `soft`.
-- `css/integrations/material.css` maps theme tokens into Angular Material and MDC tokens.
-- `css/integrations/tailwind.css` maps theme tokens into Tailwind v4 theme tokens.
-
-## Local development
-
-From the workspace root:
-
-```bash
-bun run test:theme
-bun run build
-```
-
-`bun run test:theme` runs the isolated theme specs.
-
-`bun run build` validates that the full library still packages the theme
-entrypoint and exports the CSS assets correctly.

package/theme/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../fesm2022/ojiepermana-angular-theme.mjs",
-  "typings": "../types/ojiepermana-angular-theme.d.ts"
-}

package/theme/provider/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../fesm2022/ojiepermana-angular-theme-provider.mjs",
-  "typings": "../../types/ojiepermana-angular-theme-provider.d.ts"
-}

package/theme/services/package.json

@@ -1,4 +0,0 @@
-{
-  "module": "../../fesm2022/ojiepermana-angular-theme-services.mjs",
-  "typings": "../../types/ojiepermana-angular-theme-services.d.ts"
-}

package/theme/styles/foundation/components.css

@@ -1,81 +0,0 @@
-/**
- * Global component-facing styles that should react to the active theme.
- */
-@layer base {
-  html,
-  body {
-    min-height: 100%;
-  }
-
-  html {
-    background: hsl(var(--background));
-  }
-
-  body {
-    background: hsl(var(--background));
-    color: hsl(var(--foreground));
-    font-family: var(--font-sans);
-    font-size: var(--text-base);
-    line-height: var(--text-base--line-height);
-    letter-spacing: var(--letter-spacing);
-    transition:
-      background-color 0.2s ease,
-      color 0.2s ease,
-      border-color 0.2s ease,
-      box-shadow 0.2s ease;
-  }
-
-  button,
-  input,
-  select,
-  textarea {
-    font: inherit;
-  }
-
-  ::selection {
-    background: hsl(var(--primary) / 0.24);
-    color: hsl(var(--foreground));
-  }
-}
-
-@layer components {
-  .ui-nav-text {
-    font-family: var(--nav-font-family, var(--font-sans));
-    font-size: var(--nav-text-size, var(--text-base));
-    line-height: var(--nav-text-line-height, var(--text-base--line-height));
-  }
-
-  .ui-nav-hover-surface {
-    @apply relative isolate hover:text-accent-foreground;
-  }
-
-  .ui-nav-hover-surface::before {
-    content: '';
-    border-radius: inherit;
-    @apply pointer-events-none absolute inset-y-0 left-2 right-2 z-0 bg-transparent transition-colors;
-  }
-
-  .ui-nav-hover-surface:hover::before {
-    @apply bg-accent;
-  }
-
-  .ui-nav-hover-surface > * {
-    @apply relative z-10;
-  }
-
-  .ui-nav-heading {
-    font-family: var(--nav-heading-font-family, var(--nav-font-family, var(--font-sans)));
-    font-size: var(--nav-heading-size, var(--text-sm));
-    line-height: var(--nav-heading-line-height, var(--text-sm--line-height));
-    font-weight: var(--nav-heading-weight, 600);
-    letter-spacing: var(--nav-heading-letter-spacing, 0.12em);
-    text-transform: uppercase;
-  }
-
-  .ui-nav-badge {
-    font-family: var(--nav-badge-font-family, var(--nav-font-family, var(--font-sans)));
-    font-size: var(--nav-badge-size, var(--text-sm));
-    line-height: var(--nav-badge-line-height, var(--text-sm--line-height));
-    font-weight: var(--nav-badge-weight, 500);
-  }
-}