added javadoc

Author: Michael Ryan Hunsaker

.devcontainer/devcontainer.json

@@ -0,0 +1,29 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/java
+{
+	"name": "Java",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"image": "mcr.microsoft.com/devcontainers/java:1-21-bullseye",
+
+	"features": {
+		"ghcr.io/devcontainers/features/java:1": {
+			"version": "none",
+			"installMaven": "true",
+			"installGradle": "true"
+		},
+		"ghcr.io/devcontainers/features/powershell:1": {},
+		"ghcr.io/devcontainers/features/python:1": {}
+	}
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Use 'postCreateCommand' to run commands after the container is created.
+	// "postCreateCommand": "java -version",
+
+	// Configure tool-specific properties.
+	// "customizations": {},
+
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}

.github/dependabot.yml

@@ -0,0 +1,12 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for more information:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+# https://containers.dev/guide/dependabot
+
+version: 2
+updates:
+ - package-ecosystem: "devcontainers"
+   directory: "/"
+   schedule:
+     interval: weekly

src/main/java/com/studentgui/app/Main.java

@@ -3,6 +3,7 @@
 import java.awt.BorderLayout;
 import java.awt.CardLayout;
 import java.awt.FlowLayout;
+import java.awt.Font;
 import java.time.LocalDate;
 import java.time.format.DateTimeParseException;
 import java.util.List;
@@ -432,12 +433,15 @@ private static JPanel buildTopBar() {
         JComboBox<String> studentBox = new JComboBox<>(students.toArray(new String[0]));
         studentBox.setEditable(false);
 
+        JLabel studentLabel = new JLabel("Student:");
+        studentLabel.setFont(new Font(Font.SANS_SERIF, Font.PLAIN, 24));
         JLabel dateLabel = new JLabel("Date (YYYY-MM-DD):");
+        dateLabel.setFont(new Font(Font.SANS_SERIF, Font.PLAIN, 24));
         JTextField dateField = new JTextField(LocalDate.now().toString(), 10);
 
         JButton goBtn = new JButton("Apply");
 
-        bar.add(new JLabel("Student:"));
+        bar.add(studentLabel);
         bar.add(studentBox);
         bar.add(dateLabel);
         bar.add(dateField);

src/main/java/com/studentgui/app/PreferencesDialog.java

@@ -2,6 +2,7 @@
 
 import java.awt.BorderLayout;
 import java.awt.FlowLayout;
+import java.awt.Font;
 import java.awt.Frame;
 
 import javax.swing.JButton;
@@ -47,7 +48,9 @@ public static void showDialog(final Frame owner) {
         center.add(jitterCb);
         center.add(detCb);
     center.add(dumpsCb);
-        center.add(new JLabel("Seed:"));
+        JLabel seedLabel = new JLabel("Seed:");
+        seedLabel.setFont(new Font(Font.SANS_SERIF, Font.PLAIN, 24));
+        center.add(seedLabel);
         center.add(seedField);
 
         JPanel south = new JPanel(new FlowLayout(FlowLayout.RIGHT));

src/main/java/com/studentgui/apppages/Abacus.java

@@ -127,7 +127,7 @@ public Abacus(final String studentName, final LocalDate date, final JLineGraph l
         gbc.weighty = 0.0;
 
     this.titleLabel = new JLabel(baseTitle);
-    this.titleLabel.setFont(this.titleLabel.getFont().deriveFont(Font.BOLD, 16));
+    this.titleLabel.setFont(this.titleLabel.getFont().deriveFont(Font.BOLD, 28f));
         gbc.gridx = 0;
         gbc.gridy = 0;
         gbc.gridwidth = GridBagConstraints.REMAINDER;
@@ -141,7 +141,7 @@ public Abacus(final String studentName, final LocalDate date, final JLineGraph l
     // visual spacing controlled by PhaseScoreField and layout
 
     String[] labels = java.util.Arrays.stream(this.parts).map(x->x[1]).toArray(String[]::new);
-        int maxPx = com.studentgui.uicomp.PhaseScoreField.computeMaxLabelPixelWidth(titleLabel.getFont(), labels);
+        int maxPx = com.studentgui.uicomp.PhaseScoreField.computeMaxLabelPixelWidth(com.studentgui.uicomp.PhaseScoreField.getLabelFont(), labels);
         com.studentgui.uicomp.PhaseScoreField.setGlobalLabelWidth(Math.min(320, Math.max(140, maxPx + 50)));
     skillFields = new com.studentgui.uicomp.PhaseScoreField[this.parts.length];
     for (int i = 0; i < this.parts.length; i++) {

src/main/java/com/studentgui/apppages/Braille.java

@@ -140,7 +140,7 @@ public Braille(final String studentName, final LocalDate date, final JLineGraph
         gbc.weighty = 0.0;
 
     this.titleLabel = new JLabel(baseTitle);
-        this.titleLabel.setFont(this.titleLabel.getFont().deriveFont(Font.BOLD, 16));
+    this.titleLabel.setFont(this.titleLabel.getFont().deriveFont(Font.BOLD, 28f));
         gbc.gridx = 0;
         gbc.gridy = 0;
         gbc.gridwidth = GridBagConstraints.REMAINDER;
@@ -153,7 +153,7 @@ public Braille(final String studentName, final LocalDate date, final JLineGraph
 
     // compute longest label width to align inputs
         String[] labels = java.util.Arrays.stream(parts).map(x->x[1]).toArray(String[]::new);
-            int maxPx = com.studentgui.uicomp.PhaseScoreField.computeMaxLabelPixelWidth(titleLabel.getFont(), labels);
+            int maxPx = com.studentgui.uicomp.PhaseScoreField.computeMaxLabelPixelWidth(com.studentgui.uicomp.PhaseScoreField.getLabelFont(), labels);
             com.studentgui.uicomp.PhaseScoreField.setGlobalLabelWidth(Math.min(320, Math.max(140, maxPx + 50)));
     skillFields = new com.studentgui.uicomp.PhaseScoreField[this.parts.length];
         for (int i = 0; i < this.parts.length; i++) {

src/main/java/com/studentgui/apppages/BrailleNote.java

@@ -150,7 +150,7 @@ public BrailleNote(String studentName, LocalDate date, JLineGraph lineGraph) {
         gbc.weighty = 0.0;
 
     this.titleLabel = new JLabel(baseTitle);
-        this.titleLabel.setFont(this.titleLabel.getFont().deriveFont(Font.BOLD, 16));
+    this.titleLabel.setFont(this.titleLabel.getFont().deriveFont(Font.BOLD, 28f));
         gbc.gridx = 0;
         gbc.gridy = 0;
         gbc.gridwidth = GridBagConstraints.REMAINDER;
@@ -165,7 +165,7 @@ public BrailleNote(String studentName, LocalDate date, JLineGraph lineGraph) {
 
     // compute pixel width using font metrics so labels align precisely
     String[] labelsArr = java.util.Arrays.stream(parts).map(x->x[1]).toArray(String[]::new);
-    int maxPx = com.studentgui.uicomp.PhaseScoreField.computeMaxLabelPixelWidth(titleLabel.getFont(), labelsArr);
+    int maxPx = com.studentgui.uicomp.PhaseScoreField.computeMaxLabelPixelWidth(com.studentgui.uicomp.PhaseScoreField.getLabelFont(), labelsArr);
     com.studentgui.uicomp.PhaseScoreField.setGlobalLabelWidth(Math.min(320, Math.max(140, maxPx + 50)));
     skillFields = new com.studentgui.uicomp.PhaseScoreField[parts.length];
         for (int i = 0; i < parts.length; i++) {

src/main/java/com/studentgui/apppages/BrailleSense.java

@@ -113,7 +113,7 @@ public BrailleSense(String studentName, LocalDate date, JLineGraph graph) {
 
         JLabel titleLabel = new JLabel("BrailleSense Skills");
         // Use an explicit font so theme changes don't alter the title appearance
-        titleLabel.setFont(new Font(Font.SANS_SERIF, Font.BOLD, 16));
+        titleLabel.setFont(new Font(Font.SANS_SERIF, Font.BOLD, 28));
         gbc.gridx = 0;
         gbc.gridy = 0;
         gbc.gridwidth = GridBagConstraints.REMAINDER;
@@ -141,7 +141,7 @@ public BrailleSense(String studentName, LocalDate date, JLineGraph graph) {
 
         // compute pixel width using font metrics so labels align precisely
         String[] labels = java.util.Arrays.stream(this.parts).map(x -> x[1]).toArray(String[]::new);
-        int maxPx = com.studentgui.uicomp.PhaseScoreField.computeMaxLabelPixelWidth(titleLabel.getFont(), labels);
+        int maxPx = com.studentgui.uicomp.PhaseScoreField.computeMaxLabelPixelWidth(com.studentgui.uicomp.PhaseScoreField.getLabelFont(), labels);
         com.studentgui.uicomp.PhaseScoreField.setGlobalLabelWidth(Math.min(360, Math.max(200, maxPx + 50)));
         int row = 1;
         for (String[] def : this.parts) {

src/main/java/com/studentgui/apppages/CVI.java

@@ -106,15 +106,15 @@ public CVI(String studentName, LocalDate date, JLineGraph graph) {
     JScrollPane scroll = new JScrollPane(view);
     GridBagConstraints gbc = new GridBagConstraints(); gbc.insets=new Insets(2,2,2,2); gbc.fill = GridBagConstraints.HORIZONTAL; gbc.anchor = GridBagConstraints.NORTHWEST;
 
-    JLabel title = new JLabel("CVI Progression");
-    title.setFont(title.getFont().deriveFont(Font.BOLD,16));
+        JLabel title = new JLabel("CVI Progression");
+        title.setFont(title.getFont().deriveFont(Font.BOLD,28f));
     title.getAccessibleContext().setAccessibleName("CVI Progression Title");
     title.setHorizontalAlignment(JLabel.LEFT);
     gbc.gridx=0; gbc.gridy=0; gbc.gridwidth=2; panel.add(title, gbc);
 
     String[][] parts = new String[][]{{"P1_1","Color Preference"},{"P1_2","Need for Movement"},{"P1_3","Latency"},{"P1_4","Field Preference"},{"P1_5","Visual Complexity"},{"P1_6","Nonpurposeful Gaze"},{"P2_1","Distance Viewing"},{"P2_2","Atypical Reflexes"},{"P2_3","Visual Novelty"},{"P2_4","Visual Reach"}};
-    String[] labels = java.util.Arrays.stream(parts).map(x->x[1]).toArray(String[]::new);
-            int maxPx = com.studentgui.uicomp.PhaseScoreField.computeMaxLabelPixelWidth(title.getFont(), labels);
+        String[] labels = java.util.Arrays.stream(parts).map(x->x[1]).toArray(String[]::new);
+            int maxPx = com.studentgui.uicomp.PhaseScoreField.computeMaxLabelPixelWidth(com.studentgui.uicomp.PhaseScoreField.getLabelFont(), labels);
             com.studentgui.uicomp.PhaseScoreField.setGlobalLabelWidth(Math.min(320, Math.max(140, maxPx + 50)));
     int row = 1;
     for (String[] pdef: parts) {

src/main/java/com/studentgui/apppages/ContactLog.java

@@ -111,36 +111,36 @@ public ContactLog(String studentName, LocalDate date, JLineGraph graph) {
     JScrollPane scroll = new JScrollPane(view);
     scroll.getAccessibleContext().setAccessibleName("Contact Log data entry scroll pane");
     GridBagConstraints gbc = new GridBagConstraints(); gbc.insets=new Insets(2,2,2,2); gbc.fill = GridBagConstraints.HORIZONTAL; gbc.anchor = GridBagConstraints.NORTHWEST;
-    JLabel title = new JLabel("Contact Log"); title.setFont(title.getFont().deriveFont(Font.BOLD,16)); title.setHorizontalAlignment(JLabel.LEFT); gbc.gridx=0; gbc.gridy=0; gbc.gridwidth=2; p.add(title, gbc);
+    JLabel title = new JLabel("Contact Log"); title.setFont(title.getFont().deriveFont(Font.BOLD,28f)); title.setHorizontalAlignment(JLabel.LEFT); gbc.gridx=0; gbc.gridy=0; gbc.gridwidth=2; p.add(title, gbc);
 
     // Structured contact fields (placed above notes)
     int row = 1;
     gbc.gridwidth = 1;
     int globalLabel = com.studentgui.uicomp.PhaseScoreField.getGlobalLabelWidth();
-    gbc.gridx = 0; gbc.gridy = row; JLabel guardianLabel = new JLabel("Guardian Name:"); guardianLabel.setPreferredSize(new java.awt.Dimension(globalLabel, guardianLabel.getPreferredSize().height)); p.add(guardianLabel, gbc);
+    gbc.gridx = 0; gbc.gridy = row; JLabel guardianLabel = new JLabel("Guardian Name:"); guardianLabel.setFont(new Font(Font.SANS_SERIF, Font.PLAIN, 24)); guardianLabel.setPreferredSize(new java.awt.Dimension(globalLabel, guardianLabel.getPreferredSize().height)); p.add(guardianLabel, gbc);
     guardianField = new JTextField(24); guardianField.setName("contactlog_guardian"); gbc.gridx = 1; p.add(guardianField, gbc);
     row++;
-    gbc.gridx = 0; gbc.gridy = row; JLabel methodLabel = new JLabel("Contact Method:"); methodLabel.setPreferredSize(new java.awt.Dimension(globalLabel, methodLabel.getPreferredSize().height)); p.add(methodLabel, gbc);
+    gbc.gridx = 0; gbc.gridy = row; JLabel methodLabel = new JLabel("Contact Method:"); methodLabel.setFont(new Font(Font.SANS_SERIF, Font.PLAIN, 24)); methodLabel.setPreferredSize(new java.awt.Dimension(globalLabel, methodLabel.getPreferredSize().height)); p.add(methodLabel, gbc);
     contactMethodCombo = new JComboBox<>(new String[]{"Phone","Email","In Person","Other"}); contactMethodCombo.setName("contactlog_method"); gbc.gridx = 1; p.add(contactMethodCombo, gbc);
     row++;
-    gbc.gridx = 0; gbc.gridy = row; JLabel phoneLabel = new JLabel("Phone Number:"); phoneLabel.setPreferredSize(new java.awt.Dimension(globalLabel, phoneLabel.getPreferredSize().height)); p.add(phoneLabel, gbc);
+    gbc.gridx = 0; gbc.gridy = row; JLabel phoneLabel = new JLabel("Phone Number:"); phoneLabel.setFont(new Font(Font.SANS_SERIF, Font.PLAIN, 24)); phoneLabel.setPreferredSize(new java.awt.Dimension(globalLabel, phoneLabel.getPreferredSize().height)); p.add(phoneLabel, gbc);
     phoneField = new JTextField(18); phoneField.setName("contactlog_phone"); gbc.gridx = 1; p.add(phoneField, gbc);
     row++;
-    gbc.gridx = 0; gbc.gridy = row; JLabel emailLabel = new JLabel("Email Address:"); emailLabel.setPreferredSize(new java.awt.Dimension(globalLabel, emailLabel.getPreferredSize().height)); p.add(emailLabel, gbc);
+    gbc.gridx = 0; gbc.gridy = row; JLabel emailLabel = new JLabel("Email Address:"); emailLabel.setFont(new Font(Font.SANS_SERIF, Font.PLAIN, 24)); emailLabel.setPreferredSize(new java.awt.Dimension(globalLabel, emailLabel.getPreferredSize().height)); p.add(emailLabel, gbc);
     emailField = new JTextField(24); emailField.setName("contactlog_email"); gbc.gridx = 1; p.add(emailField, gbc);
     row++;
-    gbc.gridx = 0; gbc.gridy = row; JLabel responseLabel = new JLabel("Contact Response:"); responseLabel.setPreferredSize(new java.awt.Dimension(globalLabel, responseLabel.getPreferredSize().height)); p.add(responseLabel, gbc);
+    gbc.gridx = 0; gbc.gridy = row; JLabel responseLabel = new JLabel("Contact Response:"); responseLabel.setFont(new Font(Font.SANS_SERIF, Font.PLAIN, 24)); responseLabel.setPreferredSize(new java.awt.Dimension(globalLabel, responseLabel.getPreferredSize().height)); p.add(responseLabel, gbc);
     contactResponseField = new JTextField(24); contactResponseField.setName("contactlog_response"); gbc.gridx = 1; p.add(contactResponseField, gbc);
     row++;
-    gbc.gridx = 0; gbc.gridy = row; JLabel generalLabel = new JLabel("Contact General:"); generalLabel.setPreferredSize(new java.awt.Dimension(globalLabel, generalLabel.getPreferredSize().height)); p.add(generalLabel, gbc);
+    gbc.gridx = 0; gbc.gridy = row; JLabel generalLabel = new JLabel("Contact General:"); generalLabel.setFont(new Font(Font.SANS_SERIF, Font.PLAIN, 24)); generalLabel.setPreferredSize(new java.awt.Dimension(globalLabel, generalLabel.getPreferredSize().height)); p.add(generalLabel, gbc);
     contactGeneralField = new JTextField(24); contactGeneralField.setName("contactlog_general"); gbc.gridx = 1; p.add(contactGeneralField, gbc);
     row++;
-    gbc.gridx = 0; gbc.gridy = row; JLabel specificLabel = new JLabel("Contact Specific:"); specificLabel.setPreferredSize(new java.awt.Dimension(globalLabel, specificLabel.getPreferredSize().height)); p.add(specificLabel, gbc);
+    gbc.gridx = 0; gbc.gridy = row; JLabel specificLabel = new JLabel("Contact Specific:"); specificLabel.setFont(new Font(Font.SANS_SERIF, Font.PLAIN, 24)); specificLabel.setPreferredSize(new java.awt.Dimension(globalLabel, specificLabel.getPreferredSize().height)); p.add(specificLabel, gbc);
     contactSpecificField = new JTextField(24); contactSpecificField.setName("contactlog_specific"); gbc.gridx = 1; p.add(contactSpecificField, gbc);
     row++;
 
     // Notes label + text area with accessibility
-    gbc.gridx = 0; gbc.gridy = row; gbc.gridwidth = 2; JLabel notesLabel = new JLabel("Notes:"); notesLabel.setPreferredSize(new java.awt.Dimension(globalLabel, notesLabel.getPreferredSize().height)); p.add(notesLabel, gbc);
+    gbc.gridx = 0; gbc.gridy = row; gbc.gridwidth = 2; JLabel notesLabel = new JLabel("Notes:"); notesLabel.setFont(new Font(Font.SANS_SERIF, Font.PLAIN, 24)); notesLabel.setPreferredSize(new java.awt.Dimension(globalLabel, notesLabel.getPreferredSize().height)); p.add(notesLabel, gbc);
     row++;
 
     gbc.gridx = 0; gbc.gridy = row; gbc.gridwidth = 2; notesArea = new JTextArea(8,40); notesArea.setLineWrap(true); notesArea.setWrapStyleWord(true); notesArea.setToolTipText("Enter contact notes for the student"); notesArea.getAccessibleContext().setAccessibleName("Contact notes"); JScrollPane notesScroll = new JScrollPane(notesArea); notesScroll.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_NEVER); p.add(notesScroll, gbc);