pi-apexlang 0.1.0

package/skills/apexlang/templates/region-components/calendar/calendar.report-synchronized.md

@@ -0,0 +1,131 @@
+---
+templateId: region.calendar.report-synchronized
+componentType: region
+version: 1.0
+imports:
+  - calendar._common.md
+description: Calendar synchronized with companion report via dynamic actions.
+---
+
+# Purpose
+
+Document calendars paired with reports that share filters and refresh behavior.
+Keep the synchronized refresh behavior aligned with the shared calendar and
+report patterns documented in this template space.
+
+---
+
+# Applicability
+
+- Calendar region plus companion classic report filtered by calendar view.
+- Dynamic actions capture view change events to update report bind items.
+- Hidden items store calendar start/end to drive report query.
+
+---
+
+# Output Template – Calendar Block
+
+```apexlang
+region {{calendarRegionId}} (
+  name: {{calendarName}}
+  type: calendar
+
+  source {
+    location: localDatabase
+    type: sqlQuery
+    sqlQuery:
+      ```sql
+      select
+         id,
+         project,
+         task_name,
+         status,
+         assigned_to,
+         cost,
+         start_date,
+         end_date,
+         case status
+              when 'Open'    then 'apex-cal-green'
+              when 'Pending' then 'apex-cal-yellow'
+              when 'Closed'  then 'apex-cal-red'
+              when 'On-Hold' then 'apex-cal-black'
+         end as css_class
+      from eba_demo_cal_projects
+      where (nvl(:{{filterItem}}, '0') = '0' or project = :{{filterItem}})
+      order by end_date
+      ```
+    pageItemsToSubmit: {{pageItemsToSubmit}}
+  }
+
+  layout {
+    sequence: {{layout.sequence}}
+    slot: {{layout.slot}}
+  }
+
+  appearance {
+    template: @/standard
+    templateOptions: [
+      #DEFAULT#
+      t-Region--hideHeader js-addHiddenHeadingRoleDesc
+      t-Region--scrollBody
+    ]
+  }
+
+  advanced {
+    htmlDomId: {{htmlDomId}}
+  }
+
+  settings {
+    displayColumn: TASK_NAME
+    startDateColumn: START_DATE
+    endDateColumn: END_DATE
+    pkColumn: ID
+    additionalCalendarViews: navigation
+    viewEditLink: {
+      page: 3
+      items: {
+        P3_ID: &ID.
+        P3_LASTVIEW: &APP_PAGE_ID.
+      }
+    }
+    maxEventsDay: 5
+    cssClass: CSS_CLASS
+  }
+
+  performance {
+    lazyLoading: true
+  }
+)
+```
+
+---
+
+# Companion Report Notes
+
+- Classic report uses identical SQL and shares `cssClass` to render inline badges.
+- Hidden items (`Pxx_CAL_START_DATE`, `Pxx_CAL_END_DATE`) store the calendar view
+  window.
+
+---
+
+# Dynamic Action Pattern
+
+Event: `region/calendar/apexcalendarviewchange` on the calendar.
+
+Actions:
+1. `setValue` → assign `this.data.startDate` to hidden start item.
+2. `setValue` → assign `this.data.endDate` to hidden end item.
+3. `refresh` → refresh companion report region.
+
+Optional page load DA seeds hidden items using `apex.region("{{htmlDomId}}")` and
+refreshes the report to sync initial state.
+
+---
+
+# Guardrails
+
+- Ensure both calendar and report share the same filter items and SQL ordering.
+- Hidden items must be `valueProtected: false` when manipulated via dynamic
+  actions.
+- Document the `formatYYYYMMDDhhmmss` helper used to populate hidden items on
+  page load.

package/skills/apexlang/templates/region-components/calendar/calendar.schedule-builder.md

@@ -0,0 +1,149 @@
+---
+templateId: region.calendar.schedule-builder
+componentType: region
+version: 1.0
+imports:
+  - calendar._common.md
+description: Dual calendar schedule builder with client-side coordination.
+---
+
+# Purpose
+
+Document dual-calendar layouts where users copy events between calendars and
+augment schedules with client-side logic.
+
+---
+
+# Applicability
+
+- Two calendar regions (“Sessions” vs. “My Sessions”) sharing similar SQL.
+- Time-grid views with restricted visible hours and custom FullCalendar setup.
+- Requires supporting dynamic actions to copy/delete events via client-side API
+  and persist to the database.
+
+---
+
+# Output Template – Calendar Blocks
+
+```apexlang
+region {{sessionsRegionId}} (
+  name: Sessions
+  type: calendar
+  source { /* session catalog SQL */ }
+  layout {
+    sequence: {{sessionsSequence}}
+    slot: BODY
+    startNewRow: false
+  }
+  appearance {
+    template: @/standard
+    templateOptions: [
+      #DEFAULT#
+      t-Region--noPadding
+      js-showMaximizeButton
+      t-Region--hideHeader js-addHiddenHeadingRoleDesc
+      t-Region--noBorder
+      t-Region--scrollBody
+    ]
+  }
+  advanced {
+    htmlDomId: session_calendar
+    regionDisplaySelector: true
+  }
+  settings {
+    displayColumn: TITLE
+    startDateColumn: START_DATE
+    endDateColumn: END_DATE
+    pkColumn: ID
+    timeFormat: 24Hour
+    firstHour: 7
+    additionalCalendarViews: navigation
+    showWeekend: false
+    cssClass: CSS_CLASS
+  }
+  componentAdvanced {
+    initJavaScriptFunction:
+      ```javascript-browser
+      function (pOptions) {
+        pOptions.titleFormat     = function () { return "Conference Sessions"; };
+        pOptions.slotMinTime     = "08:00:00";
+        pOptions.slotMaxTime     = "18:00:00";
+        pOptions.dayHeaderFormat = { weekday: 'short', month: 'numeric', day: 'numeric' };
+        pOptions.slotDuration    = "00:15:00";
+        return pOptions;
+      }
+      ```
+  }
+)
+
+region {{mySessionsRegionId}} (
+  name: My Sessions
+  type: calendar
+  source { /* user-specific schedule SQL */ }
+  layout {
+    sequence: {{mySessionsSequence}}
+    slot: BODY
+  }
+  appearance {
+    template: @/standard
+    templateOptions: [
+      #DEFAULT#
+      t-Region--noPadding
+      js-showMaximizeButton
+      t-Region--hideHeader js-addHiddenHeadingRoleDesc
+      t-Region--noBorder
+      t-Region--scrollBody
+    ]
+  }
+  advanced {
+    htmlDomId: my_session_calendar
+    regionDisplaySelector: true
+  }
+  settings {
+    displayColumn: TITLE
+    startDateColumn: START_DATE
+    endDateColumn: END_DATE
+    pkColumn: ID
+    timeFormat: 24Hour
+    firstHour: 7
+    supplementalInfo: &ABSTRACT.
+    additionalCalendarViews: list
+    showWeekend: false
+    cssClass: CSS_CLASS
+  }
+  componentAdvanced {
+    initJavaScriptFunction:
+      ```javascript-browser
+      function (pOptions) {
+        pOptions.titleFormat     = function () { return "My Schedule"; };
+        pOptions.slotMinTime     = "08:00:00";
+        pOptions.slotMaxTime     = "18:00:00";
+        pOptions.dayHeaderFormat = { weekday: 'short', month: 'numeric', day: 'numeric' };
+        pOptions.slotDuration    = "00:15:00";
+        return pOptions;
+      }
+      ```
+  }
+)
+```
+
+---
+
+# Supporting Patterns
+
+- JavaScript helpers (page-level) format timestamps (`formatYYYYMMDDhhmmss`).
+- Dynamic actions handle button clicks to copy/delete events via FullCalendar
+  API (`calendar.addEvent`, `event.remove`).
+- Server-side processes persist changes (insert/delete) using selected event
+  metadata.
+
+---
+
+# Guardrails
+
+- Keep UT template options consistent (`js-showMaximizeButton` only when UX
+  requires). Remove custom classes unless documented.
+- Ensure both calendars share consistent slot duration and visible hours to
+  avoid misaligned drag/drop behavior.
+- Persist copied events immediately or provide explicit “Save” actions;
+  document the chosen approach.

package/skills/apexlang/templates/region-components/calendar/calendar.standard-monthly.md

@@ -0,0 +1,129 @@
+---
+templateId: region.calendar.standard-monthly
+componentType: region
+version: 1.0
+imports:
+  - calendar._common.md
+description: Standard monthly calendar with project filter.
+---
+
+# Purpose
+
+Pattern for monthly calendars backed by SQL with optional project filtering.
+Use this scenario as the canonical monthly calendar variant in this folder.
+
+---
+
+# Applicability
+
+- Calendar region with month/week/day/list navigation.
+- Filtered by select list (or similar) submitted as bind variable.
+- Requires color-coding via `cssClass` and lazy loading.
+
+---
+
+# Output Template – Full
+
+```apexlang
+region {{regionStaticId}} (
+  name: {{name}}
+  type: calendar
+
+  source {
+    location: localDatabase
+    type: sqlQuery
+    sqlQuery:
+      ```sql
+      select
+         id,
+         project,
+         task_name,
+         status,
+         assigned_to,
+         cost,
+         start_date,
+         end_date,
+         case
+            when status = 'Pending' then 'apex-cal-blue'
+            when status = 'Open'    then 'apex-cal-green'
+            when status = 'Closed'  then 'apex-cal-gray'
+            when status = 'On-Hold' then 'apex-cal-orange'
+         end as css_class
+      from eba_demo_cal_projects
+      where (nvl(:{{filterItem}}, '0') = '0' or project = :{{filterItem}})
+      order by end_date
+      ```
+    pageItemsToSubmit: {{pageItemsToSubmit}}
+  }
+
+  layout {
+    sequence: {{layout.sequence}}
+    slot: {{layout.slot}}
+  }
+
+  appearance {
+    template: @/standard
+    templateOptions: [
+      #DEFAULT#
+      t-Region--noPadding
+      t-Region--hideHeader js-addHiddenHeadingRoleDesc
+      t-Region--hiddenOverflow
+    ]
+  }
+
+  advanced {
+    htmlDomId: {{htmlDomId}}
+  }
+
+  settings {
+    displayColumn: TASK_NAME
+    startDateColumn: START_DATE
+    endDateColumn: END_DATE
+    pkColumn: ID
+    additionalCalendarViews: [
+      list
+      navigation
+    ]
+    viewEditLink: {
+      page: 3
+      items: {
+        P3_ID: &ID.
+        P3_LASTVIEW: &APP_PAGE_ID.
+      }
+    }
+    maxEventsDay: 3
+    cssClass: CSS_CLASS
+  }
+
+  performance {
+    lazyLoading: true
+  }
+
+  componentAdvanced {
+    initJavaScriptFunction:
+      ```javascript-browser
+      function (pOptions) {
+        pOptions.endDateExclusive = false;
+      }
+      ```
+  }
+)
+```
+
+---
+
+# Required Variables
+
+- `filterItem`: Page item used to filter (e.g., `P31_PROJECTS`).
+- `pageItemsToSubmit`: Array-style string (e.g., `[P31_PROJECTS]`).
+- `layout.sequence`, `layout.slot`, `htmlDomId` per page layout.
+
+---
+
+# Guardrails
+
+- Ensure the filter item defaults to `'0'` (all projects) or adjust the SQL
+  predicate accordingly.
+- Maintain the `order by end_date` for predictable rendering.
+- When removing lazy loading, document performance justification.
+- Keep `cssClass` values aligned with UT-supported calendar classes (`apex-cal-*`).

package/skills/apexlang/templates/region-components/calendar/calendar.status-tracking.md

@@ -0,0 +1,129 @@
+---
+templateId: region.calendar.status-tracking
+componentType: region
+version: 1.0
+imports:
+  - calendar._common.md
+description: Calendar exposing view metadata via FullCalendar events.
+---
+
+# Purpose
+
+Pattern for calendars that surface the current view, start, and end dates via
+dynamic actions responding to FullCalendar view-change events.
+
+---
+
+# Applicability
+
+- Calendar must publish active view metadata to page items.
+- Consumers (reports, text fields) display or act on the captured values.
+- Requires JavaScript event handling (`region/calendar/apexcalendarviewchange`).
+
+---
+
+# Output Template – Calendar Block
+
+```apexlang
+region {{regionStaticId}} (
+  name: {{name}}
+  type: calendar
+
+  source {
+    location: localDatabase
+    type: sqlQuery
+    sqlQuery:
+      ```sql
+      select
+         id,
+         project,
+         task_name,
+         status,
+         assigned_to,
+         cost,
+         start_date,
+         end_date,
+         case
+            when status = 'Pending' then 'apex-cal-blue'
+            when status = 'Open'    then 'apex-cal-green'
+            when status = 'Closed'  then 'apex-cal-gray'
+            when status = 'On-Hold' then 'apex-cal-orange'
+         end as css_class
+      from eba_demo_cal_projects
+      ```
+  }
+
+  layout {
+    sequence: {{layout.sequence}}
+    slot: {{layout.slot}}
+  }
+
+  appearance {
+    template: @/standard
+    templateOptions: [
+      #DEFAULT#
+      t-Region--noPadding
+      t-Region--hideHeader js-addHiddenHeadingRoleDesc
+      t-Region--hiddenOverflow
+    ]
+  }
+
+  advanced {
+    htmlDomId: {{htmlDomId}}
+  }
+
+  settings {
+    displayColumn: TASK_NAME
+    startDateColumn: START_DATE
+    endDateColumn: END_DATE
+    pkColumn: ID
+    additionalCalendarViews: [
+      list
+      navigation
+    ]
+    viewEditLink: {
+      page: 3
+      items: {
+        P3_ID: &ID.
+        P3_LASTVIEW: &APP_PAGE_ID.
+      }
+    }
+    maxEventsDay: 5
+    cssClass: CSS_CLASS
+  }
+
+  performance {
+    lazyLoading: true
+  }
+)
+```
+
+---
+
+# Dynamic Action Pattern
+
+Event: `region/calendar/apexcalendarviewchange` targeting the calendar region.
+
+Actions (in order):
+
+1. `setValue` → assign `this.data.viewType` to a text item (e.g., `P72_VIEW_TYPE`).
+2. `setValue` → assign `formatYYYYMMDDhhmmss(this.data.startDate)` to the
+   “from” item.
+3. `setValue` → assign `formatYYYYMMDDhhmmss(this.data.endDate)` to the “to”
+   item.
+4. Optional `refresh` → trigger dependent regions (reports/graphs) that rely on
+   the captured values.
+
+Provide a helper function (`formatYYYYMMDDhhmmss`) in page-level JavaScript when
+format transformations are needed.
+
+---
+
+# Guardrails
+
+- Ensure target items (`Pxx_VIEW_TYPE`, `Pxx_START_DATE`, `Pxx_END_DATE`) are
+  configured with appropriate templates (`@/optional`) and format masks.
+- For downstream SQL using these items, set `itemsToSubmit` or add region-level
+  page-item dependencies so refreshed components receive current session state.
+- Document any additional view metrics captured from `this.data` (e.g.,
+  `activeStart`, `currentEnd`) to keep code maintainable.

package/skills/apexlang/templates/region-components/calendar/calendar.weekly-conference.md

@@ -0,0 +1,109 @@
+---
+templateId: region.calendar.weekly-conference
+componentType: region
+version: 1.0
+imports:
+  - calendar._common.md
+description: Weekly conference calendar with color-coded sessions.
+---
+
+# Purpose
+
+Reference pattern for conference-style weekly calendars rendering timed sessions
+with color-coded tracks using the shared calendar contract in this folder.
+
+---
+
+# Applicability
+
+- Week/day/list navigation with time slots.
+- No per-user filtering; show all active sessions.
+- Highlights `cssClass` usage for UT calendar color classes.
+
+---
+
+# Output Template – Full
+
+```apexlang
+region {{regionStaticId}} (
+  name: {{name}}
+  type: calendar
+
+  source {
+    location: localDatabase
+    type: sqlQuery
+    sqlQuery:
+      ```sql
+      select
+         id,
+         case when speaker is not null then
+           title || ' (' || speaker || ')'
+           else title
+         end as title,
+         speaker,
+         start_date,
+         end_date,
+         case
+            when status = 'INACTIVE'    then 'apex-cal-gray'
+            when session_type = 'BREAK' then 'apex-cal-silver'
+            when session_type = 'BUSINESS' then 'apex-cal-orange'
+            when session_type = 'GENERAL'  then 'apex-cal-blue'
+            when session_type = 'TECHNICAL' then 'apex-cal-green'
+            when session_type = 'HANDS_ON'  then 'apex-cal-lime'
+         end as css_class
+      from eba_demo_cal_sessions
+      where status = 'ACTIVE'
+      ```
+  }
+
+  layout {
+    sequence: {{layout.sequence}}
+    slot: {{layout.slot}}
+  }
+
+  appearance {
+    template: @/standard
+    templateOptions: [
+      #DEFAULT#
+      t-Region--noPadding
+      t-Region--hideHeader js-addHiddenHeadingRoleDesc
+      t-Region--hiddenOverflow
+    ]
+  }
+
+  advanced {
+    htmlDomId: {{htmlDomId}}
+  }
+
+  settings {
+    displayColumn: TITLE
+    startDateColumn: START_DATE
+    endDateColumn: END_DATE
+    pkColumn: ID
+    additionalCalendarViews: [
+      list
+      navigation
+    ]
+    cssClass: CSS_CLASS
+  }
+
+  performance {
+    lazyLoading: true
+  }
+)
+```
+
+---
+
+# Required Variables
+
+- `layout.sequence` / `layout.slot` / `htmlDomId` to match page layout.
+
+---
+
+# Guardrails
+
+- Keep `where status = 'ACTIVE'` (or equivalent) consistent with business rules;
+  expose toggles via `pageItemsToSubmit` when users can show inactive sessions.
+- Retain UT-approved calendar classes (begin with `apex-cal-`).
+- Extend `additionalCalendarViews` only with documented values.